Reklamveren Arama

GET/v1/google/adLibrary/advertisers/search1 kredi

Google Ads Şeffaflık Merkezi'nde reklamverenleri ada göre arar; eşleşen reklamverenleri (ad, id, bölge, tahmini reklam sayısı) ve eşleşen web sitesi alan adlarını döndürür.

01Sorgu parametreleri

Ad	Tür	Açıklama
queryzorunlu	string	Aranacak reklamveren adı, örneğin `lululemon`.
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.

02İstek

curl "https://api.scrapesocial.ai/v1/google/adLibrary/advertisers/search?query=lululemon" \
  -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/adLibrary/advertisers/search?query=lululemon

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "advertisers": [
    {
      "name": "LULULEMON MEXICO",
      "advertiser_id": "AR02903092099014459393",
      "region": "MX",
      "number_of_ads_estimate": 16
    },
    {
      "name": "lululemon HK Limited",
      "advertiser_id": "AR01382517811867287553",
      "region": "HK",
      "number_of_ads_estimate": 5000
    }
  ],
  "websites": [
    {
      "domain": "lululemon.de"
    },
    {
      "domain": "lululemon.es"
    }
  ]
}

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

Reklamverenler `advertisers`, alan adları ise `websites` listesindedir; sayfalama yoktur. Buradan alınan `advertiser_id` değerini Şirket Reklamları endpoint'inde kullanabilirsiniz. Hiçbir sonuç bulamayan arama 200 döner ve 0 kredi tutar.

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.