Endpoint Playground
Test Crawlora's Retrieve TikTok Top Ads interactive time analysis API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.
curl "https://api.crawlora.net/api/v1/tiktok/top-ads/analysis?material_id=sample-material-id&metric=retain_ctr&period_type=7" \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| material_id | string | Yes | sample-material-id | Top Ads material id |
| metric | string | No | retain_ctr | Interactive time analysis metric |
| period_type | integer | No | 7 | Percentile lookback period in days |
{
"code": 200,
"msg": "OK",
"data": {
"code": 0,
"msg": "OK",
"data": {
"metric": "retain_cvr",
"metric_label": "CVR",
"percentile_metric": "time_attr_conversion_rate_percentile",
"period_type": 7,
"analysis": [
{
"second": 0,
"value": 0.12
}
],
"duration": 30,
"highlight": [
3,
8,
15
],
"percentile": 0.81
}
}
}Public Playground
Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.
Returns the detail-page interactive time analysis chart and percentile for a Top Ads material. Metric values are `retain_ctr` (CTR), `retain_cvr` (CVR), `click_cnt` (Clicks), `convert_cnt` (Conversion), and `play_retain_cnt` (Remain).
{
"code": 200,
"msg": "OK",
"data": {
"code": 0,
"msg": "OK",
"data": {
"metric": "retain_cvr",
"metric_label": "CVR",
"percentile_metric": "time_attr_conversion_rate_percentile",
"period_type": 7,
"analysis": [
{
"second": 0,
"value": 0.12
}
],
"duration": 30,
"highlight": [
3,
8,
15
],
"percentile": 0.81
}
}
}curl "https://api.crawlora.net/api/v1/tiktok/top-ads/analysis?material_id=<material_id>" \
-H "x-api-key: $CRAWLORA_API_KEY"