> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.yoinkit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Search by Keyword

> Pulls TikTok videos matching a keyword

## Parameters

<ParamField query="query" type="string" required>
  Keyword to search for (e.g., `funny`)
</ParamField>

<ParamField query="date_posted" type="string">
  Time Frame (e.g., `all-time`) Available options: `yesterday`, `this-week`, `this-month`, `last-3-months`, `last-6-months`, `all-time`
</ParamField>

<ParamField query="sort_by" type="string">
  Sort by Available options: `relevance`, `like_count`, `date_posted`
</ParamField>

<ParamField query="cursor" type="integer">
  Cursor to get more videos. Get 'cursor' from previous response. (e.g., `12`)
</ParamField>

<ParamField query="region" type="string">
  Region the proxy will be set to. (e.g., `US`)
</ParamField>

<ParamField query="trim" type="boolean">
  Set to true to get a trimmed response (e.g., `false`)
</ParamField>

## Example Request

```bash theme={null}
curl -X GET "https://yoinkit.ai/api/v1/openclaw/tiktok/search?query=funny" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

## Example Response

```json theme={null}
{
  "success": true,
  "data": {
    "cursor": 12,
    "search_item_list": [
      {
        "aweme_info": {
          "desc": "...",
          "statistics": {
            "digg_count": 123,
            "comment_count": 45,
            "play_count": 67890
          },
          "video": {
            "bit_rate": [
              {
                "play_addr": {
                  "url_list": [
                    "..."
                  ]
                }
              }
            ]
          }
        }
      }
    ]
  },
  "meta": {
    "platform": "tiktok",
    "endpoint": "search",
    "request_id": "req_abc123"
  }
}
```

> Response data is returned directly from the Yoinkit API.

## Note

Rates and quotas may apply based on your Yoinkit subscription.