Pinterest-Anzeigen
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).
HOLEN
/api/v1/pinterest-adsSearch Pinterest ads. Engagement names are platform-specific: likes = saves, shares = repins.
Senden
X-API-Schlüssel on every request.Abfrageparameter
StichwortZeichenketteoptionalFree-text search. Comma-separated terms are alternatives.
SuchbegriffZeichenketteoptionalField scope for the keyword.
LänderZeichenketteoptionalAll or comma-separated country codes.
SortierenZeichenketteoptionalSortierrichtungZeichenketteoptional
Request
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()Antwort
{
"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 Daten 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).
Alle Abfrageparameter
Der Endpunkt akzeptiert dieselben Abfrageschlüssel wie das Pinterest-Anzeigen-Dashboard in der App.
| Parameter | Anmerkungen |
|---|---|
Stichwort |
Freitextsuche. Durch Kommas getrennte Begriffe werden als Alternativen behandelt. |
Suchbegriff |
Anwendungsbereich: Alle, Ziel-URL, storeurl, Seitenname, Anzeigentextoder Produktname. |
Seiten-ID / pageidfromurl |
Ergebnisse auf eine Pinterest-Promoter-ID bzw. Seiten-ID beschränken. |
Produkt / Produkt-ID |
Ergebnisse auf eine Shopify-Produkt-ID beschränken, auf die in der Anzeige verwiesen wird. |
Nischen |
Alle oder durch Kommas getrennte Nischenwerte. |
Länder |
Alle oder durch Kommas getrennte Ländercodes, die mit den Ziel-Ländern von Pinterest abgeglichen werden. |
Sprachen / Sprache |
Alle oder durch Kommas getrennte Sprachcodes. |
Geschlecht |
Geschlecht der Zielgruppe, sofern verfügbar. |
Website / Technologien |
Speichern Sie Technologiefilter, beispielsweise Shopify-bezogene Werte, über das Dashboard. |
Medientyp |
Videos, Video, Bilderoder Bild. |
Seitentyp |
Produkt, Produkte, Kollektionoder Kollektionen. |
minlikes, maxlikes |
Pinterest speichert die Reichweite. |
mincomments, maxcomments |
Anzahl der Kommentare. |
Minshares, maxshares |
Anzahl der Repins auf Pinterest. |
mintraffic, maxtraffic |
Monatliche Schwankungsbreite der Kundenfrequenz, sofern Daten vorliegen. |
Mindestpreis, Höchstpreis |
Preisspanne des Produkts, sofern Produktdaten von Shopify verfügbar sind. |
von, zu |
Zeitraum für das Start- bzw. Erstellungsdatum der Anzeige. |
seit dem letzten Besuch, zu sehen |
Zeitraum, in dem der Nutzer zuletzt online war. |
Herkunft des Produkts, Produkt_zu |
Zeitraum, in dem das Produkt oder die Kollektion erstellt wurde. |
Mindays, maxdays |
Laufzeit in Tagen, basierend auf dem Startdatum der Anzeige. |
Sortieren / sortieren |
Datum gefunden, Kommentare, Likes, Aktien, Reaktionen, zuletzt gesehenoder Lauftage. |
Sortierrichtung |
asc oder Beschreibung; Standardwert ist Beschreibung. |
adscorefilter / Anzeigen-Score |
siegreich, Skalierungoder Testen; filtert nach der Bewertung und gibt bis zu 20 Treffer zurück. |
An
- Pinterest verwendet plattformspezifische Bezeichnungen für Interaktionen.
Likesentspricht den Speicherständen undAktienentspricht Repins. - Der programmatische Endpunkt nutzt weder die Testfunktion des Dashboards noch erhöht er die kostenlosen Pinterest-Dashboard-Guthaben. Er verbraucht ausschließlich monatliche API-Guthaben.
- Eine vollständige Übersicht über die API finden Sie in der WinningHunter-API-Dokumentation.