Skip to main content
GET
/
api
/
v1
/
search
General search (top results across all types)
curl --request GET \
  --url https://full-tiktok-api.p.rapidapi.com/api/v1/search \
  --header 'x-rapidapi-key: <api-key>'
{
  "meta": {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2025-03-12T14:32:01.498Z",
    "cached": false,
    "version": "2025-01"
  },
  "data": [
    {
      "post_id": "7351234567890123456",
      "caption": "do this for a week and see what happens #fitness",
      "created_at": 1711929600,
      "is_ad": false,
      "plays": 42000000,
      "likes": 3100000,
      "comments": 18000,
      "shares": 92000,
      "saves": 410000,
      "reposts": 5200,
      "cover_url": "https://p16-sign.tiktokcdn-us.com/...",
      "share_url": "https://www.tiktok.com/@charlidamelio/video/7351234567890123456",
      "sound_id": "7016547803243022337",
      "sound_title": "original sound",
      "sound_author": "charlidamelio",
      "sound_is_original": true,
      "hashtags": [
        {
          "id": "229207",
          "name": "fitness"
        }
      ],
      "author_username": "charlidamelio",
      "author_display_name": "charli d'amelio",
      "author_verified": true,
      "author_avatar_url": "https://p16-sign.tiktokcdn-us.com/...",
      "duration_seconds": 27,
      "video_height": 1024,
      "video_width": 576
    }
  ],
  "pagination": {
    "cursor": "1778971238000",
    "has_more": true
  },
  "error": {
    "code": "NOT_FOUND",
    "message": "The requested resource was not found.",
    "details": null
  }
}
Returns top-ranked posts matching the keyword across all content types. This mirrors TikTok’s general search tab. Use ?q= as an alias for ?keyword=.

Authorizations

x-rapidapi-key
string
header
required

Your RapidAPI subscription key. Injected automatically by the RapidAPI gateway in production.

Query Parameters

keyword
string
required

Search term. Also accepted as ?q=

cursor
string

Opaque base64 pagination token returned by the previous response. Encodes both the offset and the search session ID required by the upstream API.

Response

Success

meta
object

Response metadata present in every API response

data
object[]
pagination
object

Cursor-based pagination info

error
object

Error details. Present only when the request failed; null on success.