Die ersten Pinterest-Endpunkte von SocQ lesen Profile, einzelne Pins, die Pins eines Nutzers und Suchergebnisse. Am 2026-11-17 sind drei weitere live gegangen, und sie arbeiten auf einer anderen Ebene: Pinnwände und Themen. Pinnwände zeigen, wie eine Marke oder ein Creator Ideen ordnet; Themen zeigen, wie viele Menschen nach einer Idee suchen und welche engeren Ideen darunter liegen.
Dieser Leitfaden erklärt, was jeder neue Endpunkt liefert, wie die Anfrage aussieht, was sie kostet und wie die drei zusammenspielen. Wenn Sie Anbieter von Pinterest-Daten allgemein vergleichen, lesen Sie 7 beste Pinterest Scraper APIs.
Kurze Antwort: Senden Sie URLs von Pinterest-Profilen, Pinnwänden oder Ideen-Seiten in
urlsanPOST /v1/pinterest/user-boards,/boardoder/topicmitAuthorization: Bearer $SOCQ_API_KEY. Fragen SieGET /v1/tasks/{task_id}ab, bisstatusden Wertsucceededhat, und lesen Sie danndata.results.items. Alle drei kosten 0,5 Credits pro Ergebnis ($0,0025 bei $0,005 pro Credit), ohne Grundgebühr.
Die drei neuen Pinterest-Endpunkte
| Endpunkt | Was er liefert | Eingabe | Preis |
|---|---|---|---|
| User Boards | Die öffentlichen Pinnwände eines Profils mit Name, Beschreibung, Titelbild, Inhaber, Erstellungsdatum sowie Zahl der Pins, Follower, Abschnitte und Mitwirkenden | Profil-URLs | 0,5 Credits ($0,0025) pro Pinnwand |
| Board Pins | Die Pins einer Pinnwand in der Reihenfolge der Pinnwand, mit Beschreibung, speicherndem Konto, Bild in voller Größe und Pin-Link | Pinnwand-URLs | 0,5 Credits ($0,0025) pro Pin |
| Topic | Die monatliche Suchzahl eines Themas und die engeren Themen, die Pinterest vorschlägt | URLs von Ideen-Seiten | 0,5 Credits ($0,0025) pro Thema |
Pinterest User Boards: ein Profil prüfen
Die Pinterest User Boards API listet alle öffentlichen Pinnwände eines Pinterest-Profils auf. Jede Pinnwand kommt mit Name, Beschreibung, Titelbild, Inhaber, Erstellungsdatum und Zahlen für Pins, Follower, Abschnitte und Mitwirkende sowie dem Flag is_collaborative für Pinnwände, auf denen andere Konten Pins hinzufügen können. Das ist der erste Aufruf, wenn Sie das Pinterest-Konto eines Wettbewerbers prüfen oder Creator nach Thema vorauswählen: Die Zahlen zeigen, in welche Themen ein Konto investiert und welchen Sammlungen tatsächlich gefolgt wird.
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
}'
Verwenden Sie Profil-URLs wie https://www.pinterest.com/username/. results_limit gilt pro Profil, ist standardmäßig 25 und akzeptiert 1 bis 500. Die Kennzahlen der Pinnwand stehen unter metrics: pins_count, followers_count, sections_count und collaborators_count. Siehe die Dokumentation zu User Boards.
Pinterest Board Pins: erfassen, was eine Pinnwand enthält
Die Pinterest Board Pins API liefert die Pins einer Pinnwand in der Reihenfolge, in der die Pinnwand sie zeigt. Jeder Pin enthält Titel oder Beschreibung, das Konto, das ihn gespeichert hat, das Bild in voller Größe (mit Vorschaubild und Abmessungen unter media) und seine Pin-URL. Richten Sie den Endpunkt auf eine kuratierte Pinnwand Ihrer Nische, um Referenzbilder zu sammeln, zu verfolgen, was ein Wettbewerber einer saisonalen Pinnwand hinzufügt, oder einen Moodboard-Datensatz in einem Durchgang aufzubauen.
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
}'
Verwenden Sie Pinnwand-URLs in der Form /{username}/{board}/. results_limit gilt pro Pinnwand, ist standardmäßig 50 und akzeptiert 1 bis 1.000. Siehe die Dokumentation zu Board Pins.
Pinterest Topic: Keyword-Recherche für Pinterest
Die Pinterest Topic API bewertet ein Thema, bevor Sie Inhalte dafür erstellen. Für jede Ideen-Seite erhalten Sie die monatliche Suchzahl, die Pinterest meldet (search_count), und die darunter vorgeschlagenen engeren Themen (related_topics, jeweils mit Namen, kurzem Label und eigener URL der Ideen-Seite), etwa die Stile, Anlässe und Materialien, die Menschen mit der Hauptidee kombinieren.
curl -X POST "https://api.socq.ai/v1/pinterest/topic" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.pinterest.com/ideas/home-decor/935249274030/"]
}'
Verwenden Sie URLs von Ideen-Seiten in der Form /ideas/{topic}/{id}/. Jedes Thema liefert eine Zeile. Da jedes engere Thema mit eigener URL kommt, können Sie diese URLs wieder in denselben Endpunkt geben, um die Nachfrage über Long-Tail-Varianten hinweg zu vergleichen. Siehe die Dokumentation zu Topic.
Wie die drei Endpunkte zusammenspielen
Eine typische Wettbewerbs- oder Nischenanalyse verkettet sie:
- User Boards für das Profil eines Wettbewerbers, um zu sehen, welche Pinnwände die meisten Follower und Pins haben.
- Board Pins für die relevanten Pinnwände, um die darin enthaltenen Bilder und Beschreibungen zu erfassen.
- Topic für die Ideen-Seiten dieser Themen, um die monatliche Suchnachfrage zu prüfen und engere Varianten zu finden.
Für einzelne Pins, die eigenen Pins eines Nutzers oder Keyword-Suchergebnisse nutzen Sie die bisherigen Endpunkte Pins, User Pins und Search. Alle Pinterest-Endpunkte sind auf der Pinterest-Plattformseite aufgeführt.
Authentifizierung und asynchroner Aufgabenablauf
Jede Anfrage enthält Ihren API-Schlüssel und einen JSON-Content-Type:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Jeder Aufruf zum Einreichen startet eine Hintergrundaufgabe:
submit -> task_id -> queued -> running -> succeeded
\-> failed
Die Antwort auf das Einreichen liefert data.task_id und data.status. Fragen Sie die Aufgabe mit demselben Schlüssel ab:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Solange die Aufgabe queued, running oder failed ist, enthält die Antwort nur Aufgabenmetadaten; bei failed lesen Sie error_message. Bei succeeded enthält dieselbe Antwort die erste Seite normalisierter Datensätze in data.results.items. limit ist standardmäßig 50 und geht bis 500. Ist has_more true, übergeben Sie results.next_cursor als cursor, um die nächste Seite zu lesen. fields akzeptiert bis zu 50 kommagetrennte Felder oder Punktpfade, wenn Sie nur wenige Spalten brauchen, zum Beispiel name,metrics.followers_count für Pinnwände.
Eine Zeitüberschreitung auf Client-Seite bricht die Aufgabe nicht ab. Setzen Sie deshalb mit derselben task_id fort, statt ein Duplikat einzureichen und dafür zu bezahlen. Um das Abfragen zu sparen, ergänzen Sie callback_url im Anfragekörper; SocQ sendet nach Abschluss der Aufgabe einen POST mit einer Aufgabenzusammenfassung, und Sie lesen die Datensätze über den Aufgaben-Endpunkt.
Was ein typischer Auftrag kostet
- 25 Pinnwände eines Profils auflisten: 25 × 0,5 = 12,5 Credits, $0,0625.
- 1.000 Pins einer Pinnwand erfassen: 500 Credits, $2,50.
- 20 Themen prüfen: 10 Credits, $0,05.
Da results_limit pro Profil bzw. pro Pinnwand gilt, kann eine Anfrage mit mehreren URLs für jede davon bis zu so viele Zeilen liefern. Legen Sie das Limit mit Blick auf die Zahl der URLs fest.
FAQ
Liefert User Boards private oder geheime Pinnwände?
Nein. Der Endpunkt listet die öffentlichen Pinnwände eines Profils auf.
Was bedeutet die Suchzahl bei Topic?
search_count ist die monatliche Suchzahl, die Pinterest für die Ideen-Seite meldet. updated_at ist der Zeitpunkt, zu dem Pinterest das Thema zuletzt aktualisiert hat.
Kann ich die Pins mehrerer Pinnwände in einer Anfrage abrufen?
Ja. Tragen Sie mehrere Pinnwand-URLs in urls ein. results_limit gilt für jede Pinnwand separat, und jeder gelieferte Pin kostet 0,5 Credits.
Zahle ich, wenn eine Pinnwand leer ist?
Es gibt keine Grundgebühr, Sie zahlen also nur für die gelieferten Pinnwände, Pins oder Themen.
Wo sind die Pinterest-Preise aufgeführt?
Jede Landingpage zeigt ihren Tarif, und die Preisseite listet den aktuellen Credit-Tarif jeder SocQ-API.
PINTEREST API
Workflow mit einer öffentlichen Pinterest-URL testen
Senden Sie öffentliche Eingaben und erhalten Sie normalisierte Datensätze mit nachvollziehbarem Quellkontext.
Pinterest-APIs ansehen