Parse an Ad Library URL
Turn any Google Ad Library URL into the structured filters it encodes — whether it points at one ad, one advertiser or one website, plus the region, creative format, Google surfaces, date range and political-only flag carried in its query string. Only the identifier matching kind is populated. Parsing a URL does not consume a credit.
/resolve-url Utility https://api.fetchlayer.dev/google-ad-library/resolve-url Headers
Authorization string required Bearer token — your FetchLayer API key.
Parameters
url string required Any Ad Library URL, to be parsed into structured filters.
Response Fields
resolve-url
Parse an Ad Library URL
kind string What the URL points at: ad, advertiser, domain, or unknown.
adId string Present when kind is ad.
advertiserId string Present when kind is ad or advertiser.
domain string Present when kind is domain.
region string Region filter carried in the URL.
format string Creative format filter carried in the URL.
surfaces string[] Google surfaces carried in the URL.
shownAfter string Start of the date range carried in the URL.
shownBefore string End of the date range carried in the URL.
politicalOnly boolean Whether the URL restricts to political and issue ads.
Request
curl -X POST "https://api.fetchlayer.dev/google-ad-library/resolve-url" \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"url":"https://adstransparency.google.com/advertiser/AR01234567890123456789?region=US"}'Response
{
"kind": "advertiser",
"advertiserId": "AR01234567890123456789",
"adId": null,
"domain": null,
"region": "US",
"format": null,
"surfaces": [],
"politicalOnly": false
}