TikTok Ads Library

engine=tiktok_ads_library

Returns TikTok results as structured JSON, from the same endpoint every engine answers on.

Request

GET

Params

Send this parameter	Key	Value	Description
Authorization
	api_keyrequired		SearchApi.io API key; alternatively send 'Authorization: Bearer <key>'. This is the author's own SearchApi key, left here on purpose so you can run this page for real without signing up. Replace it with yours to run against your own account — whichever key is in this row is the one Run live spends credits on, and the one the address above and every code sample carry, so a key pasted here also travels in a link you share. Run, beside it, answers from a recording and spends nothing.
	api_key_preset	default	Which demo key to send. The working key resolves the recorded sample; the other two resolve the recorded 401 and 429 envelopes, so the path to an error state is the caller's real path.
Targeting Only what you set is sent. Sending the API its own defaults back would ship a dozen parameters you never chose and bury the ones you did.
	region		Region the ads were shown in.
Pagination
	next_page_token		Opaque token from the previous response that fetches the next page.
More Everything else this engine accepts, in the catalog's order.
	q		Search query; most engines accept native operators and advanced filters.
	ad_published_time		Recency filter of the ads.

JSON

Nothing has been run yet. Send the request to see the recorded response.

Run answers from a recording served from disk. To call the API for real, paste your own key into the live run below.

Code

cURL

curl "https://www.searchapi.io/api/v1/search?engine=tiktok_ads_library&api_key=E5oa7LbhkKN7YUyj4CwXppK8"

Only required parameters and parameters you set are sent — the request never repeats the API's own defaults back at it.

Use from an agent

Every engine in the catalog is reachable from an agent you already have open. Connect it once, then ask in words.

Connect

claude mcp add searchapi "<YOUR_MCP_URL>" --transport http

Create your MCP URL at https://www.searchapi.io/integrations/mcp and paste it over the placeholder. The connect flow is OAuth, so your API key never enters your client's config.

Ask

Using SearchApi's TikTok Ads Library engine, run a search and summarise the results.

Follows the request above — change a parameter and this changes with it.

Call

Both describe the request the form above builds.

SearchApi's MCP server was read on 2026-08-11: remote over Streamable HTTP, 80+ tools, OAuth connect. Which engines its tool list covers was not verified here.

Parameters

4 parameters, read from the catalog at render time.

Parameters accepted by the tiktok_ads_library engine
Parameter	Type	Description
q	string	Search query; most engines accept native operators and advanced filters.
region	string	Region the ads were shown in.
ad_published_time	string	Recency filter of the ads.
next_page_token	string	Opaque token from the previous response that fetches the next page.

Every request also carries

Three parameters are on every engine in the catalog: the engine being called, the key that authenticates the call, and the enterprise retention switch.

Parameters common to every engine
Parameter	Type	Description
enginerequired	string	Engine that retrieves the data; fixed per API (see Apis::BY_ENGINE keys).
api_keyrequired	string	SearchApi.io API key; alternatively send 'Authorization: Bearer <key>'.
zero_retention	boolean	Enterprise-only: disables all logging and persistent storage of the search. default: false