Pinterest Topic
Ein Pinterest-Thema ist eine Ideenseite, die Pins zu einem Motiv wie Home Decor bündelt, versehen mit der Zahl monatlicher Suchen, die Pinterest dafür meldet, dem Datum, an dem dieser Wert aktualisiert wurde, und einer Reihe engerer Themen wie Christmas- oder Thrifted-Varianten. Diese Zahlen zeigen, wie viel Nachfrage ein Motiv auf Pinterest hat, während die engeren Themen auf Stile, Anlässe und Materialien verweisen, die Menschen damit verbinden, und damit die Grundlage für Keyword-Recherche und Content-Planung bilden.
Funktionen der Pinterest Topic API
- Monatliche Suchzahl pro Themasearch_count ist die Zahl monatlicher Suchen, die Pinterest für das Thema meldet, ein direktes Maß dafür, wie oft Menschen danach suchen.
- Engere Themen mit eigenen Linksrelated_topics listet die von Pinterest vorgeschlagenen Unterthemen auf, jeweils mit vollem Namen, einem kurzen Label wie DIY und der url ihrer Ideenseite.
- Aktualisierungszeit des Wertsupdated_at hält fest, wann Pinterest das Thema zuletzt aktualisiert hat, damit Sie wissen, wie aktuell die Suchzahl ist.
- Viele Themen in einer Anfrageurls nimmt mehrere Ideenseiten auf einmal an, und jede liefert genau eine Zeile, zugeordnet über die Themen-id in der Seitenadresse.
Parameter der Pinterest Topic API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Links zu Pinterest-Ideenseiten in der Form /ideas/{topic}/{id}/ samt numerischer id, etwa https://www.pinterest.com/ideas/home-decor/935249274030/. |
So verwenden Sie die Pinterest Topic API
Übergeben Sie Links zu Ideenseiten und erhalten Sie eine Zeile pro Thema.
- Kopieren Sie die Links der Ideenseiten aus Pinterest und senden Sie sie in urls per POST an /v1/pinterest/topic.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
- Lesen Sie ein Thema pro Element in results.items; wenn has_more true ist, holen Sie den Rest mit results.next_cursor.
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/"]}'
# One row and 0.5 credits per topic.Anwendungsfälle der Pinterest Topic API
- Content-Ideen nach Nachfrage ordnen: Sammeln Sie search_count für eine Liste infrage kommender Themen und arbeiten Sie zuerst an denen, nach denen am meisten gesucht wird, bevor Sie Pins oder Boards planen.
- Long-Tail-Ansätze in einem breiten Motiv finden: Lesen Sie die Labels in related_topics, etwa Christmas, Thrifted oder Earthy Cottage unter Home Decor, um einen engeren Ansatz mit klarer Zielgruppe zu wählen.
- Einen eigenen Verlauf der Pinterest-Nachfrage führen: Sammeln Sie jeden Monat dieselben Themen und speichern Sie search_count mit updated_at, um darzustellen, wie sich das Interesse an jedem Motiv über die Zeit entwickelt.
Profi-Tipps zur Pinterest Topic API
- Behalten Sie die numerische id in jedem Link: /ideas/home-decor/935249274030/ wird akzeptiert, eine Adresse, die beim Themennamen endet, besteht die Validierung dagegen nicht.
- Erweitern Sie eine Nische Ebene für Ebene, indem Sie related_topics[].url als nächstes Paket senden, und lassen Sie bereits gesammelte Themen-ids weg, denn Zweige führen oft zu denselben Ideenseiten zurück.
- Vergleichen Sie search_count verschiedener Themen nur zusammen mit updated_at, denn jeder Wert stammt aus der letzten Aktualisierung des jeweiligen Themas.
Verwandte APIs
Ergänzend zur Pinterest Topic 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 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.