{ "openapi": "3.0.1", "info": { "title": "Marketing & Digital Agency Database — Sortlist", "description": "Search 90+ service categories on Sortlist for marketing, creative, and tech agencies. Returns registration number, budget range, service-line breakdown, and paid-placement flags that separate sponsored listings from organic rank.", "version": "0.1", "x-build-id": "SNlbXVcOjVhAeWbZD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~sortlist-agency-directory-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-sortlist-agency-directory-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/jungle_synthesizer~sortlist-agency-directory-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-sortlist-agency-directory-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/jungle_synthesizer~sortlist-agency-directory-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-sortlist-agency-directory-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": [ "maxItems" ], "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "What will this data feed? E.g. lead lists, KYB checks, price tracking." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact email (optional)", "minLength": 1, "type": "string", "description": "We'll personally help with your use case. No spam." }, "resumeCursor": { "title": "Resume cursor (continue a previous run)", "type": "string", "description": "Leave empty for a fresh crawl. To CONTINUE a previous run where it stopped — without paying again for records you already received — paste the `resumeCursor` value from that run's Output (the run's OUTPUT key). Resume promptly: the previous run's data expires with your account's retention window (free tier: your ~10 most recent runs)." }, "expertises": { "title": "Service Categories", "type": "array", "description": "Sortlist service categories to crawl (e.g. seo, web-development, branding). Each category's directory page already returns Sortlist's full global agency listing for that service, deduplicated on the agency's stable external_id across categories. Leave empty to crawl all 90+ categories (the full corpus).", "items": { "type": "string", "enum": [ "2d-animation", "2d-design", "2d-game-development", "3d-animation", "3d-design", "3d-game-development", "3d-modeling", "3d-printing", "access-management", "account-takeover-prevention", "accounting-services", "acumatica-erp-consulting", "advertising", "advertising-campaign", "advertising-production", "affiliate-marketing", "ai-agents", "ai-marketing", "akeneo-pim", "amazon-advertising", "amp-development", "android-app-development", "animation", "app-development", "appointment-setting", "artificial-intelligence", "audio-production", "audiovisual-production", "augmented-reality", "auth0-iam-solution", "aws-consulting", "azure-consulting", "back-office-outsourcing", "bi-app-development", "blockchain-consulting", "blockchain-development", "branding", "cloud-computing", "cloud-consulting", "communication", "community-management", "consulting", "content-writing", "copywriting", "crm-consulting", "cyber-security", "design", "digital-copywriting", "digital-marketing", "domain-management", "e-commerce-development", "ecommerce", "ecommerce-design", "email-marketing", "employer-branding", "event", "event-management", "gaming", "graphic-identity", "growth-marketing", "ibm-ecm-consulting", "influencer-marketing", "innovation", "international-branding", "ios-development", "lead-generation", "machine-learning", "marketing", "marketing-automation", "marketing-services", "photography", "print-design", "product-management", "saas-strategy-consulting", "seo", "shopify", "shopify-marketing", "social-media", "social-media-growth", "software-development", "usability-testing", "user-experience", "ux-agency", "video", "video-editing", "video-marketing", "virtual-reality", "web-analytics", "web-design", "web-development", "webshop-development", "website-administration", "wordpress-development" ], "enumTitles": [ "2D Animation", "2D Design", "2D Game Development", "3D Animation", "3D Design", "3D Game Development", "3D Modeling", "3D Printing", "Access Management", "Account Takeover Prevention", "Accounting Services", "Acumatica ERP Consulting", "Advertising", "Advertising Campaign", "Advertising Production", "Affiliate Marketing", "AI Agents", "AI Marketing", "Akeneo PIM", "Amazon Advertising", "AMP Development", "Android App Development", "Animation", "App Development", "Appointment Setting", "Artificial Intelligence", "Audio Production", "Audiovisual Production", "Augmented Reality", "Auth0 IAM Solution", "AWS Consulting", "Azure Consulting", "Back Office Outsourcing", "BI App Development", "Blockchain Consulting", "Blockchain Development", "Branding", "Cloud Computing", "Cloud Consulting", "Communication", "Community Management", "Consulting", "Content Writing", "Copywriting", "CRM Consulting", "Cyber Security", "Design", "Digital Copywriting", "Digital Marketing", "Domain Management", "E-Commerce Development", "Ecommerce", "Ecommerce Design", "Email Marketing", "Employer Branding", "Event", "Event Management", "Gaming", "Graphic Identity", "Growth Marketing", "IBM ECM Consulting", "Influencer Marketing", "Innovation", "International Branding", "iOS Development", "Lead Generation", "Machine Learning", "Marketing", "Marketing Automation", "Marketing Services", "Photography", "Print Design", "Product Management", "SaaS Strategy Consulting", "SEO", "Shopify", "Shopify Marketing", "Social Media", "Social Media Growth", "Software Development", "Usability Testing", "User Experience", "UX Agency", "Video", "Video Editing", "Video Marketing", "Virtual Reality", "Web Analytics", "Web Design", "Web Development", "Webshop Development", "Website Administration", "WordPress Development" ] } }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of unique agencies to scrape (deduplicated across all requested categories)." } } }, "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 } } } } } } } } } }