Reklam

GET/v1/google/ad1 kredi

Google Ads Şeffaflık Merkezi'ndeki tek bir reklamın ayrıntılarını döndürür: format, ilk ve son gösterim tarihleri, gösterimler, harcama, hedefleme, bölge bazlı istatistikler ve reklamın varyasyonları (başlıklar, açıklamalar, görseller, açılış sayfaları).

01Sorgu parametreleri

Ad	Tür	Açıklama
urlzorunlu	string	Ads Şeffaflık Merkezi'ndeki reklam URL'si, `https://adstransparency.google.com/advertiser/AR…/creative/CR…` biçiminde.
cache_max_ageisteğe bağlı	string	Uyumluluk için kabul edilir; her çağrı güncel olarak çekilir.Kabul edilen değerler:`1d3d7d14d30d`

02İstek

curl "https://api.scrapesocial.ai/v1/google/ad?url=https%3A%2F%2Fadstransparency.google.com%2Fadvertiser%2FAR01614014350098432001%2Fcreative%2FCR07329434885456658433" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

GET /v1/google/ad?url=https%3A%2F%2Fadstransparency.google.com%2Fadvertiser%2FAR01614014350098432001%2Fcreative%2FCR07329434885456658433

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "advertiserId": "AR01614014350098432001",
  "creativeId": "CR07329434885456658433",
  "firstShown": null,
  "url": "https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR07329434885456658433",
  "lastShown": "2026-10-25T09:59:03.000Z",
  "format": "image",
  "overallImpressions": {
    "min": null,
    "max": null
  },
  "spend": null,
  "targeting": null,
  "creativeRegions": [
    {
      "regionCode": "CA",
      "regionName": "Canada"
    }
  ],
  "regionStats": [
    {
      "regionCode": "CA",
      "regionName": "Canada",
      "firstShown": null,
      "lastShown": "2026-10-25T00:00:00.000Z",
      "impressions": {},
      "platformImpressions": []
    }
  ],
  "variations": [
    {
      "destinationUrl": null,
      "headline": "lululemon ABC Classic-Fit Trouser 32L Warpstreme - Size 46 - Raw Linen",
      "image": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcR6dJCAAgY2ZffeJZvFyUuPiZYMz2gYlReg8QAgVvDgYrGxovoI",
      "description": "lululemon"
    },
    {
      "destinationUrl": null,
      "headline": "lululemon ABC Classic-Fit Trouser 30L Warpstreme - Size 34 - Black",
      "image": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcSbbg3QZ02ffhxQsLx1cP1xoYw240Mdia0vllzTGjLouVZBUGE",
      "description": "lululemon"
    }
  ]
}

Tüm uç noktalarda ortak

Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notlar

Gösterim, harcama ve hedefleme bilgileri çoğunlukla yalnızca siyasi reklamlar için yayımlanır; Google bunları yayımlamadığında null gelir (`overallImpressions` içindeki `min` ve `max` null olur). Varyasyonlar reklamın kendi içeriğinden okunur: yalnızca görselden oluşan bir reklamda metin çıkarılmaz, sadece görsel URL'leri döner. Google'ın artık göstermediği ya da yalnızca oturum açmış kullanıcılara gösterdiği bir reklam ücretsiz 404 döner; Ads Şeffaflık Merkezi reklamı olmayan bir URL ücretsiz 400 döner.

05Hatalar ve krediler

Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.

400missing_parameter
Zorunlu bir parametre eksik veya geçersiz.
403private_account
Hesap gizli ya da yaş kısıtlamalı.
404not_found
Böyle bir hesap yok.
503upstream_error
Platform şu an cevap vermiyor; tekrar deneyin.