{ "openapi": "3.0.1", "info": { "title": "ITFirms Scraper", "description": "Scrape curated \"top IT companies\" rankings from ITFirms.co across 53 categories - web/mobile development, AI, blockchain, digital marketing and more. Get website, description, services, key clients, location, employees, founded year, hourly rate and contact info. No login or API key required.", "version": "1.0", "x-build-id": "56ElMdT8CtsB4N9br" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~itfirms-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-itfirms-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/crawlerbros~itfirms-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-itfirms-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/crawlerbros~itfirms-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-itfirms-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", "required": [ "categories" ], "properties": { "categories": { "title": "Categories", "type": "array", "description": "One or more ITFirms ranking categories to scrape. Each category page lists up to 20 ranked companies.", "items": { "type": "string", "enum": [ "top-web-development-companies", "top-wordpress-development-companies", "top-php-development-companies", "top-magento-web-development-companies", "top-shopify-development-companies", "top-symfony-development-companies", "top-joomla-development-companies", "top-node-js-development-companies", "top-react-js-development-companies", "top-angularjs-development-companies", "top-dot-net-development-companies", "top-java-developers-and-development-companies", "top-python-development-companies", "top-ruby-rails-development-companies", "top-android-app-development-companies", "top-iphone-app-development-companies", "top-react-native-app-development-companies", "top-flutter-app-development-companies", "top-ionic-app-development-companies", "top-cross-platform-app-development-companies", "mobile-app-development-companies", "top-wearable-app-development-companies", "top-game-app-development-companies", "top-enterprise-app-development-companies", "fintech-app-development-companies", "healthcare-app-development-companies", "food-delivery-app-development-companies", "mvp-development-companies", "top-custom-software-development-companies", "top-software-testing-companies", "top-ecommerce-development-companies", "woocommerce-development-companies", "top-digital-marketing-companies", "top-seo-companies", "mobile-app-marketing-companies", "top-design-companies", "top-video-production-companies", "top-legal-cannabis-video-production-companies", "top-artificial-intelligence-companies", "top-machine-learning-companies", "top-generative-ai-companies", "top-metaverse-development-companies", "top-augmented-virtual-reality-development-companies", "top-blockchain-development-companies", "top-nft-development-companies", "top-iot-app-development-companies", "top-cloud-computing-companies", "top-managed-hosting-companies", "top-cybersecurity-companies", "top-saas-companies", "salesforce-consulting-companies", "top-mobile-app-development-companies-in-usa", "top-mobile-app-development-companies-in-canada" ], "enumTitles": [ "Web Development", "WordPress Development", "PHP Development", "Magento Development", "Shopify Development", "Symfony Development", "Joomla Development", "Node.js Development", "React.js Development", "AngularJS Development", ".NET Development", "Java Development", "Python Development", "Ruby on Rails Development", "Android App Development", "iPhone App Development", "React Native App Development", "Flutter App Development", "Ionic App Development", "Cross-Platform App Development", "Mobile App Development", "Wearable App Development", "Game App Development", "Enterprise App Development", "Fintech App Development", "Healthcare App Development", "Food Delivery App Development", "MVP Development", "Custom Software Development", "Software Testing", "E-Commerce Development", "WooCommerce Development", "Digital Marketing", "SEO", "Mobile App Marketing", "Design", "Video Production", "Cannabis Video Production", "Artificial Intelligence", "Machine Learning", "Generative AI", "Metaverse Development", "AR/VR Development", "Blockchain Development", "NFT Development", "IoT App Development", "Cloud Computing", "Managed Hosting", "Cybersecurity", "SaaS", "Salesforce Consulting", "Mobile App Development (USA)", "Mobile App Development (Canada)" ] } }, "keyword": { "title": "Keyword filter (optional)", "type": "string", "description": "Best-effort client-side filter: only keep companies whose name, description, location or services contain this keyword (case-insensitive)." }, "location": { "title": "Location filter (optional)", "type": "string", "description": "Only keep companies whose listed location contains this text (e.g. `India`, `USA`, `UK`)." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records (up to 20 companies per category).", "default": 40 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Only used if ITFirms.co temporarily blocks direct requests. Defaults to the free Apify AUTO datacenter group.", "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 } } }, "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 } } } } } } } } } }