Pinterest User Boards
Ein Pinterest-Board ist eine benannte Sammlung gemerkter Pins mit Beschreibung, Coverbild und Erstelldatum, dazu kommen die Zahl seiner Pins, Follower, Abschnitte und Mitwirkenden sowie eine Kennzeichnung, ob andere Konten etwas hinzufügen dürfen. Über ein ganzes Profil hinweg betrachtet, zeigen diese Boards, welche Themen das Konto am intensivsten kuratiert, welche Sammlungen eigene Follower gewinnen und wo es Beiträge anderer zulässt.
Funktionen der Pinterest User Boards API
- Jedes Board eines ProfilsSenden Sie einen oder mehrere Pinterest-Profillinks in urls, und jedes Board dieser Profile kommt als eigene Zeile mit id und url des Boards zurück.
- Umfang und Publikum jedes Boardsmetrics.pins_count zeigt, wie viel in einem Board gemerkt wurde, und metrics.followers_count, wie viele Menschen ihm folgen, was ein volles Archiv von einer Sammlung mit echtem Publikum unterscheidet.
- Gruppen-Boards und Abschnitteis_collaborative kennzeichnet Boards, denen andere Konten Pins hinzufügen können, metrics.collaborators_count nennt, wie viele das sind, und metrics.sections_count zeigt, wie fein ein Board unterteilt ist.
- Name, Beschreibung, Cover und Erstelldatumname, text und cover_url zeigen auf einen Blick, worum es in einem Board geht, und published_at hält fest, wann es angelegt wurde und das Thema damit ins Konto kam.
- Bis zu 500 Boards pro Profilresults_limit gilt für jedes Profil einzeln, liegt standardmäßig bei 25 und akzeptiert bis zu 500, sodass auch Konten mit Hunderten von Boards vollständig aufgelistet werden können.
Parameter der Pinterest User Boards API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Pinterest-Profillinks mit genau einem Benutzernamen im Pfad, etwa https://www.pinterest.com/marthastewart/; Länderdomains wie pinterest.co.uk oder de.pinterest.com funktionieren ebenfalls. |
results_limit | Optional | Höchstzahl der Boards pro Profil, eine Ganzzahl von 1 bis 500. Standardwert 25. |
So verwenden Sie die Pinterest User Boards API
Übergeben Sie Profillinks, warten Sie auf die Aufgabe und blättern Sie dann durch eine Zeile pro Board.
- Senden Sie die Profillinks und optional results_limit per POST an /v1/pinterest/user-boards und merken Sie sich die task_id aus der Antwort.
- Rufen Sie GET /v1/tasks/{task_id} alle paar Sekunden auf, bis status den Wert succeeded hat.
- Lesen Sie die Boards aus results.items; solange has_more true ist, rufen Sie die nächste Seite mit results.next_cursor ab.
curl -X POST "https://api.socq.ai/v1/pinterest/user-boards" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.pinterest.com/marthastewart/"],"results_limit":25}'
# Each board returned costs 0.5 credits.Anwendungsfälle der Pinterest User Boards API
- Die Pinterest-Themen eines Wettbewerbers analysieren: Stellen Sie name und text der Boards neben pins_count, um zu sehen, zu welchen Themen eine Marke laufend Pins merkt, und neben followers_count, um zu sehen, welchen dieser Sammlungen Menschen folgen.
- Creator nach Nische vorauswählen: Sammeln Sie die Boards infrage kommender Creator, gleichen Sie Namen und Beschreibungen mit Ihrem Thema ab und behalten Sie die Konten, die es über mehrere Boards hinweg kuratieren.
- Gruppen-Boards finden, bei denen sich das Mitmachen lohnt: Behalten Sie die Zeilen mit is_collaborative auf true und wägen Sie collaborators_count gegen followers_count ab, um gemeinsame Boards mit eigener Anhängerschaft auszuwählen.
- Verfolgen, welche Sammlungen wachsen: Sammeln Sie dieselben Profile regelmäßig erneut und vergleichen Sie pins_count und followers_count je Board-id, um zu sehen, welche Boards Pins oder Follower hinzugewinnen.
Profi-Tipps zur Pinterest User Boards API
- Kürzen Sie Board- und Pin-Links vor dem Senden auf die Profilwurzel, denn urls erwartet https://www.pinterest.com/{username}/; Board-Links gehören in die Pinterest Board Pins API.
- Erhöhen Sie results_limit über den Standardwert 25, wenn ein Profil mehr Boards hat; das Limit gilt pro Profil und berechnet werden nur tatsächlich gelieferte Boards.
- Gruppieren Sie die Zeilen nach author.username, wenn eine Aufgabe mehrere Profile umfasst, denn jedes Board enthält die Angaben des Kontos, dem es gehört.
- Übergeben Sie die url jedes Boards an die Pinterest Board Pins API, um seine Pins abzurufen, und legen Sie mit metrics.pins_count fest, wie hoch das results_limit dort sein sollte.
Verwandte APIs
Ergänzend zur Pinterest User Boards 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 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 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.