Skip to main content
POST
/
api
/
facebook
/
advertisers
/
search
/facebook/advertisers/search
curl --request POST \
  --url https://api.anysite.io/api/facebook/advertisers/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "query": "<string>",
  "count": 8,
  "timeout": 300,
  "country": "US",
  "ad_type": "all"
}
'
[
  {
    "id": "<string>",
    "@type": "@facebook_advertiser_compact",
    "name": "<string>",
    "alias": "<string>",
    "image": "<string>",
    "category": "<string>",
    "like_count": 123,
    "country": "<string>",
    "page_type": "<string>",
    "is_verified": false,
    "is_deleted": false,
    "ig_username": "<string>",
    "ig_follower_count": 123,
    "ig_is_verified": true
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.anysite.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
query
string
required

Advertiser name to search

Minimum string length: 1
Examples:

"nike"

"tesla"

count
integer
required

Max result count

Required range: 1 <= x <= 15
Example:

10

timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
country
string
default:US

ISO-3166 alpha-2 country code, uppercase (e.g. US, GB, DE)

Pattern: ^[A-Z]{2}$
Examples:

"US"

"GB"

ad_type
enum<string>
default:all

Ad category to scope the search

Available options:
all,
political_and_issue_ads

Response

Successful Response

id
string
required
@type
string
default:@facebook_advertiser_compact
name
string | null
alias
string | null
image
string | null
category
string | null
like_count
integer | null
country
string | null
page_type
string | null
is_verified
boolean
default:false
is_deleted
boolean
default:false
ig_username
string | null
ig_follower_count
integer | null
ig_is_verified
boolean | null