{ "openapi": "3.0.1", "info": { "title": "Workana Projects & Client Demand Scraper (LATAM)", "description": "Scrape public project listings from Workana, Latin America's largest freelance marketplace: budget, skills, client country, proposal count and client reputation signals. Only filters that Workana actually applies. Declares its own coverage ceiling. No login, no session cookies.", "version": "0.1", "x-build-id": "b6s8xC6oOK0OQumKb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/oswaldocarabano~workana-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-oswaldocarabano-workana-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/oswaldocarabano~workana-scraper/runs": { "post": { "operationId": "runs-sync-oswaldocarabano-workana-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/oswaldocarabano~workana-scraper/run-sync": { "post": { "operationId": "run-sync-oswaldocarabano-workana-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": { "category": { "title": "Category", "enum": [ "it-programming", "design-multimedia", "sales-marketing", "writing-translation", "admin-support", "finance-management", "engineering-manufacturing", "legal" ], "type": "string", "description": "One of Workana's 8 top-level categories. Leave empty to sweep all of them." }, "subcategory": { "title": "Subcategory", "enum": [ "web-development", "web-design", "e-commerce", "wordpress-1", "mobile-development", "data-science-1", "desktop-apps", "artificial-intelligence-1", "others-5", "logo-design", "web-design-1", "banners", "illustrations", "make-or-edit-a-video", "infographics", "images-for-social-networks", "mobile-app-design", "corporate-image", "3d-models", "landing-page", "fashion-design-1", "artificial-intelligence-2", "others-1", "seo", "community-management", "advertising-on-google-facebook", "e-mail-marketing", "data-analytics", "televentas", "sales-executive", "artificial-intelligence-6", "others", "article-writing-1", "writing-for-websites", "proofreading-1", "content-for-social-networks", "translation", "subtitling-1", "artificial-intelligence-7", "others-6", "virtual-assistant-1", "customer-support", "data-entry-1", "market-research-1", "telesales", "artificial-intelligence-3", "others-2", "gather-data", "work-with-a-crm", "project-management-1", "recruiting", "strategic-planning-1", "accounting-1", "artificial-intelligence-5", "others-4", "industrial-design-1", "cad-drawing", "3d-modelling-1", "interior-design-1", "artificial-intelligence-4", "others-3" ], "type": "string", "description": "Narrower than a category — 61 to choose from, grouped by their parent. This is the axis that narrows a large category the most." }, "skill": { "title": "Skill slug", "type": "string", "description": "A single skill slug as it appears in a Workana URL, e.g. \"python\", \"react-js\", \"laravel\". This is a free-text field on purpose: Workana keeps adding skills, so any fixed list here would go stale. The actor checks the slug before the run starts — a wrong one returns zero projects with HTTP 200 on Workana (\"react\" gives nothing, \"react-js\" gives hundreds), and an empty run that looks correct is the worst kind of failure. You can find valid slugs in the skill_slugs field of any row. Note that only one skill applies: Workana keeps the first value and drops the rest." }, "country": { "title": "Client's country", "enum": [ "AR", "BR", "MX", "ES", "CO", "PE", "CL", "VE", "US", "EC", "UY", "BO", "PY", "CR", "PA", "GT", "DO", "HN", "NI", "SV", "AF", "AL", "DE", "AD", "AO", "AI", "AQ", "AG", "SA", "DZ", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BT", "BQ", "BA", "BW", "BN", "BG", "BF", "BI", "CV", "KH", "CM", "CA", "TD", "CN", "CY", "KM", "KR", "HR", "CW", "DK", "DJ", "DM", "EG", "AE", "ER", "SK", "SI", "EE", "ET", "PH", "FI", "FJ", "FR", "GA", "GM", "GE", "GS", "GH", "GI", "GD", "GR", "GL", "GP", "GU", "GY", "GF", "GG", "GN", "GW", "GQ", "HT", "HK", "HU", "IN", "ID", "IQ", "IE", "BV", "CX", "IM", "NF", "IS", "AX", "BM", "KY", "CC", "CK", "FO", "HM", "FK", "MP", "MH", "UM", "SB", "TC", "VI", "VG", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KG", "KI", "KW", "LA", "LS", "LV", "LB", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MY", "MW", "MV", "ML", "MT", "MA", "MQ", "MU", "MR", "YT", "FM", "MD", "MC", "MN", "ME", "MS", "MZ", "MM", "NA", "NR", "NP", "NE", "NG", "NU", "NO", "NC", "NZ", "OM", "NL", "PK", "PW", "PS", "PG", "PN", "PF", "PL", "PT", "PR", "QA", "GB", "CF", "CZ", "CG", "CD", "RE", "RW", "RO", "RU", "EH", "MF", "WS", "AS", "BL", "KN", "SM", "PM", "VC", "SH", "LC", "ST", "SN", "CI", "RS", "SC", "SL", "SG", "SX", "SO", "LK", "ZA", "SE", "CH", "SR", "SJ", "SZ", "TH", "TW", "TZ", "TJ", "IO", "TF", "TL", "TG", "TK", "TO", "TT", "TN", "TM", "TR", "TV", "UA", "UG", "UZ", "VU", "VA", "VN", "WF", "YE", "ZM", "ZW" ], "type": "string", "description": "Where the client is based. The most active countries are listed first." }, "query": { "title": "Free-text search", "type": "string", "description": "Free-text search over the project listings. The only axis without a fixed vocabulary, so it is the most flexible way to narrow a large category." }, "maxItems": { "title": "Maximum projects", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Hard cap on projects delivered. Note the site's own limit: Workana serves 7 projects per page and stops at page 50, so a single query reaches at most ~350 projects. To go beyond that the actor splits the query by country automatically, and every run reports what it could and could not reach under COVERAGE in the key-value store.", "default": 500 }, "locale": { "title": "Content language", "enum": [ "es", "en", "pt" ], "type": "string", "description": "Which language Workana renders its text fields in. This changes the wording of budget, dates and proposal counts, and the actor parses each one accordingly — including the thousands separator, which is a dot in Spanish and a comma in English.", "default": "es" }, "maxCacheAgeHours": { "title": "Maximum cache age (hours)", "minimum": 0, "maximum": 168, "type": "integer", "description": "Upper bound on how old a cached page may be before it is refetched. Set to 0 to force fresh data on every page. The cache is shared across everyone who runs this Actor and lives outside Apify, so a page someone already fetched within the window is served without touching Workana again: fewer requests, faster runs, and less load on the site. You never have to take our word for which case you are in — every row carries from_cache, fetched_at and data_age_hours, and the run log reports the hit and miss counts. The default of 6 hours is measured rather than guessed: the median project goes from about 1 proposal in its first hours to about 10 by the twelfth, so anything staler than that would understate the competition you face.", "default": 6 }, "includeCoverageReport": { "title": "Include coverage report", "type": "boolean", "description": "Write one entry per query under COVERAGE in the key-value store, stating how many projects Workana declared, how many were delivered and whether the site's page-50 ceiling was reached. Keep this on to know exactly what a run did and did not cover.", "default": true }, "maxConcurrency": { "title": "Maximum concurrency", "minimum": 1, "maximum": 5, "type": "integer", "description": "Parallel requests. The default of 3 is measured, not guessed: 180 requests at concurrency 1, 2 and 3 completed with zero failures, while concurrency 5 produced 5% HTTP 503 responses from Workana's own servers. Raising it makes runs less reliable, not faster.", "default": 3 } } }, "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 } } } } } } } } } }