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.

pinterest/profiles
Profile0,6 Credits pro Ergebnis

pinterest/pins
Beiträge0,5 Credits pro Ergebnis

pinterest/user-pins
Beiträge0,5 Credits pro Ergebnis

pinterest/search
Suche0,6 Credits pro Ergebnis

pinterest/user-boards
Profile0,5 Credits pro Ergebnis

pinterest/board
Beiträge0,5 Credits pro Ergebnis

pinterest/topic
Suche0,5 Credits pro Ergebnis
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.
| Funktion | SocQ | Pinterest API |
|---|---|---|
| Hauptzweck | Öffentliche Profile, Pins, Nutzer-Pins und Suchergebnisse erfassen | Autorisierte Inhalte, Werbung, Analysen und Kataloge verwalten |
| OAuth beim Kunden | SocQ-API-Schlüssel; kein Pinterest-OAuth des Kunden | Pinterest-App, Zugriffstoken und erforderliche Scopes |
| Ausgangseingabe | Öffentliche Profil- oder Pin-URL oder eine Textabfrage | Autorisierter Kontokontext und Pinterest-Ressourcen-IDs |
| Pins erstellen oder verwalten | Nicht unterstützt | Unterstützt im Namen eines authentifizierten Nutzers mit Schreib-Scopes |
| Antwortformat | Normalisierte SocQ-Datensätze | Native Pinterest-API-Objekte |
So funktioniert die Pinterest API
Alle vier Pinterest-APIs nutzen denselben asynchronen Aufgabenablauf mit paginierten Ergebnissen.
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. Aufgabe verfolgen
Fragen Sie /v1/tasks/{task_id} ab, bis die Verarbeitung abgeschlossen ist.
3. Ergebnisse abrufen
Lesen Sie data.results.items und verwenden Sie next_cursor, solange has_more den Wert true hat.
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 trueTypische 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.
Daten verschiedener Plattformen kombinieren und umfassendere Geschäftseinblicke gewinnen
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.
Threads API
Rufen Sie öffentliche Threads-Profile ab, lösen Sie bekannte Beiträge auf oder erfassen Sie Beiträge ausgewählter Profile – mit normalisierten Feldern zu Identität, Inhalt, Medien, Engagement und Zeitstempeln.
Bluesky API
Rufen Sie öffentliche Bluesky-Profile ab, lösen Sie URLs bekannter Beiträge auf oder erfassen Sie eine Seite mit Kontobeiträgen – mit normalisierter Identität, Inhalt, Medien, Zeitstempeln und sichtbaren Interaktionsfeldern.
Snapchat API
Ein bekanntes öffentliches Snapchat-Spotlight als normalisierten Datensatz abrufen – mit verfügbaren Feldern zu Creator, Bildunterschrift, Medien, Audio, Zeitstempel, Dauer und Engagement.
Twitch API
Wandeln Sie einen bekannten öffentlichen Twitch-Benutzernamen in ein normalisiertes Profil um, erfassen Sie dessen öffentlichen Videobestand oder laden Sie einen einzelnen Clip samt herunterladbarem Video für Creator-Recherche, Kataloganreicherung, Vergleiche und die Beobachtung per Momentaufnahme.
Rednote API
Rufen Sie öffentliche Profile und Notes ab, suchen Sie nach Notes oder Nutzern, erfassen Sie Kommentare und verschachtelte Antworten und holen Sie eine Seite mit Empfehlungen der Startseite.
Kwai API
Rufen Sie öffentliche Kwai-Profile, eine Seite mit Kontobeiträgen oder einen bekannten Beitrag ab – mit normalisierten Angaben zu Identität, Inhalt, Medien, Zeitstempeln und sichtbarem Engagement.