Pinterest Board Pins
Die Pins eines Pinterest-Boards sind die Bilder, die jemand rund um eine Idee gesammelt hat, jeweils mit kurzem Titel oder Beschreibung, dem Konto, das sie gemerkt hat, und dem Originalbild in voller Breite und Höhe. In der Reihenfolge des Boards zusammengenommen, bilden sie eine fertige visuelle Referenzsammlung für Moodboards, Designrecherche, Bilddatensätze und das Beobachten, wie sich eine kuratierte Sammlung verändert.
Funktionen der Pinterest Board Pins API
- Pins in Board-ReihenfolgeDie Zeilen folgen der Abfolge, die das Board selbst zeigt, sodass sich die Sammlung so liest, wie ihr Kurator sie angeordnet hat.
- Originalbild plus Vorschaubildmedia.url verweist auf das Bild in voller Größe und media.thumbnail_url auf eine kleine Vorschau, mit Breite und Höhe in Pixeln für jede Datei.
- Wer es gemerkt hat und was es zeigtauthor nennt das Konto, das jeden Pin gemerkt hat, mit Benutzername, Anzeigename, Profillink und Avatar, und text enthält Titel oder Beschreibung des Pins.
- Ein Link zurück zu jedem Pinurl ist die eigene Seite des Pins, gebildet aus seiner id, sodass sich jedes Bild der Sammlung bis zu seinem Platz auf Pinterest zurückverfolgen lässt.
- Bis zu 1.000 Pins aus jedem Boardresults_limit gilt pro Board, liegt standardmäßig bei 50 und akzeptiert bis zu 1.000, und mehrere Boards lassen sich gemeinsam in urls senden.
Parameter der Pinterest Board Pins API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Pinterest-Board-Links in der Form /{username}/{board}/, etwa https://www.pinterest.com/lizmrodgers/moms-night/. |
results_limit | Optional | Höchstzahl der Pins pro Board, eine Ganzzahl von 1 bis 1000. Standardwert 50. |
So verwenden Sie die Pinterest Board Pins API
Senden Sie Board-Links, warten Sie auf die Aufgabe und lesen Sie die Pins Seite für Seite.
- Senden Sie die Board-Links in urls per POST an /v1/pinterest/board, dazu results_limit, wenn Sie mehr als 50 Pins pro Board brauchen.
- Fragen Sie GET /v1/tasks/{task_id} mit der erhaltenen task_id ab, bis die Aufgabe erfolgreich ist.
- Entnehmen Sie die Pins aus results.items und rufen Sie mit results.next_cursor weiter ab, solange has_more true ist.
curl -X POST "https://api.socq.ai/v1/pinterest/board" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.pinterest.com/lizmrodgers/moms-night/"],"results_limit":50}'
# 0.5 credits per pin; boards that do not exist return no pins.Anwendungsfälle der Pinterest Board Pins API
- Die Bilder eines Boards herunterladen: Speichern Sie jede media.url eines Boards, um eine lokale Referenzbibliothek der Originaldateien aufzubauen, und sortieren Sie Hoch- und Querformate anhand von width und height.
- Einen beschrifteten Bilddatensatz aufbauen: Verknüpfen Sie jedes Bild mit dem text des Pins und dem Board, aus dem es stammt, um beschriftete Beispiele für Designrecherche oder Modelltraining zusammenzustellen.
- Das Saison-Board eines Wettbewerbers beobachten: Sammeln Sie dasselbe Board jede Woche und vergleichen Sie die Pin-ids mit dem letzten Lauf, um genau zu sehen, was hinzugekommen ist.
- Quellen in einem Moodboard angeben: Bewahren Sie author.username und die Pin-url neben jedem Bild auf, damit jedes Bild einer Präsentation mit Quelle versehen und erneut geöffnet werden kann.
Profi-Tipps zur Pinterest Board Pins API
- Verwenden Sie den zweiteiligen Link des Boards selbst; Profil-Tabs wie /{username}/_saved/ oder /{username}/pins/, tiefere Abschnittspfade und pin.it-Kurzlinks werden abgelehnt, öffnen Sie also das Board und kopieren Sie seine Adresse.
- Prüfen Sie vorher metrics.pins_count des Boards mit der Pinterest User Boards API und setzen Sie results_limit passend, damit ein großes Board nicht beim Standardwert 50 abgeschnitten wird.
- Laden Sie thumbnail_url für Raster und Vorschauen und rufen Sie media.url nur für die Bilder ab, die Sie behalten, das spart bei Boards mit Hunderten von Pins Bandbreite.
Verwandte APIs
Ergänzend zur Pinterest Board 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 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 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 Topic API — Pinterest-Ideenseiten auslesen, um je Thema die monatliche Suchzahl, die Aktualisierungszeit und die vorgeschlagenen Unterthemen zu erhalten.