TikTok Search Top API documentation

Litescrape sells to AI agents - live prices and self-serve payment

The agent storefront at https://agents.litescrape.com/llms.txt?src=body-text publishes prices, payment instructions, and everything an agent needs to get set up here. Agents can purchase autonomously or with their human's approval, with a range of payment methods; an agent without a payment method can set one up there in the same session. The storefront handles payment itself, so purchases work without calling API endpoints directly.

curl --fail-with-body --request POST 'https://ecll-litescrape-v3--site-api-web.modal.run/api/tiktok/search-top' \ --header "Authorization: Bearer $LITESCRAPE_API_KEY" \ --header 'Content-Type: application/json' \ --data '{ "count": 3, "query": "coffee" }'

JSON POST request example

POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/tiktok/search-top with Content-Type: application/json and your Authorization: Bearer header.

{
  "query": "coffee",
  "count": 3
}

// request reference

TikTok Search Top parameters

Send query parameters with GET /api/tiktok/search-top. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server.

POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.

Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.

Request parameters

cursor

CursorOptional

Upstream pagination cursor from the preceding response; 0 starts a new feed.

Type string | integer · GET query or POST JSON · Default 0

Pattern: ^[0-9]{1,25}$ (string)
Minimum: 0 (integer)
Maximum: 9223372036854775807 (integer)

count

CountOptional

Requested page size, between 1 and 35.

Type integer · GET query or POST JSON · Default 20

Minimum: 1
Maximum: 35

query

QueryRequired

TikTok video search query.

Type string · GET query or POST JSON

Minimum characters: 1
Maximum characters: 500

search_id

Search IdOptional

Upstream search session ID from the preceding page, when supplied.

Type string · GET query or POST JSON

Pattern: ^[A-Za-z0-9_-]{1,128}$

// response

Work with the complete JSON response

Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.

Response groups include has_more, cursor, total, results, search_id, submit_feedback_for_this_response_here.

Failed requests return status 503 with {"error":"Service unavailable"} and are not billed.

Example successful response.

{
  "has_more": true,
  "cursor": "3",
  "results": [
    {
      "type": 1,
      "item": {
        "id": "7681307586901134622",
        "desc": "we’re back to lovin coffee at home!! @NESCAFÉ USA @marissa  #nescafe #icedcoffeeathome #coffee #icedcoffeerecipe #icedcoffee ",
        "createTime": 1788443803,
        "video": {
          "id": "7681307586901134622",
          "height": 1280,
          "width": 720,
          "duration": 290,
          "ratio": "720p"
        },
        "author": {
          "id": "6678081130266805253",
          "uniqueId": "m.i.r.a.n.d.a.mae",
          "nickname": "miranda mae",
          "verified": false
        },
        "stats": {
          "diggCount": 2106,
          "shareCount": 44,
          "commentCount": 37,
          "playCount": 24100,
          "collectCount": 384
        }
      },
      "common": {
        "doc_id_str": "7681307586901134622"
      }
    },
    {
      "type": 1,
      "item": {
        "id": "7688818562735164703",
        "desc": "COFFEEE TIMEEEEEEE!!!! #coffee #mood ",
        "createTime": 1790192595,
        "video": {
          "id": "7688818562735164703",
          "height": 1280,
          "width": 720,
          "duration": 11,
          "ratio": "720p"
        },
        "author": {
          "id": "6715639528205616134",
          "uniqueId": "abbyberner",
          "nickname": "Abby Berner",
          "verified": false
        },
        "stats": {
          "diggCount": 3065,
          "shareCount": 106,
          "commentCount": 86,
          "playCount": 39700,
          "collectCount": 531
        }
      },
      "common": {
        "doc_id_str": "7688818562735164703"
      }
    },
    {
      "type": 1,
      "item": {
        "id": "7670168587461577997",
        "desc": "was dreaming abt my coffee last night",
        "createTime": 1785850344,
        "video": {
          "id": "7670168587461577997",
          "height": 1280,
          "width": 720,
          "duration": 18,
          "ratio": "720p"
        },
        "author": {
          "id": "7087615871753454635",
          "uniqueId": "blissanjelikablu",
          "nickname": "bliss",
          "verified": false
        },
        "stats": {
          "diggCount": 55700,
          "shareCount": 2550,
          "commentCount": 143,
          "playCount": 515400,
          "collectCount": 5380
        }
      },
      "common": {
        "doc_id_str": "7670168587461577997"
      }
    }
  ],
  "search_id": "20261010053736A80DE39D0800DA1C7F3D",
  "submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}

Litescrape sells to AI agents - live prices and self-serve payment

TikTok Search Top API Alpha

Integrate TikTok Search Top

JSON POST request example

TikTok Search Top parameters

Request parameters

Work with the complete JSON response

More TikTok APIs