pinterest/
topic

Pinterest-Themen über die URLs ihrer Ideenseiten abrufen und für jedes Thema den Namen, die von Pinterest gemeldete monatliche Suchzahl, die Aktualisierungszeit und vorgeschlagene Unterthemen erhalten.

Pinterest Topic API

Ideenseiten-URL als Eingabe
Monatliche Suchzahl
Verwandte Themen mit Links
0,5 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

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

ParameterErforderlichBeschreibung
urlsErforderlichLinks 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.

  1. Kopieren Sie die Links der Ideenseiten aus Pinterest und senden Sie sie in urls per POST an /v1/pinterest/topic.
  2. Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
  3. 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.

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.

Weitere Plattformen entdecken

Kombinieren Sie Pinterest-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Pinterest Topic API — FAQ

Pinterest Topic API ist eine Programmierschnittstelle, die Pinterest-Themen anhand der URLs ihrer Ideenseiten ausliest. Sie liefert für jedes Thema den Namen, die von Pinterest gemeldete monatliche Suchzahl, den Zeitpunkt ihrer letzten Aktualisierung und die darunter vorgeschlagenen engeren Themen.

Es liefert die aktuelle monatliche Suchzahl, die Pinterest für jedes Thema meldet, zusammen mit dem Zeitpunkt ihrer Aktualisierung. Wenn Sie dieselben Themen regelmäßig sammeln, entsteht ein Verlauf, den Sie selbst als Diagramm darstellen können.

Ideenseiten liegen unter pinterest.com/ideas/ und enden mit einer numerischen id, wie in /ideas/home-decor/935249274030/. Jede Zeile liefert außerdem related_topics[].url, das bereits in der akzeptierten Form vorliegt.

name ist das vollständige Thema, etwa Christmas Home Decor, und label das kurze Schlagwort, das Pinterest dafür anzeigt, etwa Christmas.

Jedes gelieferte Thema kostet 0,5 Credits, die Abfrage von zehn Ideenseiten kostet also 5 Credits.