{ "openapi": "3.0.1", "info": { "title": "TopDevelopers Scraper - IT Agency Leads with Real Emails", "description": "Search in plain English and get real IT agency profiles from TopDevelopers.co with emails pulled from each agency's own website, full client reviews, and the budget ranges and project types they actually handle, so you know if they're a fit before you reach out.", "version": "0.0", "x-build-id": "vccbrJxhGRg8KVlYG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/techforce.global~it-agency-lead-finder-enricher-topdevelopers-co/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-techforce.global-it-agency-lead-finder-enricher-topdevelopers-co", "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/techforce.global~it-agency-lead-finder-enricher-topdevelopers-co/runs": { "post": { "operationId": "runs-sync-techforce.global-it-agency-lead-finder-enricher-topdevelopers-co", "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/techforce.global~it-agency-lead-finder-enricher-topdevelopers-co/run-sync": { "post": { "operationId": "run-sync-techforce.global-it-agency-lead-finder-enricher-topdevelopers-co", "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": { "resultTier": { "title": "How much data do you need per company?", "enum": [ "full", "basic" ], "type": "string", "description": "Basic is the cheapest option — it reads only the TopDevelopers profile page, so you get company name, category, rating, review count, description, website, phone, social profiles and office locations. Full costs more per company and adds the verified email address found on the company's own website, plus client reviews and the insights derived from them.", "default": "full" }, "searchQuery": { "title": "What kind of agency are you looking for?", "type": "string", "description": "Type what you want in plain English and we will figure out the right category. Examples: 'android app developers in India', 'shopify experts', 'AI companies', 'web design agencies in the UK'.", "default": "Software development companies in USA" }, "companyName": { "title": "Or look up a specific company by name", "type": "string", "description": "Enter the exact agency name (e.g. 'Prismetric', 'Hyperlink Infosystem') to fetch only that one profile. When set, this skips the category browse and goes straight to the company page." }, "selectedDomain": { "title": "Or browse a Domain", "enum": [ "", "Mobile App Development", "Web Development", "Software Development", "Ecommerce Development", "Artificial Intelligence", "Big Data Analytics", "Digital Marketing", "Business Services", "Blockchain", "Cloud Computing", "UI/UX Design" ], "type": "string", "description": "Pick the main service area you want to browse. Used when no Search query or Company name is set.", "default": "" }, "selectedCategory": { "title": "Narrow it down (optional)", "enum": [ "", "platform:android", "platform:ios", "platform:flutter", "platform:react-native", "platform:wearable", "platform:php", "platform:laravel", "platform:wordpress", "platform:drupal", "platform:magento", "platform:saas", "platform:devops", "platform:qa-testing", "platform:shopify", "platform:woocommerce", "platform:bigcommerce", "platform:machine-learning", "platform:chatbot", "platform:generative-ai", "platform:business-intelligence", "platform:data-science", "platform:seo", "platform:ppc", "platform:social-media", "platform:content-marketing", "platform:ethereum", "platform:hyperledger", "platform:nft", "platform:aws", "platform:azure", "platform:salesforce", "location:usa", "location:india", "location:uk", "location:canada", "location:australia", "location:uae", "location:germany", "location:russia", "industry:healthcare", "industry:education", "industry:fintech", "industry:retail", "industry:real-estate", "industry:travel", "industry:logistics", "industry:business-services", "industry:information-technology" ], "type": "string", "description": "Optional filter on top of the Domain — pick a platform (e.g. Android, Shopify), a country, or an industry. Leave as 'None' to browse the entire Domain.", "default": "" }, "maxResults": { "title": "Max companies to scrape", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of company records to collect in this run. Free plan is capped at 5 companies; paid plans can request up to 200.", "default": 20 }, "maxReviewsPerCompany": { "title": "How many reviews per company", "minimum": 1, "maximum": 20, "type": "integer", "description": "Upper limit on the number of client reviews to collect from each company profile. Review pages are calculated automatically. Ignored when the result type is Basic, because Basic does not collect reviews.", "default": 5 }, "maxConcurrency": { "title": "Concurrent company profiles", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many company profiles to scrape at the same time. Higher values finish faster but use more resources and hit the site harder. Default: 5.", "default": 5 } } }, "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 } } } } } } } } } }