# Common jobs (/docs/common-jobs)

The jobs customers come to SocialCrawl for, each with the calls that do it, a cURL to copy and the price of one run

Pick the job you need done and copy its call. Each job below lists the calls that do it, a cURL you can paste with your key, and the price of one run in credits.

For a job in your own words, send it to `GET /v1/utility/plan?query=`. It returns the calls in order, with the values your words filled in and the price of each, and says so instead of guessing when it is not confident. The plan costs 0 credits and runs nothing. See [Plan the calls for a job](/docs/utility.md#plan-the-calls-for-a-job).

```bash title="cURL"
curl -G "https://www.socialcrawl.dev/v1/utility/plan" \
  --data-urlencode "query=Combine @nike's TikTok profile with their recent videos and the comments on them" \
  -H "x-api-key: YOUR_API_KEY"
```

Prices are for one run of the example as shown. Some calls are metered and charge within a range that depends on how much work the call does; [Endpoint pricing](/docs/endpoint-pricing.md) lists every range.

| Job | First call | Price per run |
| --- | --- | --- |
| [Watch a brand](#watch-a-brand) | `GET /v1/prism/brand-mentions` | 50 credits |
| [What people say under a post](#what-people-say) | `GET /v1/tiktok/post/comments` | 1 credit |
| [Mine comments for buyers](#mine-comments-for-buyers) | `GET /v1/prism/comments` | 60 credits |
| [Profile, posts and comments for one creator](#one-creator) | `GET /v1/tiktok/profile` | 3 credits |
| [One creator on every platform](#creator-across-platforms) | `GET /v1/prism/creator-card` | 5 credits |
| [Track a creator daily](#track-a-creator-daily) | `GET /v1/instagram/profile/posts` | 1 credit |
| [Find creators in a niche](#find-creators) | `GET /v1/search/creators` | 10 credits |
| [Vet a creator](#vet-a-creator) | `GET /v1/prism/creator-vet` | 50 credits |
| [Search a topic on several platforms](#topic-everywhere) | `GET /v1/search/multi` | 3 credits |
| [Find posts from people ready to buy](#buying-signals) | `GET /v1/reddit/search` | 1 credit |
| [Transcribe a video](#transcripts) | `GET /v1/youtube/video/transcript` | 3 credits |
| [See a competitor's ads](#competitor-ads) | `GET /v1/facebook/adlibrary/search/ads` | 5 credits |
| [What buyers say about a product](#product-reviews) | `GET /v1/amazon/reviews` | 5 credits |

## Watch a brand

Find recent posts about a brand across the social platforms and the web, with a summary of what they say.

Price per run: 50 credits.

`GET /v1/prism/brand-mentions` (50 credits). [Endpoint page](/platforms/prism/brand-mentions)

date_from is the first day of the window, as YYYY-MM-DD.

```bash
curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/prism/brand-mentions?keyword=socialcrawl&date_from={start_date}&include=digest"
```

## What people say under a post

Read the comments on a post and see which are questions, complaints or buyers, without judging them yourself.

Price per run: 1 credit.

`GET /v1/tiktok/post/comments` (1 credit). [Endpoint page](/platforms/tiktok/post-comments)

```bash
curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/tiktok/post/comments?url=https%3A%2F%2Fwww.tiktok.com%2F%40stoolpresidente%2Fvideo%2F7623818255903329566&label=question%2Ccomplaint%2Cpurchase_intent"
```

## Mine comments for buyers

Collect every comment on a post, replies included, and keep the ones that show buying intent.

Price per run: 60 credits.

`GET /v1/prism/comments` (60 credits). [Endpoint page](/platforms/prism/comments)

The first 100 comments of each call carry computed.labels.purchase_intent, judged by default at no extra credits.

```bash
curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/prism/comments?url=https%3A%2F%2Fwww.tiktok.com%2F%40stoolpresidente%2Fvideo%2F7623818255903329566"
```

## Profile, posts and comments for one creator

Get a creator's profile, their recent posts, and the comments on one of those posts.

Price per run: 3 credits.

Step 1: `GET /v1/tiktok/profile` (1 credit). [Endpoint page](/platforms/tiktok/profile)

```bash
curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/tiktok/profile?handle=charlidamelio"
```

Step 2: `GET /v1/tiktok/profile/videos` (1 credit). [Endpoint page](/platforms/tiktok/profile-videos)

Each row's url feeds the comments call.

```bash
curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/tiktok/profile/videos?handle=charlidamelio"
```

Step 3: `GET /v1/tiktok/post/comments` (1 credit). [Endpoint page](/platforms/tiktok/post-comments)

```bash
curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/tiktok/post/comments?url={url}"
```

## One creator on every platform

See the same creator's profiles on TikTok, Instagram, YouTube and X in one call.

Price per run: 5 credits.

`GET /v1/prism/creator-card` (5 credits). [Endpoint page](/platforms/prism/creator-card)

```bash
curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/prism/creator-card?handle=mrbeast&platforms=tiktok%2Cinstagram%2Cyoutube%2Ctwitter"
```

## Track a creator daily

Poll a creator's new posts every day and pay only for the pages with posts you do not have yet.

Price per run: 1 credit.

`GET /v1/instagram/profile/posts` (1 credit). [Endpoint page](/platforms/instagram/profile-posts)

since is the date of your previous run, as YYYY-MM-DD; leave it out on the first run.

```bash
curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/instagram/profile/posts?handle=instagram&since={last_run_date}"
```

## Find creators in a niche

Find creators who post about a topic, filtered by platform and audience size.

Price per run: 10 credits.

`GET /v1/search/creators` (10 credits). [Endpoint page](/platforms/search/creators)

```bash
curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/search/creators?query=skincare+routine&sources=tiktok%2Cinstagram&min_followers=50000"
```

## Vet a creator

Check a creator before a partnership: audience, engagement and brand-safety signals in one call.

Price per run: 50 credits.

`GET /v1/prism/creator-vet` (50 credits). [Endpoint page](/platforms/prism/creator-vet)

```bash
curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/prism/creator-vet?handle=mkbhd&platform=youtube"
```

## Search a topic on several platforms

Run one search on TikTok, Instagram and YouTube at once and keep only the posts that are about it.

Price per run: 3 credits.

`GET /v1/search/multi` (3 credits). [Endpoint page](/platforms/search/multi)

```bash
curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/search/multi?query=matcha+latte&platforms=tiktok%2Cinstagram%2Cyoutube&relevance=filter"
```

## Find posts from people ready to buy

Search discussions for a product category and mark the posts where someone is looking to buy.

Price per run: 1 credit.

`GET /v1/reddit/search` (1 credit). [Endpoint page](/platforms/reddit/search)

```bash
curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/reddit/search?query=best+crm+for+startups&label=intent&relevance=filter"
```

## Transcribe a video

Get the full transcript of a video to search, summarise or quote it.

Price per run: 3 credits.

`GET /v1/youtube/video/transcript` (3 credits). [Endpoint page](/platforms/youtube/video-transcript)

```bash
curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/youtube/video/transcript?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ"
```

## See a competitor's ads

List the ads a company is running, from the public ad library.

Price per run: 5 credits.

`GET /v1/facebook/adlibrary/search/ads` (5 credits). [Endpoint page](/platforms/facebook/adlibrary-search-ads)

```bash
curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/facebook/adlibrary/search/ads?query=artificial+intelligence"
```

## What buyers say about a product

Read a product's reviews with the issue each one raises and its sentiment already judged.

Price per run: 5 credits.

`GET /v1/amazon/reviews` (5 credits). [Endpoint page](/platforms/amazon/reviews)

```bash
curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/amazon/reviews?asin=B0BTYCRJSS&country=US&label=issue"
```

## Next steps

- [Quickstart](/docs/quickstart.md): Get a key and make your first call.
- [Which endpoint should I use?](/docs/choosing-endpoints.md): Side-by-side tables for the endpoints that look alike.
- [Recipes](/docs/recipes.md): Working builds that chain several calls together.
- [Labels](/docs/labels.md): The free judgments on comments, posts, reviews and search results.