---
title: "Search by Keyword"
method: GET
path: "/v1/scrape/tiktok/search/keyword"
tags: ["tiktok"]
---

# Search by Keyword

`GET /v1/scrape/tiktok/search/keyword`

## Request

- Base URL: `https://api.sociavault.com`
- URL: `https://api.sociavault.com/v1/scrape/tiktok/search/keyword`
- Auth: API key in header `X-API-Key`

Scrapes TikTok videos matching a keyword

## Query parameters

- `query` string, required
- `date_posted` 'yesterday' | 'this-week' | 'this-month' | 'last-3-months' | 'last-6-months' | 'all-time'
- `sort_by` 'relevance' | 'most-liked' | 'date-posted'
- `region` string
- `cursor` integer
- `trim` boolean

## Response `200`

Successful response

**Key Response Fields:**
- `search_item_list[0].aweme_info.video.bit_rate[0].play_addr.url_list[0]`: The URL of the video

## Other responses

- `400`: Bad Request - Invalid parameters or missing required fields
- `401`: Unauthorized - Invalid or missing API key
- `402`: Payment Required - Insufficient credits
- `500`: Internal Server Error - Service configuration or processing error

---

[API](https://skmtc.dev/sociavault/apis/sociavault-api.md) · [All operations](https://skmtc.dev/sociavault/apis/sociavault-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sociavault/apis/sociavault-api/revisions/0a430c97f53a?raw)