# TikTok Search Mentions API (https://www.socialcrawl.dev/platforms/tiktok/search-mentions)

> Returns TikTok videos by other accounts that mention an account. TikTok has no mentions feed, so each call runs /v1/tiktok/search for `@handle` and for the bare handle and keeps a video only when TikTok links the mention to that account (TikTok often shows a linked mention as the account's display name, so the account id is checked, not just the text), the caption carries the @handle, or it links the profile. The account's own videos are left out unless `include_self=true`, and a video found by both searches appears once. Each row in `data.items` is exactly the row the named search endpoint returns, with its `post` and `computed` blocks, plus `match_kind` (`mention` or `link`). Each row's `post.ext.mentioned_user_ids` lists the accounts TikTok links in it. `since` and `until` keep only rows published inside the window. Send `data.next_cursor` back as `cursor` for the next page; it is null when every search has run out. `data.legs` reports each search: its endpoint, status, rows returned and kept, credits and `request_id`. `data.excluded` counts the rows left out (`unmatched`, `self`, `duplicate`, `outside_window`). Each call is one page of each search, 1 credit each, so at most 2.

TL;DR: `GET /v1/tiktok/search/mentions` costs Metered, 0-2 credits: each call reads one page of /v1/tiktok/search (1 credit) and /v1/tiktok/search (1 credit), each billed at that endpoint's own price exactly as a direct call is. A page that found nothing or failed costs nothing, and a page served from cache is free. A page is billed when it returned rows, even if none of them carried the mention; data.legs shows each page's charge and data.excluded what was left out. and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `handle` | yes | The account's username, with or without the @, or its profile URL. |
| `cursor` | no | data.next_cursor from the previous response, sent back verbatim for the next page. |
| `since` | no | Only posts published on or after this date, YYYY-MM-DD (UTC). |
| `until` | no | Only posts published on or before this date, YYYY-MM-DD (UTC); that whole day is included. |
| `include_self` | no | When true, also keep posts by the account itself. Default false. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/tiktok/search/mentions" \
  --data-urlencode "handle=nike" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What does the TikTok Search Mentions API return?

Returns TikTok videos by other accounts that mention an account, matched on the account TikTok links as well as the caption, without its own videos. 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 TikTok Search Mentions endpoint?

Use it to track mentions of a creator or brand on TikTok, which has no mentions feed; since/until keep rows inside a date window and the cursor pages on.

### How much does the TikTok Search Mentions API cost?

The price depends on the request, from 0 to 2 credits per call. Every new account gets 100 free credits. Credits for failed or empty calls are refunded automatically, and there is no subscription.

### What parameters does the TikTok Search Mentions API need?

The one required parameter is handle (the account's username, with or without the @, or its profile URL). It also accepts 4 optional parameters, all listed on this page.

### How do I call the TikTok Search Mentions API?

Send a GET request to https://www.socialcrawl.dev/v1/tiktok/search/mentions?handle=nike with your API key in the x-api-key header. An Authorization: Bearer header works too.

See the full TikTok API: https://www.socialcrawl.dev/platforms/tiktok

## 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 TikTok Search Mentions API return?
- How do I get TikTok Search Mentions data with the SocialCrawl API?