# TikTok — Video search

Search YouTube for videos matching a query HTML version: https://www.socialrouter.io/services/tiktok/video.search

## Call it

```
POST https://api.socialrouter.io/v1/extract/tiktok/video.search
Authorization: Bearer <your API key>
Content-Type: application/json

{ "queries": ["ballon dor"] }
```

The response shape does not depend on which offer ran; `served_by` names the one that did.

## Input

- `Free-text search query, as you would type it in the TikTok search bar` — Results come back in TikTok's own relevance order, NOT newest-first — sort on `date_posted` if recency matters.. Example: `ballon dor`

## Options

- `country` (string) — Two-letter country code for the location the search runs from, e.g. "FR". TikTok tailors search results to the viewer, so this is what scopes a query to one market.
- `postsToNotInclude` (string) — Comma-separated post ids to skip. Feed back the ids already collected so a repeated search is not billed for the same videos twice.

## Offers, in failover order

1. `brightdata/tiktok` — $0.0017 per record, up to 100 inputs per call

## See also

- Catalogue as JSON: https://api.socialrouter.io/v1/services
- OpenAPI 3.1 spec: https://api.socialrouter.io/v1/openapi.json
- Agent overview: https://www.socialrouter.io/llms.txt
- Sitemap: https://www.socialrouter.io/sitemap.xml
- Docs: https://docs.socialrouter.io