Pinterest Search
Die Ergebnisse von Pinterest Search sind öffentliche Pins, die zu einer Textabfrage passen, mit Titeln, Beschreibungen, Creator-Angaben, Medienverweisen, Kategorien, Hashtags, Zeitstempeln und sichtbarer Interaktion. Diese Datensätze unterstützen die Themenentdeckung, die Recherche zu visuellen Themen, die Analyse des Creator-Kontexts und den Vergleich von Inhalten anhand von Abfragen.
Funktionen der Pinterest Search API
- Pin-Entdeckung per AbfrageAkzeptiert eine nicht leere Textabfrage und ein results_limit von 1 bis 2.000, um eine begrenzte Sammlung öffentlicher Pin-Datensätze anzufordern.
- Normalisierte Pin-, Creator- und MediendatensätzeLiefert Pin-IDs, URLs, Titel, Text, öffentliche Creator-Felder und Bild- oder Videoverweise in einer einheitlichen Ergebnisform.
- Taxonomie und Kontext sichtbarer SignaleBehält verfügbare Kategorien, Hashtags, Pin-Typ, Quell-Metadaten, sichtbare Zahlen zu Likes, Kommentaren und Creator-Followern, Veröffentlichungszeit, Erfassungszeit und den Kontext der übermittelten Abfrage.
Parameter der Pinterest Search API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Erforderliche, nicht leere Textabfrage zur Entdeckung öffentlicher Pinterest-Pins; Leerzeichen am Anfang und Ende werden vor dem Senden entfernt. |
results_limit | Optional | Maximale Zahl der für die Abfrage angeforderten Pins; Standardwert ist 100, zulässig sind ganze Zahlen von 1 bis 2.000. |
So verwenden Sie die Pinterest Search API
Senden Sie eine Pinterest-Textabfrage mit Ergebnislimit, verfolgen Sie die asynchrone Aufgabe und lesen Sie normalisierte Pins per Cursor-Paginierung.
- Bereiten Sie eine nicht leere Textabfrage vor und wählen Sie ein results_limit von 1 bis 2.000.
- Senden Sie query und results_limit per POST an /v1/pinterest/search und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler meldet.
- Lesen Sie data.results.items und fordern Sie das zurückgegebene next_cursor an, solange has_more true bleibt.
curl -X POST "https://api.socq.ai/v1/pinterest/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"home office ideas","results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der Pinterest Search API
- Themenbezogene Pin-Datensätze: Nutzen Sie eine festgelegte Abfrage mit Pin-IDs, Quell-URLs, Titeln, Text, Medienverweisen und discovery_input, um eine nachvollziehbare Themensammlung aufzubauen.
- Recherche zu Bildwelten und Taxonomie: Vergleichen Sie Bilder oder Videos, post_type, Kategorien, Hashtags, Titel und Beschreibungen, um Formate und Themen innerhalb der Abfrageergebnisse zu untersuchen.
- Vergleich von Creators und sichtbaren Signalen: Kombinieren Sie öffentliche Creator-Felder mit Zahlen zu Likes, Kommentaren und Followern sowie collected_at, um den beobachteten Ergebniskontext über Abfragesammlungen hinweg zu vergleichen.
Profi-Tipps zur Pinterest Search API
- Senden Sie eine nicht leere Abfrage, nachdem Sie versehentliche Leerzeichen am Rand entfernt haben, und halten Sie results_limit zwischen 1 und 2.000, um die Eingabevalidierung zu erfüllen.
- Folgen Sie next_cursor, bis has_more false ist, wenn die gespeicherten Ergebnisse über die erste Antwortseite mit 50 Elementen hinausgehen.
- Bewahren Sie extra.discovery_input und collected_at auf, damit jeder Pin an das übermittelte Keyword und den Beobachtungszeitpunkt gebunden bleibt.
- Behandeln Sie Titel, Text, Autorenangaben, Medien, created_at, Kategorien, Hashtags, source und einzelne Kennzahlen als optionale Felder, statt fehlende Werte als Anfragefehler zu werten.
Verwandte APIs
Ergänzend zur Pinterest Search API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Pinterest-Daten benötigen.
- Pinterest Pins API — Öffentliche Pin-URLs in normalisierte Inhalte, Creator, Medien, Taxonomie, Zeitstempel und sichtbare Kennzahlen auflösen.
- Pinterest User Pins API — Öffentliche Pins aus Profil-URLs ermitteln – mit Limit pro Profil, normalisierten Inhalten, Creator, Medien, Zeitstempeln und sichtbaren Kennzahlen.
- Pinterest Profiles API — Öffentliche Profilidentität, Bio, Bild, Website, sichtbare Kontozahlen und Erfassungskontext aus Profil-URLs erfassen.
- Pinterest User Boards API — Die Boards von Pinterest-Profilen über Profil-URLs auflisten – mit Namen, Beschreibungen, Covern, Erstelldatum sowie Zahl der Pins, Follower, Abschnitte und Mitwirkenden.
- Pinterest Board Pins API — Die Pins eines Pinterest-Boards über die Board-URL in Board-Reihenfolge erfassen – mit Pin-Text, merkendem Konto, Bildern in voller Größe und Pin-Links.
- Pinterest Topic API — Pinterest-Ideenseiten auslesen, um je Thema die monatliche Suchzahl, die Aktualisierungszeit und die vorgeschlagenen Unterthemen zu erhalten.