Belgeler
Ctrl+K Arama Alt+[Alt+] Kılavuzlar
API anahtarını al

API · Reklam kütüphanesi

Pinterest reklamları

Search Pinterest ads with the same filters as the in-app Pinterest Ads dashboard. Use the canonical /api/v1/pinterest-ads path (the dashboard /api/pinterest-ads route is session-oriented).

AL/api/v1/pinterest-ads

Search Pinterest ads. Engagement names are platform-specific: likes = saves, shares = repins.

Send X-API-Anahtarı on every request.

Query parameters

  • anahtar kelimedizeoptional

    Free-text search. Comma-separated terms are alternatives.

  • arama kelimesidizeoptional

    Field scope for the keyword.

    Varsayılan Tümü·Values Tümü hedef URL mağaza URL'si sayfa adı reklam metni ürün adı
  • ülkelerdizeoptional

    All or comma-separated country codes.

  • sıralamadizeoptional
    Varsayılan bulunma tarihi·Values bulunma tarihi yorumlar beğeniler hisse senetleri tepkiler son görülme tarihi koşu günleri
  • sıralama yönüdizeoptional
    Varsayılan açıklama·Values açıklama asc
Talep
curl -sS \
  -H "X-API-Key: $WH_API_KEY" \
  "{origin}/api/v1/pinterest-ads?keyword=skincare&searchkeyword=All&countries=US&sorting=datefound&sortdirection=desc"
const res = await fetch(`${ORIGIN}/api/v1/pinterest-ads?keyword=skincare&searchkeyword=All&countries=US&sorting=datefound&sortdirection=desc`, {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.WH_API_KEY,
  },
});
const data = await res.json();
import os, requests

res = requests.get(
    f"{ORIGIN}/api/v1/pinterest-ads?keyword=skincare&searchkeyword=All&countries=US&sorting=datefound&sortdirection=desc",
    headers={"X-API-Key": os.environ["WH_API_KEY"]},
)
data = res.json()
Yanıt
{
    "data": [
        {
            "id": "8471028374650192",
            "page_name": "Glow Beauty Co.",
            "ad_text": "The serum everyone's pinning",
            "media_type": "image",
            "likes": 12400,
            "shares": 880,
            "landing_url": "https://glowbeauty.com/serum"
        }
    ],
    "scroll": null,
    "total": 240,
    "nextscrapetime": 1710000000
}
{
    "success": false,
    "error": "Unauthorized"
}
{
    "success": false,
    "error": "WinningHunter Standard subscription required"
}

Each veriler item is a normalized Pinterest ad record matching the in-app cards (creative metadata, landing page/product fields, engagement, and saved/hidden flags for the key owner).

All query parameters

Bu uç nokta, uygulama içi Pinterest Reklamları panosuyla aynı sorgu anahtarlarını kabul eder.

Parametre Notlar
anahtar kelime Serbest metin araması. Virgülle ayrılmış terimler alternatifler olarak değerlendirilir.
arama kelimesi Uygulama alanı: Tümü, hedef URL, mağaza URL'si, sayfa adı, reklam metniya da ürün adı.
sayfa kimliği / URL'den sayfa kimliği Sonuçları tek bir Pinterest tanıtımcısına/sayfa kimliğine sınırla.
ürün / ürün kodu Sonuçları, reklamda belirtilen tek bir Shopify ürün kimliğiyle sınırlandırın.
nişler Tümü veya virgülle ayrılmış niş değerleri.
ülkeler Tümü veya Pinterest’in hedefleme ülkeleriyle eşleşen virgülle ayrılmış ülke kodları.
diller / dil Tümü veya virgülle ayrılmış dil kodları.
cinsiyet Mevcut olduğu durumlarda izleyici cinsiyet verisi.
web sitesi / teknolojiler Kontrol panelinden teknoloji filtrelerini, örneğin Shopify ile ilgili değerleri kaydedin.
medya türü videolar, video, resimlerya da görüntü.
sayfa türü ürün, ürünler, koleksiyonya da koleksiyonlar.
minlikes, en çok beğenilen Pinterest, ürün yelpazesini kaydeder.
mincomments, maksimum yorum sayısı Yorum sayısı aralığı.
minshares, maksimum hisse Pinterest'te yeniden paylaşım aralığı.
mintraffic, maxtraffic Mağaza verilerinin mevcut olduğu durumlarda aylık mağaza ziyaretçi sayısı aralığı.
en düşük fiyat, maksimum fiyat Shopify ürün verileri mevcut olduğunda ürün fiyat aralığı.
...'den, ...'ye Reklamın başlangıç/oluşturulma tarih aralığı.
songörüldüğünden beri, görülmüş Son görülme tarih aralığı.
ürün_kaynağı, ürün_adresi Ürün veya koleksiyonun oluşturulma tarih aralığı.
zihin günleri, maksimum gün sayısı Reklamın yayınlanmaya başladığı tarihe göre hesaplanan gösterim aralığı.
sıralama / sıralama bulunma tarihi, yorumlar, beğeniler, hisse senetleri, tepkiler, son görülme tarihiya da koşu günleri.
sıralama yönü asc ya da açıklama; varsayılan olarak açıklama.
reklam puan filtresi / reklam puanı kazanan, ölçeklendirmeya da test; puanlamadan sonra filtreler ve en fazla 20 eşleşmeyi döndürür.

Not

  • Pinterest, platforma özgü etkileşim adları kullanır. beğeniler kaydedilenlere eşlenir ve hisse senetleri yeniden sabitlemelere eşlenir.
  • Programatik uç nokta, kontrol paneli deneme özelliğini kullanmaz ve ücretsiz Pinterest kontrol paneli kredilerini artırmaz. Yalnızca aylık API kredilerini kullanır.
  • API'nin tam genel bakışını görmek için WinningHunter API Belgeleri'ne bakın.