TikTok Photo Search API

Look up TikTok photo posts using a search term specified in keyword. Supports pagination controls using offset and search_id.

Use cases

• Discover photo posts related to specific topics or keywords on TikTok.
• Analyze engagement metrics and play counts for trending photo content.
• Inspect author profiles and music metadata linked to search results.

Request

curl -X POST "https://api.sandbase.ai/v1/api/tiktok/web/search-photo" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "openai"}'

Parameters

Example response

Real response for the request above, trimmed to the main fields. User names and long IDs are masked.

{
  "item_list": [
    {
      "CategoryType": 120,
      "createTime": 1790707203,
      "desc": "From personal agents and collaborative work spaces to a new affordable frontier model and…",
      "id": "7691028733624372493",
      "itemCommentStatus": 0,
      "textLanguage": "en",
      "textTranslatable": true,
      "titleLanguage": "un",
      "titleTranslatable": false,
      "author": {
        "id": "7256178298626032683",
        "nickname": "<user>",
        "privateAccount": false,
        "verified": true
      },
      "authorStats": {
        "diggCount": 392,
        "followerCount": 1000000,
        "followingCount": 2,
        "friendCount": 0,
        "heartCount": 6500000,
        "videoCount": 378
      },
      "authorStatsV2": {
        "diggCount": "392",
        "followerCount": "1000000",
        "followingCount": "2",
        "friendCount": "0",
        "heartCount": "6500000",
        "videoCount": "378"
      },
      "music": {
        "authorName": "vowl. & Sace",
        "duration": 60,
        "id": "7145154069236041729",
        "title": "2000"
      },
      "stats": {
        "collectCount": 180,
        "commentCount": 72,
        "diggCount": 1119,
        "playCount": 31700,
        "shareCount": 104
      }
    }
  ]
}

Notes

• Set offset to 0 for initial calls and supply the updated cursor for subsequent pages.
• Leave search_id empty on the first query, then supply the value returned from the previous response.
• The count parameter specifies the number of items per page, with 20 recommended.

Related APIs

• TikTok Video IDs from URLs (Batch): Resolves and extracts TikTok video IDs from a list of video URLs.
• TikTok User Sec User ID Extractor: Returns a list of sec_user_id identifiers corresponding to TikTok user profile URLs.
• TikTok Profile Unique IDs: Resolves a batch of TikTok user homepage links to retrieve their corresponding unique identifiers.