pinterest/
board

Recopile los Pins de tableros de Pinterest a partir de sus URL, en el orden del tablero, con el texto del Pin, la cuenta que lo guardó, la imagen en tamaño completo y la miniatura con sus medidas, y el enlace del Pin.

Pinterest Board Pins API

URL del tablero
Pins en el orden del tablero
URL de imágenes en tamaño completo
Hasta 1,000 Pins por tablero
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 Board Pins

Los Pins de un tablero de Pinterest son las imágenes que alguien ha reunido en torno a una idea, cada una con un título o descripción breve, la cuenta que la guardó y la imagen original con su ancho y alto completos. En conjunto y en el orden en que los presenta el tablero, forman un set de referencias visuales listo para moodboards, investigación de diseño, conjuntos de datos de imágenes y el seguimiento de cómo cambia una colección curada.

Funcionalidades de la Pinterest Board Pins API

  • Pins en el orden del tableroLas filas siguen la secuencia que muestra el propio tablero, así que la colección se lee tal como la organizó quien la cura.
  • Imagen original y miniaturamedia.url apunta a la imagen en tamaño completo y media.thumbnail_url a una vista previa pequeña, con ancho y alto en píxeles para cada archivo.
  • Quién lo guardó y qué diceauthor identifica la cuenta que guardó cada Pin, con su nombre de usuario, nombre visible, enlace al perfil y avatar, y text lleva el título o la descripción del Pin.
  • Un enlace a cada Pinurl es la página propia del Pin, construida a partir de su id, de modo que cualquier imagen del conjunto se puede rastrear hasta su lugar en Pinterest.
  • Hasta 1,000 Pins de cada tableroresults_limit cuenta por tablero, vale 50 de forma predeterminada y acepta hasta 1,000, y se pueden enviar varios tableros juntos en urls.

Parámetros de la Pinterest Board Pins API

ParámetrosObligatorioDescripción
urlsObligatorioEnlaces de tableros de Pinterest con el formato /{username}/{board}/, como https://www.pinterest.com/lizmrodgers/moms-night/.
results_limitOpcionalCantidad máxima de Pins que se devuelven por tablero, un entero de 1 a 1,000. El valor predeterminado es 50.

Cómo usar la Pinterest Board Pins API

Envíe enlaces de tableros, espere a que termine la tarea y lea los Pins página por página.

  1. Envíe por POST a /v1/pinterest/board los enlaces de los tableros en urls, más results_limit si necesita más de 50 Pins por tablero.
  2. Consulte GET /v1/tasks/{task_id} con el task_id recibido hasta que la tarea termine con éxito.
  3. Tome los Pins de results.items y siga pidiendo páginas con results.next_cursor mientras has_more sea true.
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}'

# 0.5 credits per pin; boards that do not exist return no pins.

Casos de uso de la Pinterest Board Pins API

  • Descargar las imágenes de un tablero: Guarde cada media.url de un tablero para armar una biblioteca local de referencias con los archivos originales, y use width y height para separar las tomas verticales de las horizontales.
  • Armar un conjunto de imágenes con descripción: Combine cada imagen con el text del Pin y el tablero del que proviene para reunir ejemplos etiquetados para investigación de diseño o entrenamiento de modelos.
  • Vigilar el tablero de temporada de un competidor: Recopile el mismo tablero cada semana y compare los id de los Pins con la ejecución anterior para ver con exactitud qué se agregó.
  • Dar crédito a las fuentes de un moodboard: Conserve author.username y la url del Pin junto a cada imagen para que cada foto de una presentación pueda acreditarse y volver a abrirse.

Consejos de expertos para la Pinterest Board Pins API

  • Use el enlace de dos partes del propio tablero; las pestañas de perfil como /{username}/_saved/ o /{username}/pins/, las rutas de secciones más profundas y los enlaces cortos pin.it se rechazan, así que abra el tablero y copie su dirección.
  • Revise primero el metrics.pins_count del tablero con Pinterest User Boards API y ajuste results_limit a ese valor, para que un tablero grande no se corte en los 50 predeterminados.
  • Cargue thumbnail_url para cuadrículas y vistas previas y descargue media.url solo para las imágenes que conserve, lo que ahorra ancho de banda en tableros con cientos de Pins.

Además de la Pinterest Board Pins 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 Topic API — Lee URL de páginas de ideas de Pinterest para obtener las búsquedas mensuales de cada tema, su fecha de actualización y los temas más específicos sugeridos.

Explorar otras plataformas

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

Pinterest Board Pins API — FAQ

Pinterest Board Pins API es una interfaz programática para recopilar los Pins guardados en un tablero de Pinterest a partir de la URL del tablero. Devuelve el texto de cada Pin, la cuenta que lo guardó, su imagen en tamaño completo y su miniatura con medidas, y el enlace del Pin, en el orden en que los muestra el tablero.

Cada Pin incluye media.url, la dirección de su imagen en tamaño completo, que puede descargar con cualquier cliente HTTP. Fije results_limit en la cantidad de Pins del tablero, hasta 1,000, para cubrirlo completo.

author es la cuenta que guardó el Pin en el tablero, con su nombre de usuario, nombre visible, url del perfil y avatar.

Cada Pin cuesta 0.5 créditos, así que un tablero recopilado con los 50 Pins predeterminados cuesta 25 créditos y un tablero de 400 Pins cuesta 200.