Skip to main content
POST
Search a public ad library: Meta, Google, TikTok, LinkedIn, Microsoft or Pinterest
  • Endpoint: ads.search
  • Returns: data has results, totalMin, totalMax, advertiserId, advertiserName, total.
  • Cost: 2 credits per call. Failed calls cost nothing.
  • Paging: Yes. Send the cursor from the response to get the next page. See Page through results.

Example

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
query
string
required
Required string length: 1 - 200
network
string
required
Allowed value: "meta"
country
string
default:us

ISO 3166-1 alpha-2 country code, or all. Any case is accepted.

Pattern: ^(?:[A-Za-z]{2}|[Aa][Ll][Ll])$
status
enum<string>
default:active
Available options:
active,
inactive,
all
cursor
string
Pattern: ^(?:\d{1,4}~(?:[\w-]{10,500})?|(?:[\w-]{10,500}))$
limit
integer

Return at most this many results from the page. The price stays the same.

Required range: 1 <= x <= 100

Response

The data, and the credits this call used.

success
any
required
data
object
required
creditsUsed
integer
required
requestId
string
required