Skip to main content
POST
/
api
/
google
/
ads
/google/ads
curl --request POST \
  --url https://api.anysite.io/api/google/ads \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "ad": "<string>",
  "timeout": 300,
  "region": "US"
}
'
[
  {
    "id": "<string>",
    "advertiser_id": "<string>",
    "@type": "@google_ad",
    "advertiser_name": "<string>",
    "regions": [],
    "first_shown_at": 123,
    "last_shown_at": 123,
    "image": "<string>",
    "video_url": "<string>",
    "preview_url": "<string>",
    "impressions_max": 123,
    "days_shown": 123,
    "total_days": 123,
    "spend_low": 123,
    "spend_high": 123,
    "currency": "<string>",
    "targeting": {
      "@type": "@google_ad_targeting",
      "regions": [],
      "age_min": 123,
      "age_max": 123,
      "genders": [],
      "parental_status": []
    },
    "per_region": []
  }
]

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
ad
string
required

Ad URL (https://adstransparency.google.com/advertiser/<AR...>/creative/<CR...>?region=US) or composite <advertiser_id>/<creative_id>

Minimum string length: 1
Example:

"https://adstransparency.google.com/advertiser/AR15828887856537501697/creative/CR05952545011697188865?region=US"

timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
region
enum<string> | null

ISO alpha-2 country code; overrides region in URL. Defaults to URL region or US.

Available options:
US,
GB,
CA,
AU,
DE,
FR,
IT,
ES,
NL,
SE,
JP,
PL,
AT,
BE,
BR,
CH,
CZ,
DK,
FI,
GR,
HK,
HU,
IE,
IL,
IN,
KR,
MX,
MY,
NO,
NZ,
PH,
PR,
PT,
RO,
SG,
TH,
TR,
TW,
UA,
VI,
ZA
Example:

"US"

Response

Successful Response

id
string
required
advertiser_id
string
required
topic
enum<string>
required
Available options:
commercial,
political
format
enum<string>
required
Available options:
text,
image,
video,
html5,
other
@type
string
default:@google_ad
advertiser_name
string | null
regions
string[]
first_shown_at
integer | null
last_shown_at
integer | null
image
string | null
video_url
string | null
preview_url
string | null
impressions_max
integer | null
days_shown
integer | null
total_days
integer | null
spend_low
number | null
spend_high
number | null
currency
string | null
targeting
GoogleAdTargeting · object
per_region
GoogleAdRegionStat · object[]