Google Ads Transparency ad details API
Google Ads Transparency ad details, as JSON, with id, url, advertiser, status, started_at and more.
GETapi.socialscrape.io/v1/google/ad-library/ad
- Cost
- 1 credit
- Cached repeats
- 0 creditssend max_age_days, results kept 30 days
- Failed requests
- 0 credits
- Status
- Betashape may still gain fields
You send url.
Request
Send your key in the x-api-key header.
curl
curl -G "https://api.socialscrape.io/v1/google/ad-library/ad" \
-H "x-api-key: $SOCIALSCRAPE_API_KEY" \
--data-urlencode 'url=https://adstransparency.google.com/advertiser/AR16735076323512287233/creative/CR17814369753519620097'Python
import os
import requests
params = {
"url": "https://adstransparency.google.com/advertiser/AR16735076323512287233/creative/CR17814369753519620097",
}
res = requests.get(
"https://api.socialscrape.io/v1/google/ad-library/ad",
headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},
params=params,
timeout=60,
)
body = res.json()
if body["ok"]:
print(body["data"])
else:
print(body["error"]["code"], body["error"]["message"])TypeScript
const url = new URL("https://api.socialscrape.io/v1/google/ad-library/ad");
url.search = new URLSearchParams({
url: "https://adstransparency.google.com/advertiser/AR16735076323512287233/creative/CR17814369753519620097",
}).toString();
const res = await fetch(url, {
headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! },
});
const body = await res.json();
if (body.ok) {
console.log(body.data);
} else {
console.error(body.error.code, body.error.message);
}n8n
{
"nodes": [
{
"name": "SocialScrape Google Ads Transparency ad details",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4.2,
"position": [
0,
0
],
"parameters": {
"method": "GET",
"url": "https://api.socialscrape.io/v1/google/ad-library/ad",
"sendQuery": true,
"queryParameters": {
"parameters": [
{
"name": "url",
"value": "https://adstransparency.google.com/advertiser/AR16735076323512287233/creative/CR17814369753519620097"
}
]
},
"sendHeaders": true,
"headerParameters": {
"parameters": [
{
"name": "x-api-key",
"value": "={{ $env.SOCIALSCRAPE_API_KEY }}"
}
]
}
}
}
],
"connections": {}
}Parameters
| Name | Type | Required | Description |
|---|---|---|---|
url | url | yes | Creative URL (adstransparency.google.com/advertiser/AR.../creative/CR...). |
Every request also accepts trim, raw and max_age_days.
Response
Sample from a recorded response, shortened. Values are public data, not yours.
Status 200Sample
{
"ok": true,
"credits_charged": 1,
"credits_remaining": 4999,
"cached": false,
"cached_at": null,
"request_id": "req_e52368df68c5b101805bc02e",
"data": {
"object": "ad",
"platform": "google",
"id": "CR17814369753519620097",
"url": "https://adstransparency.google.com/advertiser/AR16735076323512287233/creative/CR17814369753519620097",
"advertiser": {
"object": "advertiser",
"platform": "google",
"id": "AR16735076323512287233",
"name": "Nike, Inc.",
"url": "https://adstransparency.google.com/advertiser/AR16735076323512287233",
"page_id": null,
"country": null,
"verified": null,
"ad_count": null,
"extra": null
},
"status": "unknown",
"started_at": null,
"ended_at": null,
"title": null,
"body": null,
"cta_text": null,
"landing_url": null,
"format": "image",
"media": {
"thumbnail_url": null,
"video_url": null,
"audio_url": null,
"image_urls": [
"https://tpc.googlesyndication.com/archive/simgad/13349513027616705912",
"https://tpc.googlesyndication.com/archive/simgad/4311864814729701321"
],
"width": 348,
"height": 229
},
"regions": null,
"publisher_platforms": null,
"impressions": null,
"spend": null,
"extra": {
"last_shown_at": "2026-10-30T01:15:03Z",
"preview_urls": [
"https://displayads-formats.googleusercontent.com/ads/preview/content.js?client=ads-integrity-transparency&obfuscatedCustomerId=9975158271&creativeId=68114166...",
"https://displayads-formats.googleusercontent.com/ads/preview/content.js?client=ads-integrity-transparency&obfuscatedCustomerId=9975158271&creativeId=68114166..."
],
"region_stats": [
{
"criterion_id": 2840,
"last_shown": "2026-10-29",
"region": "US"
}
],
"variations": 4
}
},
"cursor": null,
"has_more": null
}Fields
One Ad in data.
A field the platform does not give is null, never made up. Extra platform details are in extra.
| Field | Type | Always | Notes |
|---|---|---|---|
object | "ad" | ||
platform | Platform | yes | the ad library's platform |
id | string | yes | |
url | string or null | ||
advertiser | Advertiser or null | ||
status | "active" or "inactive" or "unknown" | ||
started_at | string (ISO 8601 date-time) or null | ||
ended_at | string (ISO 8601 date-time) or null | ||
title | string or null | ||
body | string or null | ||
cta_text | string or null | ||
landing_url | string or null | ||
format | string or null | "image" | "video" | "carousel" | "text" | platform-specific | |
media | Media |
Show the other 5 fields
Full field list in the reference for this endpoint and the data models. Errors are listed under Errors.
Questions
Which errors can it return?
invalid_params (do not retry), unsupported_url (do not retry), not_found (do not retry). Account and platform errors from the errors list can also happen. A failure always costs 0 credits.
Is there an SDK call for it?
The preview Python client has client.google.ad_library_ad(...) and the TypeScript client client.google.adLibraryAd(). Both return the same envelope as the HTTP API. The packages are not published yet; plain HTTP works today in any language.
Can an AI agent call it?
Yes. The MCP server reaches every built endpoint, with the same prices.