# List directory agencies

Returns ranked agencies in one Clutch directory (e.g. `web-developers`, `agencies/digital-marketing`), each with rating, review count, rank position, contact info, rate/size/headcount bands, and percentage service mix. `data` is `null` when Clutch has no such directory — a 200, not a 404.

- Platform: Clutch
- Request: `GET https://api.toolzerhub.com/v1/clutch/directory`
- Auth: `x-api-key` header
- Cost: 1 credit per successful request. Failed requests are not billed.
- Page: https://docs.toolzerhub.com/reference/clutch/directory/get-clutch-directory

| Parameter | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `directory` | query | yes | string | The directory path as it appears on clutch.co, without the leading slash — web-developers, it-services, agencies/digital-marketing. There are 65,812 of them, so this is a free-form path rather than an enum; use the sitemap endpoint with kind=directory to enumerate the valid ones. |
| `count` | query | no | integer | Number of distinct providers to return (1-500). Pages contain about 50 new providers after de-duplication. Default: 80. |
| `start_page` | query | no | integer | Clutch page to start from (1 is the first page). One call reads up to 12 pages; pass the response's next_page here to continue. Default: 1. |

## Example request

```bash
curl "https://api.toolzerhub.com/v1/clutch/directory?directory=<directory>" \
  -H "x-api-key: $TOOLZERHUB_API_KEY"
```

Success responses are wrapped as `{ "data": ... }`. Errors return `{ "error": { "code", "status", "message", "retryable", "details" } }`. See https://docs.toolzerhub.com/docs/responses-and-errors.