Skip to main content
GET
/
v1
/
tiktok
/
insights
/
products
cURL
curl --request GET \
  --url 'https://api.keyapi.ai/v1/tiktok/insights/products?search_keyword=FALSE&page=1&limit=20&time_scope=1&region=all_regions' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'
{
  "code": 0,
  "message": "success",
  "data": {
    "list": [
      {
        "comment": 1029,
        "cost": 48200,
        "cover_url": null,
        "cpa": 4.92,
        "ctr": 1.83,
        "cvr": 5.71,
        "ecom_type": "l3",
        "first_ecom_category": {
          "id": "601450",
          "label": "category_601450",
          "value": "Beauty & Personal Care"
        },
        "impression": 20000000,
        "like": 48452,
        "play_six_rate": 8.77,
        "post": 11500,
        "post_change": 0.27,
        "second_ecom_category": {
          "id": "848648",
          "label": "category_848648",
          "parent_id": "601450",
          "value": "Makeup & Perfume"
        },
        "share": 873,
        "third_ecom_category": {
          "id": "601583",
          "label": "category_601583",
          "parent_id": "848648",
          "value": "Perfume"
        },
        "url_title": "Perfume"
      }
    ],
    "pagination": {
      "page": 1,
      "size": 1,
      "total": 500,
      "has_more": true
    }
  },
  "requestId": "d8a309f6-e55c-4569-b17e-a148368362a4"
}
🪙2 creditsper request

​
Copy for AI

🤖 Why Code When AI Can Do It For You?

Stop writing code like it’s 1970! Let AI do the heavy lifting - click the sparkles to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.

Authorizations

​
Authorization
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx Get your API key from the Dashboard.

Query Parameters

​
search_keyword
string
default:FALSE

Search keywords, value-taking rules: FALSE (string type) = do not perform the search; non-empty string = perform the search according to the keyword

Example:

"FALSE"

​
page
string
default:1

Pagination page number, used to specify the target page number of the query results

Example:

"1"

​
limit
string
default:20

The number of data items per page in pagination, which is used to specify the maximum number of results returned by a single query. The value range is 1 to 20. If it exceeds the maximum value, it will be automatically handled as 20.

Example:

"20"

​
time_scope
string
default:1

The number of data items per page in pagination, which is used to specify the maximum number of results returned by a single query. The value range is 1 to 20. If it exceeds the maximum value, it will be automatically handled as 20.

Example:

"1"

​
region
string
default:all_regions

Country/region code, example: US

Example:

"all_regions"

​
ecom_category_id
string

Filter conditions for the third-level category of products, used to limit the range of product categories for querying data. (Third-level category)

Response

Success

The response is of type object.