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

> Searches TikTok for videos under a specific hashtag. Returns matching videos with engagement metrics and author info.

TL;DR: `GET /v1/tiktok/search/hashtag` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `hashtag` | yes | Hashtag to search for without the # symbol |
| `region` | no | Region the proxy will be set to. Note: this isn't going to grab you all tiktoks from this region, you're just setting the proxy there. |
| `cursor` | no | Cursor to get more videos. Get 'cursor' from previous response. |
| `trim` | no | Set to true to get a trimmed response |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/tiktok/search/hashtag?hashtag=fyp" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I search TikTok by hashtag with an API?

Send a GET request to /v1/tiktok/search/hashtag with the hashtag parameter (no # symbol). SocialCrawl returns a paginated list of videos under that hashtag with view, like, comment, and share counts plus author info.

### Do I include the # symbol in the hashtag parameter?

No. Pass the hashtag text without the # symbol — for example, hashtag=fyp or hashtag=cooking. The endpoint escapes and formats the tag correctly on the upstream side.

### How do I paginate through all videos for a hashtag?

Read the cursor field from the response and pass it as the cursor parameter on the next request. Repeat until cursor is 0 or empty to collect every public video under the hashtag.

### Does region filter results to a country?

No. The region parameter routes the proxy through a specific country to access region-available content. It does not filter the hashtag's videos to creators based in that country.

### How much does the TikTok Hashtag API cost?

Each request costs 1 credit on the standard tier regardless of how many videos are returned in the page. New accounts get 100 free credits with no credit card required.

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:

- How to search TikTok by hashtag with the SocialCrawl API
- What does the SocialCrawl TikTok Hashtag endpoint return?