> ## 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.

# Top Search

> There is a 'Top' Search in TikTok and this is that. You can get Photo Carousels and Videos. Whereas with just the Keyword Search, you can only get Videos.

## Parameters

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

<ParamField query="publish_time" type="string">
  Time Frame TikTok was posted (e.g., `all-time`)
</ParamField>

## Example Request

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

## Example Response

```json theme={null}
{
  "success": true,
  "data": {
    "aweme_list": [
      {
        "aweme_id": "...",
        "desc": "...",
        "statistics": {
          "digg_count": 123,
          "comment_count": 45,
          "play_count": 67890
        }
      }
    ]
  },
  "meta": {
    "platform": "tiktok",
    "endpoint": "search-top",
    "request_id": "req_abc123"
  }
}
```

> Response data is returned directly from the Yoinkit API.