# IT Agency Lead Finder & Enricher - Topdevelopers.co (`techforce.global/it-agency-lead-finder-enricher-topdevelopers-co`) Actor Extract verified IT & software development companies from TopDevelopers.co: Linkedin, emails, phones, social media, office locations, reviews. Search by keyword, country, platform, or company name. - **URL**: https://apify.com/techforce.global/it-agency-lead-finder-enricher-topdevelopers-co.md - **Developed by:** [Techforce Global](https://apify.com/techforce.global) (community) - **Categories:** Lead generation, Automation, Agents - **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $7.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### IT Agency Lead Finder & Enricher - TopDevelopers.co Scraper Extract verified IT development agency profiles, client reviews, and direct contact details from TopDevelopers.co — **no manual browsing, no copy-pasting, no missed leads.** Built for business development teams, procurement managers, and agency researchers who need accurate vendor shortlists fast, without spending hours on directory pages. --- ### ⭐ Why This Scraper? - ✅ **Search in plain English** — type "Android developers in India" or "Shopify experts USA" and get results instantly - ✅ **Verified agency data** — profiles are curated by TopDevelopers.co, so every result is a real, established agency - ✅ **Enriched contact details** — email addresses extracted directly from each agency's own website, not just the directory - ✅ **Client reviews included** — collect review headlines, ratings, project types, and budgets alongside company data - ✅ **Office locations** — every listed address (city, region, country, phone) captured per agency for territory mapping - ✅ **Fast, concurrent scraping** — multiple agency profiles are processed in parallel, so large runs finish in a fraction of the time - ✅ **Export-ready** — JSON, CSV, Excel, or direct API integration for your CRM or outreach tool --- ### 📝 Use Cases & ROI | Use Case | Time Saved | What You Get | | ------------------------------ | ------------------ | ---------------------------------------------------------------- | | **Vendor Shortlisting** | 4–8 hrs/project | Verified agency profiles with ratings, reviews, and contact info | | **B2B Sales Prospecting** | 3–6 hrs/campaign | Decision-maker contacts at niche tech agencies | | **Market Research** | 2–4 hrs/report | Agency density, specialization, and rating trends by region | | **CRM / ATS Enrichment** | Ongoing | Fresh agency data piped directly into your system via API | | **Partnership Sourcing** | 1–3 hrs/initiative | Agencies in your stack (Shopify, AWS, Salesforce, etc.) | --- ### 🚀 How to Use 1. Open the Actor on Apify 2. **Choose your discovery method** — one of three options: - Type a **Search Query** in plain English (e.g., `"Flutter developers in UAE"`) - Enter a specific **Company Name** to look up one agency directly - Use the **Domain + Category** dropdowns to browse a fixed service area 3. Set **Max Companies** — how many agency profiles to collect (up to 200 on paid plans) 4. (Optional) Set **Max Reviews Per Company** — how many client reviews to pull per agency (default: 10) 5. Click **Run** — results are ready in minutes 6. Download as CSV, Excel, or JSON — or connect via Apify API --- ### 🧩 Input Configuration | Field | Type | Required | Description | | ---------------------- | ------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `searchQuery` | String | Optional | Plain-English search phrase (e.g., `"React Native developers in Canada"`). The actor maps it to the closest TopDevelopers category automatically. | | `companyName` | String | Optional | Exact agency name to look up (e.g., `"Prismetric"`, `"Hyperlink Infosystem"`). Skips category browsing and fetches that agency's profile directly. | | `selectedDomain` | String | Optional | Main service domain to browse: `Mobile App Development`, `Web Development`, `Ecommerce Development`, `Artificial Intelligence`, etc. Used when no Search query is set. | | `selectedCategory` | String | Optional | Sub-filter on top of the Domain — pick a platform (e.g., `Android`, `Shopify`), a country, or an industry vertical. Leave empty to browse the entire Domain. | | `maxResults` | Integer | ✔️ Yes | Maximum number of agency profiles to collect in this run. Free plan is capped at **5**; paid plans can request up to **200**. Default: `20`. | | `maxReviewsPerCompany` | Integer | Optional | Upper limit on client reviews collected per agency. Review pages are calculated automatically from this value. Default: `10`. | | `maxConcurrency` | Integer | Optional | How many company profiles to scrape **at the same time**. Higher = faster runs. Range `1–10`, default: `5`. | > Use at least one of `searchQuery`, `companyName`, or `selectedDomain` — without one the actor has no starting point. #### Example — Search by Keyword ```json { "searchQuery": "Flutter developers in UAE", "maxResults": 50, "maxReviewsPerCompany": 5 } ```` #### Example — Browse Domain + Category ```json { "selectedDomain": "Ecommerce Development", "selectedCategory": "platform:shopify", "maxResults": 30, "maxReviewsPerCompany": 10 } ``` #### Example — Single Company Lookup ```json { "companyName": "Prismetric", "maxResults": 1, "maxReviewsPerCompany": 20 } ``` *** ### 📦 Output Fields Each record includes: | Field | Description | | ---------------- | ---------------------------------------------------------------------------------------------------- | | `company_name` | Agency name from the TopDevelopers profile | | `category` | Human-readable domain and category (e.g., `"Mobile App Development - Android"`) | | `rating` | Overall agency rating (0–5 scale). Null when not shown on profile. | | `review_count` | Total number of reviews displayed on the profile | | `description` | Short agency description from the profile | | `profile_url` | Direct link to the company's TopDevelopers profile | | `website_url` | External agency website URL (UTM and tracking suffixes stripped) | | `email` | Best contact email extracted from the agency's own website, or `NA` when unavailable | | `contact_number` | Best phone number from the profile or agency website, or `NA` when not found | | `social_media` | Social profile URLs — `linkedin`, `facebook`, `twitter`, `instagram`, `youtube`, `pinterest` | | `locations` | Array of office addresses from the profile — `street_address`, `city`, `region`, `country`, `phone` | | `insights` | Aggregated signals: useful review count, average rating, top project types, common budget ranges | | `reviews` | Array of cleaned client reviews — headline, reviewer name, rating, project type, budget, feedback | #### Example Output ```json [ { "company_name": "Prismetric", "category": "Mobile App Development - Android", "rating": 4.9, "review_count": 42, "description": "Top-rated mobile app development company specializing in Android, iOS, and Flutter solutions.", "profile_url": "https://www.topdevelopers.co/profile/prismetric", "website_url": "https://www.prismetric.com", "email": "info@prismetric.com", "contact_number": "+1-408-600-0534", "social_media": { "linkedin": "https://www.linkedin.com/company/prismetric", "facebook": "https://www.facebook.com/Prismetric", "twitter": "https://twitter.com/prismetric" }, "locations": [ { "street_address": "201, Shivam Complex, Opposite Hetarth Party Plot, Science City Road, Sola", "city": "Ahmedabad", "region": "Gujarat", "country": "India", "phone": "917405122300" }, { "street_address": "886 Village Green, Westfield", "city": "Union", "region": "New Jersey", "country": "USA", "phone": "19083016001" } ], "insights": { "useful_review_count": 12, "average_review_rating": 4.8, "top_project_types": ["Mobile App", "Web Development"], "common_project_budgets": ["$10,001 - $50,000", "$50,001 - $200,000"] }, "reviews": [ { "review_headline": "Outstanding Flutter app delivery", "reviewer_name": "John Smith", "reviewer_designation": "CTO, RetailCo", "review_rating": 5.0, "review_project_type": "Mobile App", "review_project_budget": "$10,001 - $50,000", "review_feedback": "Delivered on time, clean code, excellent communication throughout the project." } ] } ] ``` *** ### 🔌 Integrations Plug directly into your existing stack: - **n8n / Make (Integromat)** — automate vendor sourcing and CRM enrichment workflows - **Zapier** — push results to Google Sheets, Notion, HubSpot, or your procurement tool - **REST API** — poll results programmatically from any CRM, ATS, or internal tool - **CSV / Excel** — instant download for manual review, scoring, or bulk outreach import *** ### 🆘 Support For issues, custom sourcing requests, or feature suggestions: **Email**: bhavin.shah@techforceglobal.com *** #### Need a Custom Pipeline? Want more than 200 agencies per run, multi-category batch exports, or full CRM integration? #### [📅 Book a Free 15-min Consultation](https://calendly.com/techforce-infotech-pvt-ltd/intro-meeting?month=2026-01) *** Made with ❤️ by **[Techforce](https://www.techforceglobal.com)** Specialists in High-Performance Web Scrapers and AI Automation. *** ### Disclaimer This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by TopDevelopers.co. TopDevelopers® is a registered trademark of its respective owner. All trademarks are property of their respective owners. This scraper accesses only publicly available data in accordance with TopDevelopers.co's publicly visible directory pages. # Actor input Schema ## `searchQuery` (type: `string`): 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'. ## `companyName` (type: `string`): 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` (type: `string`): Pick the main service area you want to browse. Used when no Search query or Company name is set. ## `selectedCategory` (type: `string`): 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. ## `maxResults` (type: `integer`): Maximum number of company records to collect in this run. Free plan is capped at 5 companies; paid plans can request up to 200. ## `maxReviewsPerCompany` (type: `integer`): Upper limit on the number of client reviews to collect from each company profile. Review pages are calculated automatically. ## `maxConcurrency` (type: `integer`): 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. ## Actor input object example ```json { "searchQuery": "Software development companies in USA", "selectedDomain": "", "selectedCategory": "", "maxResults": 20, "maxReviewsPerCompany": 5, "maxConcurrency": 5 } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("techforce.global/it-agency-lead-finder-enricher-topdevelopers-co").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("techforce.global/it-agency-lead-finder-enricher-topdevelopers-co").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call techforce.global/it-agency-lead-finder-enricher-topdevelopers-co --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=techforce.global/it-agency-lead-finder-enricher-topdevelopers-co", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "IT Agency Lead Finder & Enricher - Topdevelopers.co", "description": "Extract verified IT & software development companies from TopDevelopers.co: Linkedin, emails, phones, social media, office locations, reviews. Search by keyword, country, platform, or company name.", "version": "0.0", "x-build-id": "U6k8SSLvir3zFTkWi" }, "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": { "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.", "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 } } } } } } } } } } ```