# 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` | 2 to 120 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/prism/creators` | 0 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` | 0 to 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 |
| [Monthly brand reaction](#monthly-brand-reaction) | `GET /v1/prism/discover` | 0 to 150 credits |
| [Find the accounts behind a topic](#accounts-behind-a-topic) | `GET /v1/prism/discover` | 0 to 400 credits |

## Watch a brand

Find recent mentions of a brand on news sites, blogs and forums across 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. To watch a brand across social platforms instead, with every post inside your dates, judged against your question and de-duplicated, send brands and period to prism/discover, and add a schedule to a POST to repeat it on its own (guide: /docs/prism/discover).

```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 up to 1,000 comments on a post, with replies on the top 100, and keep the ones that show buying intent.

Price per run: 2 to 120 credits.

`GET /v1/prism/comments` (2 to 120 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, stopping at the date of your last run so each poll pays only for the pages it reads.

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 or influencers who post about a topic, filtered by platform, market and size, each measured from its recent posts and ranked with its reasons.

Price per run: 0 credits.

`GET /v1/prism/creators` (0 credits). [Endpoint page](/platforms/prism/creators)

```bash
curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/prism/creators?keywords=skincare+routine&platforms=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: 0 to 3 credits.

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

search/multi is one quick pass. For a date window with every post judged against your question and de-duplicated across platforms, or a topic you want to watch on a recurring schedule, use prism/discover (guide: /docs/prism/discover).

```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"
```

## Monthly brand reaction

See how people reacted to a brand and its competitors over last month, across the social platforms and the news, judged and de-duplicated in one run.

Price per run: 0 to 150 credits.

`GET /v1/prism/discover` (0 to 150 credits). [Endpoint page](/platforms/prism/discover)

A 202 answer keeps running in the background: wait on data.next.status_url and read every row at data.next.results_url.

```bash
curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/prism/discover?brands=aruba%2Ccuracao%2Cbonaire&period=last_month&exclude_terms=networks&max_credits=150"
```

## Find the accounts behind a topic

Find the public accounts (sellers, creators, pages and channels) whose posts match a topic, each with its profile and the posts that matched.

Price per run: 0 to 400 credits.

`GET /v1/prism/discover` (0 to 400 credits). [Endpoint page](/platforms/prism/discover)

Topic words go in keywords and the user's question in context; role=seller,reseller keeps only sellers.

```bash
curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/prism/discover?keywords=replica+rolex+dubai%2Cfake+watches+uae&context=accounts+selling+counterfeit+luxury+watches+in+the+UAE&view=accounts&period=90d&max_credits=400"
```

## 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.