Ads
Ads search API
Search a public ad library: Meta, Google, TikTok, LinkedIn, Microsoft or Pinterest. Call the Ads search API for JSON. 2 credits per call.
POST
Search a public ad library: Meta, Google, TikTok, LinkedIn, Microsoft or Pinterest
- Endpoint:
ads.search - Returns:
datahasresults,totalMin,totalMax,advertiserId,advertiserName,total. - Cost: 2 credits per call. Failed calls cost nothing.
- Paging: Yes. Send the
cursorfrom the response to get the next page. See Page through results.
Example
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
Required string length:
1 - 200Allowed value:
"meta"ISO 3166-1 alpha-2 country code, or all. Any case is accepted.
Pattern:
^(?:[A-Za-z]{2}|[Aa][Ll][Ll])$Available options:
active, inactive, all Pattern:
^(?:\d{1,4}~(?:[\w-]{10,500})?|(?:[\w-]{10,500}))$Return at most this many results from the page. The price stays the same.
Required range:
1 <= x <= 100