Zurück zu den APIs
Öffentliche Pinterest-Daten

Pinterest Public Data API

Rufen Sie öffentliche Pinterest-Profildaten ab, lösen Sie bekannte Pins auf, erfassen Sie Pins ausgewählter Profile oder suchen Sie per Stichwort – für die Creator-Recherche sowie die Recherche zu Inhalten und visuellen Trends.

Verfügbare Pinterest-APIs

Verwenden Sie Profiles für Kontodaten, Pins für einen bekannten Pin, User Pins für Inhalte ausgewählter Profile oder Search für die stichwortbasierte Suche nach Pins.

Welche Pinterest-Daten können Sie abrufen?

SocQ liefert normalisierte öffentliche Konto- und Pin-Datensätze mit Kontext zu Identität, Inhalt, Medien, Klassifizierung, Suche, Engagement und Erfassungszeitpunkt.

Öffentliche Profildetails

Ruft Profil-IDs, Benutzernamen, Anzeigenamen, Bios, Bilder, verknüpfte Websites, Länderkontext und sichtbare Kontozahlen ab.

Pin-Inhalte und Medien

Ruft Pin-Identität, Titel, Text, Angaben zum Creator, Medienverweise, Veröffentlichungszeit und sichtbare Kennzahlen ab, sofern verfügbar.

Pin-Sammlungen einzelner Creator

Durchsucht eine begrenzte Menge öffentlicher Pins aus ausgewählten Profil-URLs und hält jedes Ergebnis mit dem gesendeten Profil verbunden.

Themen und Klassifizierung

Sucht Pins per Stichwort und behält verfügbare Beitragsart, Kategorien, Hashtags, Quellangaben und die Sucheingabe bei.

SocQ vs Pinterest API

SocQ konzentriert sich auf die unterstützte Erfassung öffentlicher Pinterest-Daten. Die offizielle Pinterest-API ist für authentifizierte Integrationen von Inhalten, Werbung, Analysen und Katalogen ausgelegt.

FunktionSocQPinterest API
HauptzweckÖffentliche Profile, Pins, Nutzer-Pins und Suchergebnisse erfassenAutorisierte Inhalte, Werbung, Analysen und Kataloge verwalten
OAuth beim KundenSocQ-API-Schlüssel; kein Pinterest-OAuth des KundenPinterest-App, Zugriffstoken und erforderliche Scopes
AusgangseingabeÖffentliche Profil- oder Pin-URL oder eine TextabfrageAutorisierter Kontokontext und Pinterest-Ressourcen-IDs
Pins erstellen oder verwaltenNicht unterstütztUnterstützt im Namen eines authentifizierten Nutzers mit Schreib-Scopes
AntwortformatNormalisierte SocQ-DatensätzeNative Pinterest-API-Objekte

So funktioniert die Pinterest API

Alle vier Pinterest-APIs nutzen denselben asynchronen Aufgabenablauf mit paginierten Ergebnissen.

  1. 1. Eingabe senden

    Senden Sie Profil-URLs, Pin-URLs oder eine Suchabfrage an die passende API und speichern Sie die zurückgegebene task_id.

  2. 2. Aufgabe verfolgen

    Fragen Sie /v1/tasks/{task_id} ab, bis die Verarbeitung abgeschlossen ist.

  3. 3. Ergebnisse abrufen

    Lesen Sie data.results.items und verwenden Sie next_cursor, solange has_more den Wert true hat.

Öffentliche Pins per Stichwort suchen

Authentifizieren Sie sich mit Ihrem SocQ-API-Schlüssel und senden Sie eine Textabfrage. Profiles, Pins und User Pins folgen demselben Aufgabenablauf.

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 true

Typische Anwendungsfälle der Pinterest API

Creator- und Profilrecherche

Reichern Sie bekannte Profil-URLs mit öffentlicher Identität, Bio, Website, Länderkontext, sichtbaren Zahlen und Erfassungszeit an.

Analyse bekannter Pins

Wandeln Sie ausgewählte Pin-URLs in Inhalt, Creator, Medien, Taxonomie, Zeitstempel, sichtbare Kennzahlen und Quelllinks um.

Beobachtung von Creator-Inhalten

Erfassen Sie begrenzte Pin-Mengen ausgewählter Profile und vergleichen Sie Inhalte und Kontomomentaufnahmen zum Zeitpunkt der Erfassung.

Recherche zu visuellen Themen und Trends

Suchen Sie definierte Stichwörter, um strukturierte Pin-Datensätze mit Kontext zu Creator, Medien, Klassifizierung und Suche aufzubauen.

Grenzen und Richtlinie für öffentliche Daten

Pinterest-Ergebnisse sind öffentliche Datensätze zu einem bestimmten Zeitpunkt. Diese APIs greifen nicht auf private Inhalte zu und erstellen, bearbeiten, speichern oder verwalten weder Profile noch Pins.

  • Profiles erfordert eine Profil-URL mit genau einem Pfadsegment für den Benutzernamen. Es liefert Kontodetails, aber keine Boards, Pins oder Listen von Zielgruppenmitgliedern.
  • Pins erfordert eine bekannte öffentliche /pin/{id}-URL oder einen pin.it-Link und erweitert ein Profil nicht zu einer Pin-Sammlung.
  • User Pins erfordert öffentliche Profil-URLs. results_limit hat den Standardwert 100, akzeptiert 1 bis 2.000 und gilt für jedes Profil separat.
  • Search erfordert eine Textabfrage. results_limit hat den Standardwert 100 und akzeptiert 1 bis 2.000; Sortierung und weitere Filter werden nicht angeboten.
  • Optionale Felder zu Identität, Inhalt, Medien, Klassifizierung, Quelle, Zeitstempel und Kennzahlen können null oder leer sein, wenn die öffentliche Quelle sie nicht bereitstellt.
  • Die APIs sind schreibgeschützt und erstellen, bearbeiten, speichern oder verwalten keine Pinterest-Profile, Boards oder Pins.

Häufige Fragen zur Pinterest API

Was ist die Pinterest API?

Die Pinterest API ist eine Gruppe von SocQ-Endpunkten, mit denen Sie öffentliche Profildaten abrufen, bekannte Pins auflösen, Pins ausgewählter Profile erfassen und öffentliche Pins per Stichwort suchen.

Welche Pinterest-API sollte ich verwenden?

Verwenden Sie Profiles für Kontodetails, Pins für bekannte /pin/{id}- oder pin.it-Links, User Pins für eine begrenzte Sammlung aus Profil-URLs und Search für die stichwortbasierte Suche.

Liefern Profiles und User Pins dieselben Daten?

Nein. Profiles liefert Kontometadaten und aggregierte Zahlen, während User Pins normalisierte Pin-Datensätze liefert, die aus den gesendeten Profil-URLs gefunden wurden.

Wie funktioniert das Ergebnislimit bei User Pins?

results_limit hat den Standardwert 100, akzeptiert ganze Zahlen von 1 bis 2.000 und gilt für jede Profil-URL separat.

Warum können Felder null oder leer sein?

Ein öffentliches Profil oder ein öffentlicher Pin stellt zum Zeitpunkt der Erfassung möglicherweise nicht jeden Wert zu Identität, Inhalt, Medien, Taxonomie, Quelle, Zeitstempel oder Kennzahlen bereit.

Wie wird die Erfassung bei Pinterest abgerechnet?

Jedes zurückgegebene Profil und jeder Search-Pin kostet 0,6 Credits, jeder zurückgegebene Pin aus Pins oder User Pins 0,5 Credits. Für leere Ergebnismengen fällt keine Ergebnisgebühr an.

Führen Sie öffentliche Profile, Inhalte und Interaktionsdaten verschiedener Plattformen in einem Workflow zusammen, um Marken, Creator und Themen zu verfolgen und plattformübergreifend effizienter zu überwachen und zu analysieren.