# Utility Endpoints API (https://www.socialcrawl.dev/platforms/utility/endpoints)

> Machine-readable catalog of every active SocialCrawl endpoint: path, method, platform, credit cost, required and optional parameters, response archetype, and a link to the per-endpoint usage guide. Generated from the endpoint registry at request time, so it never drifts from what is callable. Free to call.

TL;DR: `GET /v1/utility/endpoints` costs Free (0 credits) and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `platform` | no | Filter the catalog to a single platform slug (e.g. tiktok) |
| `search` | no | Case-insensitive substring filter over endpoint paths and summaries |
| `method` | no | Filter by HTTP method (GET \| POST) |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/utility/endpoints" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What does GET /v1/utility/endpoints return?

A machine-readable catalog of every active SocialCrawl endpoint. Each entry carries the path, HTTP method, platform, credit cost, required and optional parameters, response archetype, and a how_to_use link to the per-endpoint usage guide, so one call maps the full 372-endpoint surface.

### How much does the endpoint catalog cost?

Nothing: the call is free at 0 credits, like the other developer-experience endpoints (endpoint, quickstart, and llms). You still authenticate with your x-api-key, but browsing the catalog never spends credits, so tools and agents can call it as often as they like.

### Can I filter the endpoint catalog?

Yes. Pass platform to scope the list to one platform slug (for example platform=tiktok), search for a case-insensitive substring match over paths and summaries, and method to keep only GET or POST endpoints. The three filters combine, which keeps agent context windows small.

### How does the catalog stay accurate?

It is generated from the running endpoint registry on each request, the same registry the API router uses. New endpoints appear as soon as they ship, retired ones drop out, and the advertised credit costs match billing, so the catalog cannot drift from what is callable.

### How do AI agents use the endpoint catalog?

As the discovery step of self-onboarding. An agent calls /v1/utility/endpoints to learn what exists, picks an entry, and follows its how_to_use link to /v1/utility/endpoint for exact parameters and a copy-paste request, without scraping documentation pages. The whole loop is free.

See the full Utility API: https://www.socialcrawl.dev/platforms/utility

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I list every endpoint the SocialCrawl API offers?
- Which API returns a machine-readable catalog of its own endpoints?