# Utility Find Endpoint API (https://www.socialcrawl.dev/platforms/utility/find)

> Describe what you want in plain words, in any language ("last 200 comments on this TikTok <url>", "German Instagram creators about matcha") and get the three endpoints most likely to do it, best first: each with its method and path, the parameters your words already filled (only values you typed, never made up), the ones still missing, the credits that one call would hold (null with a note when it cannot be quoted yet), a confidence and a one-line reason, plus a few alternatives. Act on the top result only when uncertain is false. When no endpoint matches what the task means, or the matcher is unavailable, the results are keyword guesses and uncertain is always true. A request to act on an account (post, reply, like, follow, message, delete), about your own account or customers, or about billing returns no results (reason not_a_data_job) and the nearest reads as alternatives. A search value that names no topic (a placeholder such as "keyword", a country name, an English phrase for a Korean or Chinese platform, or most of the sentence) is left out and listed under missing, with a note saying why. A task that lists several topics or names several markets carries topics or markets (ISO codes) and is uncertain. Pass platform to keep the answer on one platform. Nothing is run. Free to call.

TL;DR: `GET /v1/utility/find` 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 |
| --- | --- | --- |
| `task` | no | The job in plain words, in any language. Up to 600 characters are read. Provide this or query |
| `query` | no | Alias for task. Provide this or task |
| `platform` | no | Keep the answer on one platform slug (tiktok, instagram, ...). Omit to search every platform |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/utility/find" \
  --data-urlencode "task=last 200 comments on https://www.tiktok.com/@stoolpresidente/video/7623818255903329566" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What does the Find Endpoint API return?

Returns the three endpoints most likely to do a task you describe, best first: the parameters your words filled, the ones still missing, one call's credits and a confidence. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields.

### When should I use the Find Endpoint endpoint?

Use it as the first step when you know the job but not the endpoint. It runs nothing, and says uncertain when you should check before calling. Free to call.

### How much does the Find Endpoint API cost?

This endpoint is free to call and uses no credits. Every new account still gets 100 free credits for the paid endpoints. Credits for failed or empty calls are refunded automatically, and there is no subscription.

### What parameters does the Find Endpoint API need?

Identify the target with one of task, query. It also accepts 3 optional parameters, all listed on this page.

### How do I call the Find Endpoint API?

Send a GET request to https://www.socialcrawl.dev/v1/utility/find?task=last%20200%20comments%20on%20https%3A%2F%2Fwww.tiktok.com%2F%40stoolpresidente%2Fvideo%2F7623818255903329566 with your API key in the x-api-key header. An Authorization: Bearer header works too.

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:

- What does the SocialCrawl Find Endpoint API return?
- How do I get Find Endpoint data with the SocialCrawl API?