Dokumente
Strg+K Suchen Alt+[Alt+] Hilfslinien
API-Schlüssel abrufen

API · Anzeigenbibliothek

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-ads

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

Senden X-API-Schlüssel on every request.

Abfrageparameter

  • StichwortZeichenketteoptional

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

  • SuchbegriffZeichenketteoptional

    Field scope for the keyword.

    Standard Alle·Werte Alle Ziel-URL storeurl Seitenname Anzeigentext Produktname
  • LänderZeichenketteoptional

    All or comma-separated country codes.

  • SortierenZeichenketteoptional
    Standard Datum gefunden·Werte Datum gefunden Kommentare Likes Aktien Reaktionen zuletzt gesehen Lauftage
  • SortierrichtungZeichenketteoptional
    Standard Beschreibung·Werte Beschreibung asc
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. Likes entspricht den Speicherständen und Aktien entspricht 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.