Şirket Reklamları

GET/v1/google/company/ads1 kredi

Bir reklamverenin Google'da yayınladığı reklamları Google Ads Şeffaflık Merkezi'nden döndürür: sayfa başına 40 reklam, her biri format, reklamveren, alan adı, önizleme görseli, reklam URL'si ve ilk ile son gösterim tarihleriyle gelir.

01Sorgu parametreleri

Ad	Tür	Açıklama
domainisteğe bağlı	string	Reklamverenin web sitesi alan adı, örneğin `lululemon.com`. `topic` değeri `political` değilse `domain` veya `advertiser_id` parametrelerinden biri zorunludur.
advertiser_idisteğe bağlı	string	Google reklamveren id'si, örneğin `AR01614014350098432001`; `domain` ile birlikte verilirse bu kullanılır. `topic` değeri `political` değilse `domain` veya `advertiser_id` parametrelerinden biri zorunludur.
topicisteğe bağlı	string	`political` siyasi reklamları listeler; bu durumda `region` zorunludur, `domain` veya `advertiser_id` gerekmez.Varsayılan: `all`Kabul edilen değerler:`allpolitical`
regionisteğe bağlı	string	İki harfli ülke kodu, örneğin `US` veya `AU`; `anywhere` ya da boş bırakmak tüm bölgeler anlamına gelir.
start_dateisteğe bağlı	string	Yalnızca bu tarihte veya sonrasında gösterilen reklamlar; biçim `YYYY-MM-DD`.
end_dateisteğe bağlı	string	Yalnızca bu tarihte veya öncesinde gösterilen reklamlar; biçim `YYYY-MM-DD`. `start_date` tarihinden önce olamaz.
platformisteğe bağlı	string	Yalnızca bu Google yüzeyinde gösterilen reklamlar.Kabul edilen değerler:`google_mapsgoogle_playgoogle_searchgoogle_shoppingyoutube`
formatisteğe bağlı	string	Yalnızca bu formattaki reklamlar.Kabul edilen değerler:`textimagevideo`
get_ad_detailsisteğe bağlı	boolean	`true` verildiğinde her reklamın tüm ayrıntıları (gösterimler, harcama, hedefleme, bölgeler, varyasyonlar) Ad endpoint'inin döndürdüğü biçimde eklenir. Sayfa başına 25 kredi tutar.Varsayılan: `false`
cursoristeğe bağlı	string	Sonraki sayfa için bir önceki yanıttaki `cursor` değeri.

02Fiyatlandırma

`get_ad_details` olmadan bir sayfa 1 kredi tutar. `get_ad_details=true` ile 25 kredi tutar ve bu tutar sorgulardan önce ayrılır: bakiyenizde en az 25 kredi olmalıdır; sayfada reklam yoksa ya da çağrı başarısız olursa ücret alınmaz.

03İstek

curl "https://api.scrapesocial.ai/v1/google/company/ads?domain=lululemon.com" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

04Yanıtlar

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

GET /v1/google/company/ads?domain=lululemon.com

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "ads": [
    {
      "advertiserId": "AR01614014350098432001",
      "creativeId": "CR08315718256048472065",
      "format": "text",
      "adUrl": "https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR08315718256048472065",
      "advertiserName": "lululemon athletica canada inc.",
      "domain": "lululemon.com",
      "imageUrl": "https://tpc.googlesyndication.com/archive/simgad/15451929151474865650",
      "firstShown": "2026-08-11T21:50:24.000Z",
      "lastShown": "2026-10-25T16:51:51.000Z"
    },
    {
      "advertiserId": "AR01614014350098432001",
      "creativeId": "CR17441627932949741569",
      "format": "image",
      "adUrl": "https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR17441627932949741569",
      "advertiserName": "lululemon athletica canada inc.",
      "domain": "lululemon.com",
      "imageUrl": null,
      "firstShown": "2026-07-16T18:54:34.000Z",
      "lastShown": "2026-10-25T16:51:04.000Z"
    }
  ],
  "cursor": "CgoAP7zmhU2Ya86nEhDiZmW7pVmRjmE2p%2BIAAAAAGgn8%2BGaH%2BIE0kTk%3D",
  "number_of_ads_estimate": 20000
}

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"
}

05Notlar

Sayfa başına 40 reklam döner. Yanıttaki `cursor` değeri sonraki sayfa için `cursor` parametresine verilir; son sayfada null olur. `number_of_ads_estimate`, Google'ın toplam reklam sayısı tahminidir. Görsel önizlemesi olmayan reklamlarda `imageUrl` null olur. Reklamı olmayan bir alan adı veya reklamveren boş `ads` listesiyle 200 döner ve 0 kredi tutar. Geçersiz değerler (bölge, tarihler, platform, format, cursor) ücretsiz 400 döner. `get_ad_details=true` ile sayfalar belirgin şekilde daha uzun sürer.

06Hatalar 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.