All systems normalDashboardGet an API key
API reference / Feeds, search & Tako AI / Vision search

Vision search

Reverse image search across Shop products and matching videos.

POSTapi.tikultra.com/v1/vision/ecom-searchPremium · 25 credits
Upstream
/aweme/v1/search/photo/bff/ecom//aweme/v1/search/vision/general/
Access
Every planExclusive
Runs on
LeanPool · android · tiktok · 47.6.3
Client
os, app_flavour, app_version overrides
Billing
Failed calls are free
Older path
/v1/scrape/search/vision/v1/scrape/ecom/photo-search

Authorization

x-api-keyheader · stringrequired

Your API key. Create one in API keys.

Body

Send JSON with content-type: application/json.

image_urlstringimage_url or image_base64

A public URL of the image. For example https://example.com/product.jpg.

image_base64stringimage_url or image_base64

The image as base64 instead of a URL.

modestring

both, ecom or videos. One of both, ecom, videos.

regionstring

Two-letter country code for egress and storefront. For example US.

Client and egress overrides

Optional. Leave them out to run as android · tiktok · 47.6.3 from the default pool. See Clients and versions.

osstring

android or ios. For example android.

app_flavourstring

Run as tiktok, lite, lite_coin, pro, studio, shop, tv, douyin. For example tiktok.

app_versionstring

A release of that app. Defaults to the current default for (os, app_flavour). For example 47.6.3.

regionstring

Two-letter country code for egress. For example US.

citystring

A supported city in that region. For example miami.

Response

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining.

Errors

Errors return a JSON body with a stable code and cost 0 credits. See Errors and retries.