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ámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Enlaces 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.
- Copie los enlaces de las páginas de ideas de Pinterest y envíelos en urls por POST a /v1/pinterest/topic.
- Consulte GET /v1/tasks/{task_id} hasta que status indique succeeded.
- 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.
APIs relacionadas
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.