TikTok APIs: All Them APIs endpoint contract

Endpoint and access

Contract preview · access requires enablement

TikTok APIs contract endpoint

POST https://allthemapis.com/api/v1/tiktok/search

This is our proposed customer-facing interface. Provider fulfillment and category-specific keys are not enabled yet. Calls currently return 503 integration_not_enabled; they do not execute a query or spend credits. Existing Search API trial keys do not unlock this category.

Request access for your workload before connecting an application.

Request fields

Proposed request schema
Field	Type	Meaning
query	string, required	Topic or keyword for public-video discovery.
limit	integer, 1-100	Requested maximum, not a guarantee of matching or complete results.
cursor	string, optional	Opaque continuation token; do not reuse it with a different query.
region	string, optional	Requested market context, subject to provider support; not the creator's nationality.

TikTok APIs example request

curl -X POST "https://allthemapis.com/api/v1/tiktok/search" \
  -H "Authorization: Bearer $ALLTHEMAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "coffee brewing",
  "limit": 20,
  "region": "US"
}'

The example defines the contract; it is not a completed API call.

Response fields and errors

Intended response fields after access enablement
Field	Meaning
results[].video_id	TikTok video identifier as a string.
results[].url	Canonical source video URL where available.
results[].creator	Public creator ID and handle; missing fields remain null.
results[].metrics	Observed public counts, not estimated reach or a guarantee of audience quality.
collected_at	Observation timestamp, separate from the video's published time.
next_cursor	Continuation token or null; an empty page is not proof that the platform has no other matching content.

TikTok APIs current unavailable response

{
  "error": {
    "code": "integration_not_enabled",
    "message": "This API requires access enablement. No request has been executed or billed."
  },
  "access_url": "https://allthemapis.com/api-categories/tiktok/api#request-access"
}

No synthetic response is returned as live data. Pricing, production quotas and content-use rights must be confirmed before activation.

Give the contract to your coding agent

This prompt prepares an adapter without treating a fixture as a successful live request.

TikTok APIs agent integration prompt

Prepare an integration for the All Them APIs tiktok apis contract.

Endpoint: POST https://allthemapis.com/api/v1/tiktok/search
Request shape:
{
  "query": "coffee brewing",
  "limit": 20,
  "region": "US"
}

This category requires access enablement and currently returns HTTP 503 integration_not_enabled. Do not execute requests or claim success until access is confirmed.
Read ALLTHEMAPIS_API_KEY from a server-side environment variable only. Never place it in browser code, URLs or logs. Use a bounded timeout, handle 401/429/503 explicitly, and keep null/missing fields distinct from valid zero values. Do not retry indefinitely.
Expected output fields:
- results[].video_id: TikTok video identifier as a string.
- results[].url: Canonical source video URL where available.
- results[].creator: Public creator ID and handle; missing fields remain null.
- results[].metrics: Observed public counts, not estimated reach or a guarantee of audience quality.
- collected_at: Observation timestamp, separate from the video's published time.
- next_cursor: Continuation token or null; an empty page is not proof that the platform has no other matching content.

Build the adapter and unit tests against an explicitly labeled local fixture. Do not fabricate live results. Summarize what access and production verification are still required.

Request access to tiktok APIs

Tell us the coverage and volume you need. We will confirm availability and terms before enabling access. This request does not take a payment or create an API key.