{
  "openapi": "3.0.1",
  "info": {
    "title": "Agency Leads Scraper 🏢 marketing & dev agencies + contacts",
    "description": "Build a prospecting list of marketing, design and software agencies: website, services, hourly rate, minimum budget, team size, rating, plus phone, email and address from the agency's own profile. DesignRush and Sortlist together, 28 categories, 69 countries. No API key, flat price per agency.",
    "version": "0.1",
    "x-build-id": "OQW2GoLqBblVhfizz"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tagadanar~agency-leads-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tagadanar-agency-leads-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/tagadanar~agency-leads-scraper/runs": {
      "post": {
        "operationId": "runs-sync-tagadanar-agency-leads-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/tagadanar~agency-leads-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-tagadanar-agency-leads-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": {
          "categories": {
            "title": "What kind of agency?",
            "minItems": 1,
            "type": "array",
            "description": "The service you want agencies for, in plain words: <code>digital marketing</code>, <code>seo</code>, <code>web design</code>, <code>branding</code>, <code>software development</code>. Add several to build one combined list. Full list: digital-marketing, seo, ppc-paid-media, social-media-marketing, content-marketing, email-marketing, public-relations, advertising, influencer-marketing, lead-generation, web-design, web-development, ecommerce, software-development, mobile-app-development, ui-ux-design, branding, graphic-design, video-production, ai, cybersecurity, cloud-consulting, blockchain, market-research, it-services, marketing-strategy, marketing-automation, game-development.",
            "items": {
              "type": "string"
            }
          },
          "location": {
            "title": "Country (optional)",
            "type": "string",
            "description": "Limit the list to one country, by name or ISO code: <code>United States</code>, <code>us</code>, <code>Germany</code>, <code>de</code>. Leave empty for agencies worldwide. Both directories list agencies that <i>serve</i> a country as well as ones headquartered there, so check the <code>country</code> column if you only want local head offices. For a city or a US state, paste the directory URL into the field below instead."
          },
          "sources": {
            "title": "Which directories",
            "type": "array",
            "description": "Leave all three ticked for the widest list. DesignRush brings phone numbers, email addresses and street addresses; Sortlist adds company registration numbers, exact headcounts, spoken languages and client sectors; Clutch adds verified client reviews, hourly rates, minimum project sizes and phone numbers. An agency on several directories is returned once per directory so you can compare.",
            "items": {
              "type": "string",
              "enum": [
                "designrush",
                "sortlist",
                "clutch"
              ],
              "enumTitles": [
                "DesignRush",
                "Sortlist",
                "Clutch"
              ]
            },
            "default": [
              "designrush",
              "sortlist",
              "clutch"
            ]
          },
          "includeContactDetails": {
            "title": "Add phone numbers and emails",
            "type": "boolean",
            "description": "Opens each DesignRush agency's profile to add the phone number, email address, street address, star rating and social profiles. Leave this on for prospecting. Turning it off makes a run several times faster and cheaper when you only need names, services, rates and websites. Sortlist rows are unaffected: that directory publishes no phone or email at all, so nothing extra is fetched or charged for them.",
            "default": true
          },
          "directoryUrls": {
            "title": "Directory URLs (optional)",
            "type": "array",
            "description": "Paste DesignRush, Sortlist or Clutch listing URLs to scrape exactly those pages, for example <code>https://www.designrush.com/agency/digital-marketing/new-york/new-york-city</code>, <code>https://www.sortlist.com/i/branding/germany-de</code> or <code>https://clutch.co/agencies/digital-marketing</code>. Use this for city and state pages, or any filtered listing the fields above do not cover. Agency profile URLs are not accepted here.",
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "Max agencies",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "Total agencies to return across every category and directory in this run. DesignRush lists 50 per page and pages up to 483 deep; Sortlist returns 100 per page for up to 48 pages. This is the number that decides the size of your bill.",
            "default": 100
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}