Pinterest User Pins
Pinterest User Pins sind öffentliche visuelle Beiträge, die einem Profil zugeordnet sind und durch Titel, Beschreibungen, Creator-Angaben, Medienverweise, Kategorien, Hashtags, Zeitstempel und sichtbare Interaktion dargestellt werden. Diese Inhalts- und Beobachtungsfelder unterstützen die Archivierung von Profilsammlungen, die Recherche zu visuellen Themen, die Quellenzuordnung und den Vergleich zum Erfassungszeitpunkt.
Funktionen der Pinterest User Pins API
- Pin-Entdeckung über ProfileAkzeptiert eine oder mehrere öffentliche Pinterest-Profil-URLs und liefert die jedem übermittelten Profil zugeordneten Pin-Datensätze statt Profil-Metadaten.
- Erfassungstiefe pro ProfilWendet results_limit für jede Profil-URL separat an, mit dem Standardwert 100 und einem zulässigen Bereich von 1 bis 2.000.
- Normalisierte Pin-, Autoren- und MediendatensätzeLiefert Pin-Kennungen, URLs, Titel, Text, öffentliche Autorenfelder und Bild- oder Videoverweise in einer einheitlichen Ergebnisform.
- Interaktions- und QuellkontextBehält sichtbare Zahlen zu Likes, Kommentaren und Creator-Followern mit Veröffentlichungszeit, collected_at, Klassifizierungsfeldern und discovery_input, sofern verfügbar.
Parameter der Pinterest User Pins API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliche Liste öffentlicher HTTP- oder HTTPS-Pinterest-Profil-URLs mit genau einem nicht reservierten Pfadsegment; Pin-, Such-, Ideen- und pin.it-URLs werden abgelehnt. |
results_limit | Optional | Maximal angeforderte Pins pro Profil-URL; Standardwert ist 100, zulässig sind ganze Zahlen von 1 bis 2.000. |
So verwenden Sie die Pinterest User Pins API
Senden Sie öffentliche Pinterest-Profil-URLs mit einem Ergebnislimit pro Profil, verfolgen Sie die asynchrone Aufgabe und lesen Sie normalisierte Pins per Cursor-Paginierung.
- Bereiten Sie eine oder mehrere öffentliche Pinterest-Profil-URLs mit einem einzelnen Profilpfadsegment vor.
- Senden Sie urls und ein optionales results_limit per POST an /v1/pinterest/user-pins und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler meldet.
- Lesen Sie data.results.items und fordern Sie das zurückgegebene next_cursor an, solange has_more true bleibt.
curl -X POST "https://api.socq.ai/v1/pinterest/user-pins" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.pinterest.com/example/"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der Pinterest User Pins API
- Archivierung öffentlicher Profil-Pins: Sichern Sie Pin-IDs, Quell-URLs, Titel, Text, Autorenfelder, Medienverweise, Zeitstempel und discovery_input für festgelegte Profil-URLs.
- Recherche zu Bildwelten und Taxonomie: Nutzen Sie Medientyp, post_type, Kategorien, Hashtags, Titel und Text, um wiederkehrende Formate und Themen in ausgewählten öffentlichen Profilen zu untersuchen.
- Signalvergleich über Profile hinweg: Vergleichen Sie sichtbare Zahlen zu Likes und Kommentaren mit dem Follower-Kontext der Creators über Profilsammlungen hinweg und verankern Sie jede Beobachtung über collected_at.
Profi-Tipps zur Pinterest User Pins API
- Senden Sie eine öffentliche Pinterest-Profil-URL mit genau einem Profilpfadsegment; Pin-Links, pin.it-Kurzlinks, Suchseiten und tiefere Pfade bestehen die Profilvalidierung nicht.
- Berechnen Sie die angeforderte Tiefe und die Credit-Schätzung vor der Anfrage als Anzahl der urls multipliziert mit results_limit, da das Limit für jedes Profil einzeln gilt.
- Speichern Sie discovery_input und collected_at mit jedem Pin, damit nachgelagerte Datensätze das übermittelte Profil und den Beobachtungszeitpunkt behalten.
- Behandeln Sie Medien, created_at, Kategorien, Hashtags, source, Autorenangaben und einzelne Kennzahlen als optional und schließen Sie nicht darauf, ob ein Pin erstellt oder gespeichert wurde, wenn keine Klassifizierung zurückgegeben wird.
Verwandte APIs
Ergänzend zur Pinterest User Pins 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 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.