pinterest/
profiles

Öffentliche Pinterest-Profile aus einer oder mehreren Profil-URLs erfassen – mit Identität, Bio und Website, Profilbildern und sichtbaren Kontozahlen als normalisierte Datensätze.

Pinterest Profiles API

Profil-URL als Eingabe
Identitäts- und Website-Felder
Sichtbare Kontokennzahlen
0,6 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 Profiles

Pinterest-Profile sind öffentliche Kontoseiten mit Benutzernamen, Anzeigenamen, Bios, Profilbildern, verlinkten Websites und den sichtbaren Zahlen zu Followern, Gefolgten, Pinnwänden und gespeicherten Pins. Diese Identitätsfelder und Kontosignale unterstützen die Anreicherung von Profilen, den Vergleich öffentlicher Konten und die zeitbasierte Beobachtung.

Funktionen der Pinterest Profiles API

  • Öffentliche Profil-URLs als EingabeVerarbeitet eine oder mehrere unterstützte Pinterest-Profil-URLs und schließt Pin-Links, Kurzlinks, Suchseiten und andere Pfade ohne Profilbezug aus.
  • Profilidentität und DarstellungLiefert Profil-ID, kanonische URL, Benutzernamen, Anzeigenamen, Bio, Profilbild und verlinkte Website in einem normalisierten Datensatz.
  • Sichtbare KontozahlenBehält verfügbare Zahlen zu Followern, Gefolgten, Pinnwänden und gespeicherten Pins als getrennte Kennzahlen für den Vergleich auf Kontoebene.
  • Erfassungs- und QuellkontextErgänzt collected_at sowie verfügbaren Ländercode, URL der Seite mit erstellten Pins, Quellaktualisierungswert und Entdeckungseingabe, ohne sie mit Identitätsfeldern zu vermischen.

Parameter der Pinterest Profiles API

ParameterErforderlichBeschreibung
urlsErforderlichErforderliche Liste öffentlicher Pinterest-Profil-URLs. Jede URL muss HTTP oder HTTPS auf einer Pinterest-Domain verwenden und ein nicht reserviertes Pfadsegment mit dem Benutzernamen enthalten.

So verwenden Sie die Pinterest Profiles API

Senden Sie bekannte öffentliche Profil-URLs, verfolgen Sie die asynchrone Aufgabe und lesen Sie normalisierte Profildatensätze per Cursor-Paginierung.

  1. Bereiten Sie eine oder mehrere öffentliche Pinterest-Profil-URLs vor, deren Pfad ein einzelnes Segment mit dem Benutzernamen enthält.
  2. Senden Sie die Links als urls an /v1/pinterest/profiles 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/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.pinterest.com/example/"]}'

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

Anwendungsfälle der Pinterest Profiles API

  • Anreicherung öffentlicher Profile: Ergänzen Sie Datensätze zu bekannten Profil-URLs um Benutzernamen, Anzeigenamen, Bio, Profilbild, Website und Länderkontext.
  • Vergleich des Konto-Fußabdrucks: Vergleichen Sie die sichtbaren Zahlen zu Followern, Gefolgten, Pinnwänden und gespeicherten Pins über eine ausgewählte Menge öffentlicher Profile.
  • Beobachtung öffentlicher Profile: Speichern Sie Identitätsfelder und sichtbare Kennzahlen mit collected_at, um Profildarstellung und Kontosignale über Erfassungszeitpunkte hinweg zu vergleichen.

Profi-Tipps zur Pinterest Profiles API

  • Verwenden Sie eine vollständige HTTP- oder HTTPS-Pinterest-Profil-URL mit einem Pfadsegment für den Benutzernamen; pin.it, /pin/, /search/ und andere reservierte Pfade werden abgelehnt.
  • Normalisieren Sie die gesendeten URLs und entfernen Sie Duplikate bei den zurückgegebenen Profilen anhand von id, sofern vorhanden, mit url als stabilem Ersatzschlüssel.
  • Behandeln Sie Bio, Bild, Website, Ländercode, Quellaktualisierungswert, URL der Seite mit erstellten Pins und einzelne Kennzahlen als optionale Felder.
  • Bewahren Sie collected_at neben den sichtbaren Kontozahlen auf, damit sich spätere Läufe als getrennte öffentliche Momentaufnahmen unterscheiden lassen.
  • Nutzen Sie Pinterest User Pins API, wenn Sie Pin-Datensätze eines Profils benötigen; dieser Endpunkt liefert Profil-Metadaten und Zahlen, keine Pinnwände, Pins oder Follower-Listen.

Ergänzend zur Pinterest Profiles 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 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 Profiles API — FAQ

Pinterest Profiles API ruft öffentliche Profil-Metadaten aus einer oder mehreren unterstützten Pinterest-Profil-URLs ab. Sie liefert normalisierte Identität, Bio, Profilbild, Website, sichtbare Kontozahlen und Erfassungskontext.

Senden Sie eine vollständige HTTP- oder HTTPS-URL auf einer Pinterest-Domain, deren Pfad ein nicht reserviertes Segment mit dem Benutzernamen enthält. Pin-URLs, pin.it-Links, Suchseiten und reservierte Pfade wie /ideas/ oder /today/ werden abgelehnt.

Ergebnisse können Profil-ID, URL, Benutzernamen, Anzeigenamen, Bio, Avatar, Website, Zahlen zu Followern und Gefolgten, Zahlen zu Pinnwänden und gespeicherten Pins, Erfassungszeit, Ländercode und die URL einer Seite mit erstellten Pins enthalten.

Nein. Er liefert Profil-Metadaten und sichtbare Gesamtzahlen, keine Pinnwand- oder Pin-Datensätze und nicht die Mitglieder von Follower- und Gefolgten-Listen; nutzen Sie Pinterest User Pins API, wenn Sie Pins benötigen, die über eine Profil-URL entdeckt werden.

Ein öffentliches Profil zeigt möglicherweise keine Bio, Website, kein Bild, keinen Ländercode, keine URL einer Seite mit erstellten Pins, keinen Quellaktualisierungswert und nicht jede sichtbare Zahl. Clients sollten optionale Werte als null oder leer akzeptieren.

Jeder Profildatensatz in einem abgeschlossenen Ergebnis kostet 0,6 SocQ-Credits. Ein leeres Ergebnis verursacht keine Ergebnisgebühr.