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ámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Enlaces de tableros de Pinterest con el formato /{username}/{board}/, como https://www.pinterest.com/lizmrodgers/moms-night/. |
results_limit | Opcional | Cantidad 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.
- 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.
- Consulte GET /v1/tasks/{task_id} con el task_id recibido hasta que la tarea termine con éxito.
- 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.
APIs relacionadas
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.