PinterestTableros de PinterestTemas de PinterestGuía de API

API de tableros de Pinterest: lista tableros, recopila sus Pins y mide temas

Tres nuevos endpoints de Pinterest en SocQ: los tableros de un perfil con sus contadores, los Pins guardados en un tablero y las búsquedas mensuales de un tema con sus subtemas. Solicitudes, campos y precios por resultado.

SocQActualizado el 19 de noviembre de 20267 min de lectura

Los primeros endpoints de Pinterest de SocQ leen perfiles, Pins individuales, los Pins de un usuario y resultados de búsqueda. El 2026-11-17 se publicaron tres más, que trabajan a otro nivel: tableros y temas. Los tableros muestran cómo una marca o un creador organiza sus ideas; los temas muestran cuántas personas buscan una idea y qué ideas más específicas se agrupan bajo ella.

Esta guía explica qué devuelve cada nuevo endpoint, cómo es la solicitud, el precio y cómo encajan los tres. Si está comparando proveedores de datos de Pinterest en general, consulte Las 7 mejores API de scraping de Pinterest.

Respuesta rápida: envíe URLs de perfiles, tableros o páginas de ideas de Pinterest en urls a POST /v1/pinterest/user-boards, /board o /topic con Authorization: Bearer $SOCQ_API_KEY. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded y luego lea data.results.items. Los tres cuestan 0.5 créditos por resultado ($0.0025 a $0.005 por crédito), sin tarifa base.

Los tres nuevos endpoints de Pinterest

EndpointQué devuelveEntradaPrecio
User BoardsLos tableros públicos de un perfil con nombre, descripción, portada, propietario, fecha de creación y contadores de Pins, seguidores, secciones y colaboradoresURLs de perfiles0.5 créditos ($0.0025) por tablero
Board PinsLos Pins de un tablero, en el orden del tablero, con descripción, quién lo guardó, imagen a tamaño completo y enlace al PinURLs de tableros0.5 créditos ($0.0025) por Pin
TopicEl número de búsquedas mensuales de un tema y los subtemas que sugiere PinterestURLs de páginas de ideas0.5 créditos ($0.0025) por tema

Pinterest User Boards: auditar un perfil

La Pinterest User Boards API lista todos los tableros públicos de un perfil de Pinterest. Cada tablero incluye nombre, descripción, imagen de portada, propietario, fecha de creación y contadores de Pins, seguidores, secciones y colaboradores, además de un indicador is_collaborative para los tableros en los que otras cuentas pueden añadir Pins. Es la primera llamada cuando audita el Pinterest de un competidor o preselecciona creadores por tema: los contadores muestran en qué temas invierte una cuenta y qué colecciones sigue realmente la gente.

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
  }'

Use URLs de perfil como https://www.pinterest.com/username/. results_limit se aplica a cada perfil, vale 25 por defecto y acepta de 1 a 500. Los contadores del tablero están en metrics: pins_count, followers_count, sections_count y collaborators_count. Consulte la documentación de User Boards.

Pinterest Board Pins: recopilar el contenido de un tablero

La Pinterest Board Pins API devuelve los Pins de un tablero, en el orden en que el tablero los muestra. Cada Pin incluye su título o descripción, la cuenta que lo guardó, la imagen a tamaño completo (con una miniatura y las dimensiones en media) y su URL. Úsela con un tablero curado de su nicho para reunir imágenes de referencia, seguir lo que un competidor va añadiendo a un tablero de temporada o construir de una vez un conjunto de datos tipo mood board.

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
  }'

Use URLs de tablero con el formato /{username}/{board}/. results_limit se aplica a cada tablero, vale 50 por defecto y acepta de 1 a 1,000. Consulte la documentación de Board Pins.

Pinterest Topic: investigación de palabras clave para Pinterest

La Pinterest Topic API dimensiona un tema antes de crear contenido para él. Para cada página de ideas obtiene el número de búsquedas mensuales que informa Pinterest (search_count) y los subtemas que sugiere debajo (related_topics, cada uno con un nombre, una etiqueta corta y la URL de su propia página de ideas), como los estilos, ocasiones y materiales que la gente combina con la idea principal.

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/"]
  }'

Use URLs de páginas de ideas con el formato /ideas/{topic}/{id}/. Cada tema devuelve una fila. Como cada subtema incluye su propia URL, puede volver a enviar esas URLs al mismo endpoint para comparar la demanda entre enfoques de cola larga. Consulte la documentación de Topic.

Cómo encajan los tres endpoints

Un estudio típico de competidores o de nicho los encadena:

  1. User Boards sobre el perfil de un competidor para ver qué tableros tienen más seguidores y Pins.
  2. Board Pins sobre los tableros relevantes para recopilar las imágenes y descripciones que contienen.
  3. Topic sobre las páginas de ideas de esos temas para comprobar la demanda de búsqueda mensual y encontrar enfoques más específicos.

Para Pins individuales, los Pins propios de un usuario o resultados de búsqueda por palabra clave, use los endpoints anteriores Pins, User Pins y Search. Todos los endpoints de Pinterest aparecen en la página de la plataforma Pinterest.

Autenticación y flujo de tareas asíncronas

Cada solicitud lleva su clave de API y un tipo de contenido JSON:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Cada llamada de envío inicia una tarea en segundo plano:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

La respuesta del envío devuelve data.task_id y data.status. Consulte la tarea con la misma clave:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Mientras la tarea está en queued, running o failed, la respuesta solo contiene metadatos de la tarea; en failed, lea error_message. Cuando está en succeeded, la misma respuesta incluye la primera página de registros normalizados en data.results.items. limit vale 50 por defecto y llega hasta 500. Si has_more es true, pase results.next_cursor como cursor para leer la página siguiente. fields acepta hasta 50 campos o rutas con puntos separados por comas cuando solo necesita algunas columnas, por ejemplo name,metrics.followers_count para tableros.

Un tiempo de espera agotado en el cliente no cancela la tarea, así que reanude con el mismo task_id en lugar de enviarla de nuevo y pagar por un duplicado. Para evitar las consultas periódicas, añada callback_url al cuerpo del envío; SocQ envía un POST con un resumen de la tarea cuando esta termina, y usted lee los registros desde el endpoint de la tarea.

Cuánto cuesta un trabajo típico

  • Listar 25 tableros de un perfil: 25 × 0.5 = 12.5 créditos, $0.0625.
  • Recopilar 1,000 Pins de un tablero: 500 créditos, $2.50.
  • Consultar 20 temas: 10 créditos, $0.05.

Como results_limit se aplica por perfil o por tablero, una solicitud con varias URLs puede devolver hasta ese número de filas para cada una. Fije el límite teniendo en cuenta el número de URLs.

Preguntas frecuentes

¿User Boards devuelve tableros privados o secretos?

No. Lista los tableros públicos de un perfil.

¿Qué significa el número de búsquedas de Topic?

search_count es el número de búsquedas mensuales que Pinterest informa para la página de ideas. updated_at es el momento en que Pinterest actualizó el tema por última vez.

¿Puedo obtener los Pins de varios tableros en una sola solicitud?

Sí. Ponga varias URLs de tableros en urls. results_limit se aplica a cada tablero por separado, y cada Pin devuelto cuesta 0.5 créditos.

¿Pago si un tablero está vacío?

No hay tarifa base, así que solo paga por los tableros, Pins o temas devueltos.

¿Dónde se publican los precios de Pinterest?

Cada página de producto muestra su tarifa, y la página de precios indica la tarifa vigente en créditos de cada API de SocQ.

PINTEREST API

Probar el flujo de trabajo con una URL pública de Pinterest

Envíe entradas públicas y reciba registros normalizados con contexto de origen rastreable.

Ver las API de Pinterest