{ "openapi": "3.0.1", "info": { "title": "SelectedFirms Scraper — Global B2B Agencies API", "description": "Scrape SelectedFirms.co global B2B IT and agency directory listings by category and country into JSON. Unofficial public-data scraper. CheerioCrawler. PPE $1.20/1k.", "version": "1.0", "x-build-id": "b1dmxXq8kBG4TlN9z" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/umararshad2~selectedfirms-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-umararshad2-selectedfirms-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/umararshad2~selectedfirms-scraper/runs": { "post": { "operationId": "runs-sync-umararshad2-selectedfirms-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/umararshad2~selectedfirms-scraper/run-sync": { "post": { "operationId": "run-sync-umararshad2-selectedfirms-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": "Directory category", "type": "string", "description": "Category shortcut used when startUrls is empty. Examples: software-development, web-development, mobile-app-development, web-design, ai-development, digital-marketing, ecommerce, it-services, blockchain, cloud-computing. Builds https://selectedfirms.co/companies/{slug}. Leave empty if you only pass startUrls.", "default": "software-development" }, "country": { "title": "Country filter", "type": "string", "description": "Optional country slug appended to the category path. Known public paths include usa, uk, canada, australia, uae, india. Leave empty for the worldwide category listing. Unknown slugs redirect to the global page." }, "startUrls": { "title": "Directory or agency URLs", "type": "array", "description": "Optional SelectedFirms directory URLs (https://selectedfirms.co/companies/...) or agency profile URLs (https://selectedfirms.co/agency/{slug}). When set, these are crawled instead of category+country.", "items": { "type": "string" } }, "maxCompanies": { "title": "Max companies", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on companies written to the dataset (after dedupe). Default 100, maximum 5000.", "default": 100 }, "maxPages": { "title": "Max directory pages", "minimum": 1, "maximum": 40, "type": "integer", "description": "Max paginated directory pages per start URL (?page=1,2,…). About 50 companies per page. Default 5. Keep this modest — the Actor is rate-limited.", "default": 5 }, "includeProfileDetails": { "title": "Enrich from agency profile", "type": "boolean", "description": "When true, open each public /agency/{slug} page for website, founded year, team size, hourly rate, budget band, phone, email, and social links that the agency published. When false, emit directory JSON-LD fields only (faster).", "default": true }, "useMockData": { "title": "Use mock / fixture data", "type": "boolean", "description": "Force fixture mode (no live SelectedFirms calls). For local CI only.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy settings. Directory JSON-LD usually works with datacenter or auto proxy. Switch to RESIDENTIAL if you see challenge pages.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }