{ "openapi": "3.0.1", "info": { "title": "Indeed Scraper", "version": "0.1", "x-build-id": "y36ZIuFGDdTQF7LWh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapapi~indeed-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapapi-indeed-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapapi~indeed-scraper/runs": { "post": { "operationId": "runs-sync-scrapapi-indeed-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapapi~indeed-scraper/run-sync": { "post": { "operationId": "run-sync-scrapapi-indeed-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "position": { "title": "šŸ” Positions/Keywords for Search", "type": "string", "description": "šŸ’” Any combination of positions or keywords for search.\n\nāœØ Can be used together with Start URLs - both will be scraped independently, each limited by Max job listings per search.\n\nšŸ“ Examples: 'web developer', 'software engineer', 'data scientist'" }, "maxItemsPerSearch": { "title": "šŸ“Š Max Job Listings per Search", "minimum": 1, "type": "integer", "description": "šŸŽÆ Maximum number of job listings to scrape for each keyword search and each Start URL.\n\nšŸ’” When both search and URLs are used together, each is limited independently by this value.\n\nšŸ“ˆ Range: 1-10000\nāš” Default: 100 jobs", "default": 100 }, "country": { "title": "šŸŒ Country for Search", "enum": [ "Antarctica", "Argentina", "Australia", "Austria", "Bahrain", "Belgium", "Brazil", "Canada", "Chile", "China", "Colombia", "Costa Rica", "Czech Republic", "Denmark", "Ecuador", "Egypt", "Finland", "France", "Germany", "Greece", "Hong Kong", "Hungary", "India", "Indonesia", "Ireland", "Israel", "Italy", "Japan", "Kuwait", "Luxembourg", "Mexico", "Morocco", "Netherlands", "New Zealand", "Nigeria", "Norway", "Oman", "Pakistan", "Panama", "Peru", "Philippines", "Poland", "Portugal", "Qatar", "Romania", "Saudi Arabia", "Singapore", "South Africa", "South Korea", "Spain", "Sweden", "Switzerland", "Taiwan", "Thailand", "Turkey", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "Uruguay", "Venezuela", "Vietnam" ], "type": "string", "description": "šŸŒ Select the country for job search.\n\nšŸ“ This determines which Indeed domain to use (e.g., United States ā†’ indeed.com, United Kingdom ā†’ uk.indeed.com)\n\nšŸ’” Default: United States", "default": "United States" }, "location": { "title": "šŸ“ Location for Search", "type": "string", "description": "šŸ™ļø Any combination of city, zip code or locality for search.\n\nšŸ’” Used together with position/keywords.\n\nšŸ“ Examples: 'San Francisco', 'New York, NY', '90210', 'Remote'" }, "parseCompanyDetails": { "title": "šŸ¢ Scrape Company Details", "type": "boolean", "description": "šŸ“Š If enabled, will also navigate to company page of each job posting to scrape company info not available directly on job posting page.\n\nāœØ Includes: Company rating and reviews count\n\nāš” Note: This may slow down scraping slightly", "default": false }, "saveOnlyUniqueItems": { "title": "šŸ” Save Only Unique Job Listings", "type": "boolean", "description": "āœØ If enabled, only unique job listings will be scraped.\n\nšŸ›”ļø Prevents duplicate entries in your dataset.\n\nšŸ’” Recommended: Keep enabled for cleaner results", "default": true }, "followApplyRedirects": { "title": "šŸ”— Follow Redirects for Apply Link", "type": "boolean", "description": "šŸ”„ If enabled, will follow redirects of Indeed's externalApplyLink and output the final destination URL.\n\nāœØ Useful for getting direct application URLs.\n\nāš” Note: May add slight delay per job", "default": false }, "startUrls": { "title": "šŸ”— Start URLs", "type": "array", "description": "šŸ“‹ List of URLs that will be scraped.\n\nāœØ Supported URL types:\nā€¢ Job detail URLs: https://www.indeed.com/viewjob?jk=...\nā€¢ Company jobs URLs: https://www.indeed.com/cmp/Google/jobs\nā€¢ Search/category URLs: https://www.indeed.com/jobs?q=...\nā€¢ Main website URLs\n\nšŸ’” Can be combined with keyword search - both will execute independently.", "items": { "type": "string" } }, "requestDelay": { "title": "ā±ļø Request Delay (seconds)", "minimum": 0, "maximum": 10, "type": "integer", "description": "ā³ Delay between requests to avoid rate limiting.\n\nšŸ“ˆ Range: 0-10 seconds\nšŸ’” Default: 1 second (recommended)\n\nāš” Tip: Lower values = faster scraping, Higher values = more reliable", "default": 1 }, "proxyConfiguration": { "title": "šŸ”’ Proxy Configuration", "type": "object", "description": "šŸ›”ļø Configure proxy settings for enhanced reliability and bypassing restrictions.\n\nšŸ”„ Smart Fallback System:\n1ļøāƒ£ No proxy (default) - Direct connection to Indeed\n2ļøāƒ£ Datacenter proxy - If configured\n3ļøāƒ£ Residential proxy - Automatic fallback if blocked (with 3 retries)\n\nāœ… The actor automatically switches to residential proxy if requests are blocked.\n\nšŸ’” Recommended: Enable proxy for better success rates!" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }