# Search Douyin videos by keyword

Searches Douyin (TikTok China) videos by keyword with sort, publish-time, duration, and page filters; later pages require the previous search ID.

|  |  |
| --- | --- |
| Tool id | `justoneapi.x-douyin-search-video-v4` |
| Platform | [Douyin](https://www.orcarouter.ai/tools/douyin.md) |
| Capability | [Search posts](https://www.orcarouter.ai/tools/douyin/search-posts.md) |
| Price | $0.016236 per call |
| Health | OK |
| p50 latency | — |
| Success (7 days) | — |
| Runs (30 days) | — |
| Idempotent | yes |
| Data class | scraped |

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `keyword` | string | yes | The search keyword. |
| `duration` | string | no | Filter by video duration. Available Values: - \`\_0\`: No Limit - \`\_1\`: Under 1 Minute - \`\_2\`: 1-5 Minutes - \`\_3\`: Over 5 Minutes One of: \_0, \_1, \_2, \_3. |
| `page` | integer | no | Page number (starting from 1). |
| `publishTime` | string | no | Filter by video publish time range. Available Values: - \`\_0\`: No Limit - \`\_1\`: Last 24 Hours - \`\_7\`: Last 7 Days - \`\_180\`: Last 6 Months One of: \_0, \_1, \_7, \_180. |
| `searchId` | string | no | Search ID; required for pages > 1. Use data.business_config.next_page.search_id from the previous response, and stop paging when data.business_config.has_more is 0. |
| `sortType` | string | no | Sorting criteria for search results. Available Values: - \`\_0\`: General - \`\_1\`: More likes - \`\_2\`: Newest One of: \_0, \_1, \_2. |

## Call it

```bash
curl -sS https://api.orcarouter.ai/v1/tools/justoneapi.x-douyin-search-video-v4/run \
  -H "Authorization: Bearer $ORCAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"keyword":"<keyword>"}}'
```

```python
import os, requests

resp = requests.post(
    "https://api.orcarouter.ai/v1/tools/justoneapi.x-douyin-search-video-v4/run",
    headers={"Authorization": f"Bearer {os.environ['ORCAROUTER_API_KEY']}"},
    json={"input":{"keyword":"<keyword>"}},
)
print(resp.json())
```

## Alternatives

| Tool | Source | Price | Health |
| --- | --- | --- | --- |
| [Search Douyin Index reports by keyword and type](https://www.orcarouter.ai/tools/douyin/search-posts/x-douyin-index-fetch-report-search.md) | — | $0.0011 per call | OK |
| [Search Douyin discussions](https://www.orcarouter.ai/tools/douyin/search-posts/x-douyin-search-fetch-discuss-search.md) | — | $0.011 per call | OK |
| [Search Douyin experience posts](https://www.orcarouter.ai/tools/douyin/search-posts/x-douyin-search-fetch-experience-search.md) | — | $0.011 per call | OK |
| [Search Douyin across all content](https://www.orcarouter.ai/tools/douyin/search-posts/x-douyin-search-fetch-general-search-v1.md) | — | $0.011 per call | OK |
| [Search Douyin across all content](https://www.orcarouter.ai/tools/douyin/search-posts/x-douyin-search-fetch-general-search-v2.md) | — | $0.011 per call | OK |
| [Search Douyin images](https://www.orcarouter.ai/tools/douyin/search-posts/x-douyin-search-fetch-image-search.md) | — | $0.011 per call | OK |
| [Search Douyin across multiple types](https://www.orcarouter.ai/tools/douyin/search-posts/x-douyin-search-fetch-multi-search.md) | — | $0.011 per call | OK |
| [Search Douyin music](https://www.orcarouter.ai/tools/douyin/search-posts/x-douyin-search-fetch-music-search.md) | — | $0.011 per call | OK |
| [Search Douyin schools](https://www.orcarouter.ai/tools/douyin/search-posts/x-douyin-search-fetch-school-search.md) | — | $0.011 per call | OK |
| [Search Douyin videos](https://www.orcarouter.ai/tools/douyin/search-posts/x-douyin-search-fetch-video-search-v1.md) | — | $0.011 per call | OK |

Showing the first 10 of 11.

## FAQ

### How much does Search Douyin videos by keyword cost?

Search Douyin videos by keyword costs $0.016236 per call: 1,000 calls cost $16.236.

### What does a $10 budget buy with Search Douyin videos by keyword?

About 615 calls at $0.016236 per call.

### What inputs does Search Douyin videos by keyword need?

Required inputs: keyword.

### How do I call Search Douyin videos by keyword?

Send POST /v1/tools/{id}/run with your OrcaRouter API key and a JSON body {"input": {…}}, where {id} is the tool id POST /v1/tools/discover returns for it.

---

Markdown version of https://www.orcarouter.ai/tools/douyin/search-posts/x-douyin-search-video-v4