# Sortlist Agency Scraper — B2B Agency Leads, Websites & Socials (`scrapersdelight/sortlist-agency-scraper`) Actor

Scrape Sortlist.com agencies into a clean B2B lead list: name, website, LinkedIn & socials, full address, team size, founded year, services and ratings. Sitemap-wide or by service category. Export CSV/JSON.

- **URL**: https://apify.com/scrapersdelight/sortlist-agency-scraper.md
- **Developed by:** [Scrapers Delight](https://apify.com/scrapersdelight) (community)
- **Categories:** Automation, Lead generation, Agents
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$3.50 / 1,000 per agency returneds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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

## Sortlist Agency Scraper — B2B Agency Leads, Websites & Socials

Turn Sortlist.com's ~90,000-agency directory into a clean, structured B2B lead list — the EU-heavy alternative to Clutch / DesignRush. Scrape the whole site or one service category and get each agency's website, LinkedIn, socials, full postal address, team size, services and ratings, ready for outreach or enrichment.

### What you get

One row per agency, with the fields that make it a real lead:

- **Contact keys** — `website` (real domain, e.g. `https://2fellasmedia.com`), `linkedin`, `facebook`, `instagram`, `x`, `youtube`, `vimeo`
- **Location** — full `address` (street), `city`, `country`, `googlePlaceId`
- **Firmographics** — `teamSize`, `foundedYear`, `languages`
- **Positioning** — `services` (expertise tags), `primaryService`, `tagline`, `description`, `logoUrl`
- **Signals** — `reviewCount`, `averageRating`, `awardsCount`, `wonOpportunitiesCount`, `claimed`, `paidMember`, `trustedPartner`
- `name`, `slug`, `sortlistUrl`, `scrapedAt`

### Use cases

- **Agency lead lists for SaaS / B2B outreach** — feed website + LinkedIn into an email finder and pitch your tool to marketing, dev and design shops.
- **Market & competitor mapping** — size up EU marketing and development agencies by service, city, team size and rating.
- **Enrichment seed** — the website + LinkedIn are the join keys for downstream email/contact enrichment.
- **Clutch / DesignRush alternative coverage** — Sortlist is EU-heavy, so it's net-new supply for the same buyer.

### Input

- **Enumeration mode** — `sitemap` (all ~90k English agencies) or `category` (walk one or more service listings).
- **Service categories** — Sortlist expertise slugs, e.g. `digital-marketing`, `seo`, `branding`, `website-creation` (used when mode = category).
- **Start URLs** (optional) — paste specific `/agency/<slug>` or category listing URLs to override the modes.
- **Country filter** — keep only agencies whose office country matches (e.g. `United States`, `United Kingdom`, `Germany`). Empty = all.
- **Max agencies** — cap the run for cost/speed.

#### Example input

```json
{
  "mode": "category",
  "categorySlugs": ["digital-marketing", "seo"],
  "countryFilter": ["United States", "United Kingdom"],
  "maxAgencies": 500
}
````

### A note on emails and phones (honest)

Sortlist does **not** publish agencies' email addresses or phone numbers on their profiles, so this actor does not claim to return them. What it returns instead are the enrichment keys you need to find them: the agency's **website + LinkedIn + all social profiles + full postal address**. Pair the output with an email-finder / enrichment step to get inboxes.

### Pricing

**Pay per result — $3.50 per 1,000 agencies.** You're only charged for agencies actually scraped and delivered. A richer row than the Clutch lane (socials + street address + team size) at a lower per-lead price.

### FAQ

- **Which geographies?** Global, but EU-heavy — a strong complement to US-centric directories.
- **How fresh is the data?** Live — every field is read from the agency's current Sortlist profile at scrape time (`scrapedAt` timestamps each row).
- **Is this legal?** The actor reads only public agency profile pages (no login, no paywall). You are responsible for complying with Sortlist's Terms of Service and applicable data-protection law when you use the data.
- **Do I need a proxy?** RESIDENTIAL is the default for clean, polite access; datacenter proxies also work.

# Actor input Schema

## `mode` (type: `string`):

sitemap = all ~90k English agencies from Sortlist's sitemaps; category = walk one or more service-category listings.

## `categorySlugs` (type: `array`):

Sortlist expertise slugs, e.g. digital-marketing, seo, branding, website-creation. Used when mode = category.

## `startUrls` (type: `array`):

Paste specific /agency/<slug> profile URLs or category listing URLs to override the modes above.

## `countryFilter` (type: `array`):

Keep only agencies whose office country matches (case-insensitive contains). Empty = all countries.

## `maxAgencies` (type: `integer`):

Cap on agencies scraped this run (cost/speed guard).

## `proxyConfiguration` (type: `object`):

Proxy settings. RESIDENTIAL is the default for clean IP reputation and polite volume; Sortlist also works on datacenter proxies.

## Actor input object example

```json
{
  "mode": "category",
  "categorySlugs": [
    "digital-marketing",
    "seo",
    "branding"
  ],
  "countryFilter": [
    "United States",
    "United Kingdom",
    "Germany"
  ],
  "maxAgencies": 10,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `records` (type: `string`):

The dataset of scraped Sortlist agencies (one item per agency lead).

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "category",
    "categorySlugs": [
        "digital-marketing",
        "seo",
        "branding"
    ],
    "countryFilter": [
        "United States",
        "United Kingdom",
        "Germany"
    ],
    "maxAgencies": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapersdelight/sortlist-agency-scraper").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "category",
    "categorySlugs": [
        "digital-marketing",
        "seo",
        "branding",
    ],
    "countryFilter": [
        "United States",
        "United Kingdom",
        "Germany",
    ],
    "maxAgencies": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("scrapersdelight/sortlist-agency-scraper").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 '{
  "mode": "category",
  "categorySlugs": [
    "digital-marketing",
    "seo",
    "branding"
  ],
  "countryFilter": [
    "United States",
    "United Kingdom",
    "Germany"
  ],
  "maxAgencies": 10
}' |
apify call scrapersdelight/sortlist-agency-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scrapersdelight/sortlist-agency-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Sortlist Agency Scraper — B2B Agency Leads, Websites & Socials",
        "description": "Scrape Sortlist.com agencies into a clean B2B lead list: name, website, LinkedIn & socials, full address, team size, founded year, services and ratings. Sitemap-wide or by service category. Export CSV/JSON.",
        "version": "0.1",
        "x-build-id": "ZqO9TjhCmlF0IQFEN"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scrapersdelight~sortlist-agency-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scrapersdelight-sortlist-agency-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/scrapersdelight~sortlist-agency-scraper/runs": {
            "post": {
                "operationId": "runs-sync-scrapersdelight-sortlist-agency-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/scrapersdelight~sortlist-agency-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-scrapersdelight-sortlist-agency-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": {
                    "mode": {
                        "title": "Enumeration mode",
                        "enum": [
                            "sitemap",
                            "category"
                        ],
                        "type": "string",
                        "description": "sitemap = all ~90k English agencies from Sortlist's sitemaps; category = walk one or more service-category listings.",
                        "default": "category"
                    },
                    "categorySlugs": {
                        "title": "Service categories",
                        "type": "array",
                        "description": "Sortlist expertise slugs, e.g. digital-marketing, seo, branding, website-creation. Used when mode = category.",
                        "default": [
                            "digital-marketing"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "startUrls": {
                        "title": "Start URLs (optional)",
                        "type": "array",
                        "description": "Paste specific /agency/<slug> profile URLs or category listing URLs to override the modes above.",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "countryFilter": {
                        "title": "Country filter",
                        "type": "array",
                        "description": "Keep only agencies whose office country matches (case-insensitive contains). Empty = all countries.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxAgencies": {
                        "title": "Max agencies",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Cap on agencies scraped this run (cost/speed guard).",
                        "default": 1000
                    },
                    "proxyConfiguration": {
                        "title": "Proxy",
                        "type": "object",
                        "description": "Proxy settings. RESIDENTIAL is the default for clean IP reputation and polite volume; Sortlist also works on datacenter proxies.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ]
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
