pinterest/
topic

Consulte temas de Pinterest a partir de las URL de sus páginas de ideas y obtenga el nombre de cada tema, la cantidad de búsquedas mensuales que reporta Pinterest, la hora de actualización y los temas más específicos sugeridos.

Pinterest Topic API

URL de la página de ideas
Búsquedas mensuales
Temas relacionados con enlaces
0.5 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

Pinterest Topic

Un tema de Pinterest es una página de ideas que agrupa Pins en torno a un asunto, como home decor, acompañada de la cantidad de búsquedas mensuales que Pinterest reporta para él, la fecha en que se actualizó esa cifra y un conjunto de temas más específicos como las variantes Christmas o Thrifted. Esas cifras muestran cuánta demanda tiene un asunto en Pinterest, y los temas más específicos señalan los estilos, ocasiones y materiales que la gente asocia con él, la base para investigar palabras clave y planificar contenido.

Funcionalidades de la Pinterest Topic API

  • Búsquedas mensuales por temasearch_count es la cantidad de búsquedas mensuales que Pinterest reporta para el tema, una medida directa de cuántas veces lo busca la gente.
  • Temas más específicos con enlace propiorelated_topics enumera los subtemas que sugiere Pinterest, cada uno con su nombre completo, una etiqueta corta como DIY y la url de su página de ideas.
  • Fecha de actualización de la cifraupdated_at registra cuándo actualizó Pinterest el tema por última vez, para saber qué tan vigente es la cantidad de búsquedas.
  • Muchos temas en una solicitudurls recibe varias páginas de ideas a la vez y cada una devuelve exactamente una fila, identificada por el id del tema que aparece en la dirección de la página.

Parámetros de la Pinterest Topic API

ParámetrosObligatorioDescripción
urlsObligatorioEnlaces de páginas de ideas de Pinterest con el formato /ideas/{topic}/{id}/, incluido el id numérico, como https://www.pinterest.com/ideas/home-decor/935249274030/.

Cómo usar la Pinterest Topic API

Envíe enlaces de páginas de ideas y reciba una fila por tema.

  1. Copie los enlaces de las páginas de ideas de Pinterest y envíelos en urls por POST a /v1/pinterest/topic.
  2. Consulte GET /v1/tasks/{task_id} hasta que status indique succeeded.
  3. Lea un tema por elemento en results.items; si has_more es true, obtenga el resto con 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.

Casos de uso de la Pinterest Topic API

  • Priorizar ideas de contenido según la demanda: Reúna el search_count de una lista de temas candidatos y trabaje primero en los que más busca la gente antes de planificar Pins o tableros.
  • Encontrar ángulos de cola larga dentro de un tema amplio: Lea las etiquetas de related_topics, como Christmas, Thrifted o Earthy Cottage dentro de home decor, para elegir un ángulo más específico con una audiencia clara.
  • Llevar su propio historial de demanda en Pinterest: Recopile los mismos temas cada mes y guarde search_count con updated_at para graficar cómo se mueve el interés en cada asunto con el tiempo.

Consejos de expertos para la Pinterest Topic API

  • Conserve el id numérico en cada enlace: /ideas/home-decor/935249274030/ se acepta, mientras que una dirección que termina en el nombre del tema no pasa la validación.
  • Explore un nicho nivel por nivel enviando related_topics[].url como el siguiente lote, y descarte los id de temas que ya recopiló, ya que las ramas suelen llevar de vuelta a las mismas páginas de ideas.
  • Compare search_count entre temas siempre junto con updated_at, porque cada cifra corresponde a la última actualización de su propio tema.

Además de la Pinterest Topic API, use estas APIs cuando necesite otro tipo de datos públicos de Pinterest.

  • Pinterest Pins API — Convierte URLs de Pins públicos en contenido normalizado, creador, contenido multimedia, taxonomía, marcas de tiempo y métricas visibles.
  • Pinterest User Pins API — Descubre Pins públicos desde URLs de perfiles con un límite por perfil, y devuelve contenido normalizado, creador, contenido multimedia, marcas de tiempo y métricas visibles.
  • Pinterest Profiles API — Recolecta desde URLs de perfiles la identidad del perfil público, la biografía, la imagen, el sitio web, los conteos visibles de la cuenta y el contexto de recolección.
  • Pinterest Search API — Busca Pins públicos por consulta de texto con un límite de resultados, y devuelve contenido normalizado, creador, contenido multimedia, taxonomía, marcas de tiempo y métricas visibles.
  • Pinterest User Boards API — Lista los tableros de perfiles de Pinterest a partir de sus URL, con nombre, descripción, portada, fecha de creación y conteos de Pins, seguidores, secciones y colaboradores.
  • Pinterest Board Pins API — Recolecta los Pins de un tablero de Pinterest a partir de su URL y en el orden del tablero, con el texto del Pin, la cuenta que lo guardó, imágenes en tamaño completo y enlaces a cada Pin.

Explorar otras plataformas

Combine los datos de Pinterest con datos públicos de otras plataformas sociales compatibles.

Pinterest Topic API — FAQ

Pinterest Topic API es una interfaz programática para leer temas de Pinterest a partir de las URL de sus páginas de ideas. Devuelve el nombre de cada tema, la cantidad de búsquedas mensuales que reporta Pinterest, la hora de su última actualización y los temas más específicos sugeridos debajo de él.

Entrega la cantidad actual de búsquedas mensuales que Pinterest reporta para cada tema, junto con la hora en que se actualizó. Si recopila los mismos temas de forma periódica, arma un historial que puede graficar usted mismo.

Las páginas de ideas están bajo pinterest.com/ideas/ y terminan en un id numérico, como en /ideas/home-decor/935249274030/. Cada fila también devuelve related_topics[].url, que ya viene en el formato aceptado.

name es el tema completo, como Christmas Home Decor, y label es la etiqueta corta que Pinterest muestra para él, como Christmas.

Cada tema devuelto cuesta 0.5 créditos, así que consultar diez páginas de ideas cuesta 5 créditos.