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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliche 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.
- Bereiten Sie eine oder mehrere öffentliche Pinterest-Profil-URLs vor, deren Pfad ein einzelnes Segment mit dem Benutzernamen enthält.
- Senden Sie die Links als urls an /v1/pinterest/profiles und speichern Sie die task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Verarbeitung erfolgreich ist oder einen Fehler meldet.
- 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 trueAnwendungsfä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.
Verwandte APIs
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.