pinterest/
pins

Öffentliche Pinterest-Pins über direkte Pin-URLs oder pin.it-Links erfassen – mit Inhalt, Creator-Angaben, Medien, Zeitstempeln und sichtbaren Kennzahlen als normalisierte Datensätze.

Pinterest Pins API

Pin-URL als Eingabe
Creator- und Medienkontext
Momentaufnahme sichtbarer Kennzahlen
0,5 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

Pinterest Pins

Pinterest-Pins sind öffentliche visuelle Beiträge mit Titeln, Beschreibungen, Creator-Angaben, Bild- oder Videoverweisen, Kategorien, Hashtags und sichtbarer Interaktion. Diese Datensätze unterstützen die Archivierung ausgewählter Inhalte, die Recherche zu Kreativem und Themen, die Zuordnung der Urheberschaft und den Vergleich zum Erfassungszeitpunkt.

Funktionen der Pinterest Pins API

  • Direkte und kurze Pin-URLsVerarbeitet eine oder mehrere öffentliche Pinterest-URLs mit /pin/{id} oder pin.it-Kurzlinks und beschränkt die Erfassung auf die übermittelten Pins.
  • Verbundene Inhalts- und Creator-FelderLiefert Titel und Text des Pins zusammen mit Quell-URL, öffentlicher Creator-Identität, Profil-URL und normalisierten Bild- oder Videoverweisen.
  • Sichtbare Kennzahlen mit BeobachtungszeitBehält verfügbare Zahlen zu Likes und Kommentaren sowie die Follower-Zahl des Creators mit collected_at, damit veränderliche öffentliche Werte einen klaren Zeitpunkt der Momentaufnahme haben.
  • Klassifizierungskontext des PinsBewahrt verfügbare Werte für post_type, Kategorien und Hashtags in extra für Format- und Themenanalysen, ohne sie im Pin-Text zusammenzufassen.

Parameter der Pinterest Pins API

ParameterErforderlichBeschreibung
urlsErforderlichErforderliche Liste öffentlicher Pinterest-URLs mit /pin/{id} oder pin.it-Kurzlinks. Andere Pinterest-Pfade und Hosts außerhalb von Pinterest werden abgelehnt.

So verwenden Sie die Pinterest Pins API

Senden Sie genau die öffentlichen Pins, die Sie benötigen, verfolgen Sie die asynchrone Aufgabe und lesen Sie normalisierte Pin-Datensätze per Cursor-Paginierung.

  1. Bereiten Sie eine oder mehrere öffentliche Pinterest-URLs mit /pin/{id} oder pin.it-Kurzlinks vor.
  2. Senden Sie die Links als urls an /v1/pinterest/pins und speichern Sie die task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Verarbeitung erfolgreich ist oder einen Fehler meldet.
  4. Lesen Sie data.results.items und fordern Sie dann mit next_cursor die nächste Seite an, solange has_more true ist.
curl -X POST "https://api.socq.ai/v1/pinterest/pins" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.pinterest.com/pin/123456789/"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Anwendungsfälle der Pinterest Pins API

  • Archivierung ausgewählter Pins: Sichern Sie Pin-IDs, Quell-URLs, Titel, Text, Creator-Felder, Medienverweise und Veröffentlichungszeit für eine festgelegte URL-Liste.
  • Prüfung von Kreativem und Themen: Nutzen Sie Medientyp, post_type, Kategorien, Hashtags, Titel und Text, um Formate und Themen über ausgewählte Pins hinweg zu vergleichen.
  • Vergleich von Signalen zum Erfassungszeitpunkt: Vergleichen Sie die sichtbaren Zahlen zu Likes und Kommentaren zusammen mit dem Follower-Kontext des Creators und verankern Sie jede Beobachtung über collected_at.

Profi-Tipps zur Pinterest Pins API

  • Verwenden Sie für jedes Element eine öffentliche URL mit /pin/{id} oder einen pin.it-Link; Profil-, Such-, Ideen- und andere Pinterest-Pfade erfüllen die Eingaberegel dieses Endpunkts nicht.
  • Entfernen Sie Duplikate bei den zurückgegebenen id-Werten, wenn direkte und verkürzte Links auf denselben Pin führen können.
  • Behandeln Sie Medien, created_at, Kategorien, Hashtags, post_type und einzelne Kennzahlen als optionale Felder, denn ein öffentlicher Pin zeigt möglicherweise nicht jeden Wert.
  • Speichern Sie collected_at neben den sichtbaren Kennzahlen, damit sich spätere Läufe als getrennte Momentaufnahmen zum Erfassungszeitpunkt deuten lassen.

Ergänzend zur Pinterest Pins API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Pinterest-Daten benötigen.

  • 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 Search API — Öffentliche Pins per Textsuche mit Ergebnislimit suchen und normalisierte Inhalte, Creator, Medien, Taxonomie, Zeitstempel und sichtbare Kennzahlen zurückgeben.
  • 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.

Weitere Plattformen entdecken

Kombinieren Sie Pinterest-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Pinterest Pins API — FAQ

Pinterest Pins API ruft öffentliche Pin-Datensätze aus übermittelten direkten Pinterest-Pin-URLs oder unterstützten Kurzlinks ab. Sie liefert normalisierte Inhalte, Creator-Angaben, Medien, Zeitstempel, Kategorien, Hashtags und sichtbare Kennzahlen.

Senden Sie eine HTTP- oder HTTPS-URL auf einer Pinterest-Domain, deren Pfad mit /pin/{id} beginnt, oder verwenden Sie einen pin.it-Kurzlink. Profil-, Such-, Ideen- und andere Pfade werden abgelehnt.

Nein. Der Endpunkt löst nur die unterstützten öffentlichen Pin-Links in urls auf und erweitert kein Creator-Profil zu einem Feed.

Das normalisierte Medien-Array kann öffentliche Bild- oder Videoverweise enthalten. Es bleibt leer, wenn der Quelldatensatz keine verwertbare Medien-URL bereitstellt.

Ein öffentlicher Pin zeigt möglicherweise keine Medien, Veröffentlichungszeit, Kategorien, Hashtags, keinen Beitragstyp oder nicht jede sichtbare Kennzahl; optionale Werte können daher null oder leer sein.

Jeder Pin-Datensatz in einem abgeschlossenen Ergebnis kostet 0,5 SocQ-Credits. Ein leeres Ergebnis verursacht keine Ergebnisgebühr.