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-adsSearch Pinterest ads. Engagement names are platform-specific: likes = saves, shares = repins.
Send
X-API-Anahtarı on every request.Query parameters
anahtar kelimedizeoptionalFree-text search. Comma-separated terms are alternatives.
arama kelimesidizeoptionalField scope for the keyword.
ülkelerdizeoptionalAll or comma-separated country codes.
sıralamadizeoptionalsıralama yönüdizeoptional
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ğenilerkaydedilenlere eşlenir vehisse senetleriyeniden 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.