{ "openapi": "3.0.1", "info": { "title": "Upwork Jobs Scraper: Multipage Job Search & Client Data", "description": "Scrape Upwork freelance jobs across multiple search pages. Collect descriptions, skills, budgets and client details. Filter and export JSON, CSV or Excel.", "version": "1.0", "x-build-id": "WJQtQTaLeQA2GLQta" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stanvanrooy6~upwork-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stanvanrooy6-upwork-jobs-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/stanvanrooy6~upwork-jobs-scraper/runs": { "post": { "operationId": "runs-sync-stanvanrooy6-upwork-jobs-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/stanvanrooy6~upwork-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-stanvanrooy6-upwork-jobs-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": { "search": { "title": "Search Query", "type": "string", "description": "Search public Upwork jobs by keywords. Follows successive result pages until the result limit, source exhaustion or page budget." }, "searches": { "title": "Additional search queries", "maxItems": 20, "type": "array", "description": "Up to 20 additional keyword queries. Queries run in order and share one output limit; duplicates are removed.", "items": { "type": "string" } }, "start_urls": { "title": "Public skill or job URLs", "maxItems": 100, "type": "array", "description": "Supplemental Upwork public skill or job URLs, processed after keyword searches. Skill URLs expose a limited sample; use search for pagination.", "items": { "type": "string" } }, "keywords": { "title": "Keywords within the sample", "type": "string", "description": "Additional words to match in titles, descriptions and skills. All words must match." }, "include_details": { "title": "Include client and job activity details", "type": "boolean", "description": "Fetch public job detail pages for client information and activity. Turn off for faster listing-only extraction.", "default": true }, "max_concurrency": { "title": "Concurrent requests", "minimum": 1, "maximum": 8, "type": "integer", "description": "Maximum concurrent provider requests. Higher values do not guarantee faster responses.", "default": 4 }, "job_type": { "title": "Job type", "enum": [ "both", "hourly", "fixed" ], "type": "string", "description": "Search for hourly jobs, fixed-price jobs, or both.", "default": "both" }, "limit": { "title": "Maximum Jobs to Scrape", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum unique jobs across all queries and URLs. Free accounts stop at 100 rows per run. Normal charges apply.", "default": 10 }, "category": { "title": "Job Category", "enum": [ "", "531770282584862721", "531770282601639955", "531770282601639943", "531770282601639945", "531770282601639946", "531770282601639944", "531770282601639947", "531770282584862722", "531770282584862724", "531770282584862725", "531770282584862728", "531770282584862726", "531770282584862723", "531770282584862730", "531770282584862729", "531770282593251329", "531770282593251330", "531770282593251331", "531770282589057038", "531770282593251329+1", "531770282593251334", "531770282593251341", "531770282593251340", "531770282593251334+1", "531770282593251334+2", "531770282593251334+3", "531770282593251340+1", "531770282593251340+2", "531770282601639953", "531770282593251340+3", "531770282601639948", "531770282601639949", "531770282605834240", "531770282601639950", "531770282605834241", "531770282601639951", "531770282605834242", "531770282601639952", "531770282601639948+1", "531770282601639948+2", "531770282589057033", "531770282589057033+1", "531770282589057034", "531770282589057036", "531770282589057035", "531770282589057037", "531770282584862723+1", "531770282605834246", "531770283696353280", "531770283696353280+1", "531770283696353280+2", "531770282580668422", "531770282597445636", "531770282597445634", "531770282593251343", "531770282580668418", "531770282601639939", "531770282601639939+1", "531770282589057024", "531770282589057024+1", "531770282589057024+2", "531770282589057025", "531770282589057026", "531770282589057027", "531770282589057024+3", "531770282589057032", "531770282589057030", "531770282589057031", "531770282589057028", "531770282589057029", "531770282584862733", "531770282580668423", "531770282597445644", "531770282597445646", "531770282597445644+1", "531770282597445646+1" ], "type": "string", "description": "Category filter sent to guest search. When using explicit public URLs, matching requires job detail requests.", "default": "" }, "sort": { "title": "Sort by", "enum": [ "relevance", "newest" ], "type": "string", "description": "Sort within each query by newest posting or relevance. Multiple queries are processed in input order, not globally sorted.", "default": "newest" }, "contractor_tier": { "title": "Experience", "uniqueItems": true, "type": "array", "description": "Select one or more contractor tiers", "items": { "type": "string", "enum": [ "1", "2", "3" ], "enumTitles": [ "Entry level", "Intermediate", "Expert" ] } }, "min_fixed_price": { "title": "Min fixed price", "minimum": 0, "type": "integer", "description": "Minimum fixed price budget" }, "max_fixed_price": { "title": "Max fixed price", "minimum": 0, "type": "integer", "description": "Maximum fixed price budget" }, "min_hourly_rate": { "title": "Min hourly rate", "minimum": 0, "type": "integer", "description": "Minimum hourly rate" }, "max_hourly_rate": { "title": "Max hourly rate", "minimum": 0, "type": "integer", "description": "Maximum hourly rate" }, "page_size": { "title": "Search page size", "minimum": 10, "maximum": 50, "type": "integer", "description": "Jobs requested per search page. Supported values: 10, 20 or 50.", "default": 50 }, "max_pages": { "title": "Maximum pages per query", "minimum": 1, "maximum": 200, "type": "integer", "description": "Bound the number of search pages, especially with restrictive local filters. The Actor stops earlier when the result limit is reached.", "default": 100 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }