objectivebody · integer
Ad objective (optional; 1: 2: 3: 4: 5: 6: 7:)
POST$0.0013 per request · $1.30 per 1,000 requests
Search ads
Search ads
Endpoint
POST https://getvibeapi.com/v1/social/tiktok/ads/search_adsExample
curl -sS "https://getvibeapi.com/v1/social/tiktok/ads/search_ads" \
-H "Authorization: Bearer $GETVIBE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary '{}'Send your key in the Authorization: Bearer header. You pay only for requests the data provider accepts. Requests it rejects (errors, timeouts, invalid parameters) are not billed. A valid request that returns an empty or not-found result from the platform is billed.
Parameters
likebody · integer
Performance rank (optional; 1:1-20% 2:21-40% 3:41-60% 4:61-80% 5:81-100%)
periodbody · integer
Time period (days)
industrybody · string
Industry ID
keywordbody · string
Search keyword
pagebody · integer
Page number
limitbody · integer
Items per page
order_bybody · string
Sort by (for_you, likes)
country_codebody · string
Country code
ad_formatbody · integer
Ad format (optional; 1:Spark Ads 2:Non-Spark Ads)
ad_languagebody · string
Ad language (optional)
durationbody · integer
Video duration filter value (optional)
pattern_labelbody · string
Creative pattern label (optional)
search_idbody · string
Search ID (optional)
cookiebody · string
Cookie
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| objective | body | integer | No | Ad objective (optional; 1: 2: 3: 4: 5: 6: 7:) |
| like | body | integer | No | Performance rank (optional; 1:1-20% 2:21-40% 3:41-60% 4:61-80% 5:81-100%) |
| period | body | integer | No | Time period (days) |
| industry | body | string | No | Industry ID |
| keyword | body | string | No | Search keyword |
| page | body | integer | No | Page number |
| limit | body | integer | No | Items per page |
| order_by | body | string | No | Sort by (for_you, likes) |
| country_code | body | string | No | Country code |
| ad_format | body | integer | No | Ad format (optional; 1:Spark Ads 2:Non-Spark Ads) |
| ad_language | body | string | No | Ad language (optional) |
| duration | body | integer | No | Video duration filter value (optional) |
| pattern_label | body | string | No | Creative pattern label (optional) |
| search_id | body | string | No | Search ID (optional) |
| cookie | body | string | No | Cookie |