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.

← All documentation

// TikTok documentation

TikTok Search Keyword API Alpha

Search public TikTok posts by keyword with pagination and search-session IDs.

GET / POST https://api.litescrape.com/api/tiktok/search-keyword

// from request to code

Integrate TikTok Search Keyword

Build your request and copy it into your stack. Or let your coding agent set it up.

APITikTok Search Keyword
More options 3
Request parameters

Your request updates the code instantly.

Open the Playground →

Set LITESCRAPE_API_KEY on your server, then run this request.

request.sh
curl --fail-with-body --request POST 'https://api.litescrape.com/api/tiktok/search-keyword' \
  --header "Authorization: Bearer $LITESCRAPE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "count": 3,
  "query": "coffee"
}'

Read all parameters →

JSON POST request example

POST to https://api.litescrape.com/api/tiktok/search-keyword with Content-Type: application/json and your Authorization: Bearer header.

POST · application/json
{
  "query": "coffee",
  "count": 3
}

// request reference

TikTok Search Keyword parameters

Send query parameters with GET /api/tiktok/search-keyword. 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, items, search_id, submit_feedback_for_this_response_here.

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

Example successful response.

200 · application/json
{
  "has_more": true,
  "cursor": "3",
  "items": [
    {
      "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
      }
    },
    {
      "id": "7691008417560792333",
      "desc": "Happy national coffee day",
      "createTime": 1790702476,
      "video": {
        "id": "7691008417560792333",
        "height": 1280,
        "width": 720,
        "duration": 10,
        "ratio": "720p"
      },
      "author": {
        "id": "7087615871753454635",
        "uniqueId": "blissanjelikablu",
        "nickname": "bliss",
        "verified": false
      },
      "stats": {
        "diggCount": 11100,
        "shareCount": 145,
        "commentCount": 24,
        "playCount": 155300,
        "collectCount": 350
      }
    },
    {
      "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
      }
    }
  ],
  "search_id": "20261010053735F652DFF1E2F2681F02A4",
  "submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}

More TikTok APIs