pinterest/
pins

Recopile Pins públicos de Pinterest a partir de URL directas de Pin o enlaces pin.it, con contenido, datos del creador, contenido multimedia, fechas y métricas visibles como registros normalizados.

Pinterest Pins API

Entrada de URL de Pin
Contexto del creador y multimedia
Instantánea de métricas visibles
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 Pins

Los Pins de Pinterest son publicaciones visuales públicas con títulos, descripciones, datos del creador, referencias de imagen o video, categorías, hashtags e interacción visible. Estos registros sirven para archivar contenido seleccionado, investigar creatividades y temas, atribuir autoría y comparar en el momento de la recopilación.

Funcionalidades de la Pinterest Pins API

  • URL de Pin directas y cortasProcesa una o más URL públicas /pin/{id} de Pinterest o enlaces cortos pin.it, manteniendo la recopilación limitada a los Pins enviados.
  • Campos de contenido y creador conectadosDevuelve el título y el texto del Pin junto con la URL de origen, la identidad pública del creador, la URL del perfil y las referencias normalizadas de imagen o video.
  • Métricas visibles con hora de observaciónConserva los conteos disponibles de Me gusta y comentarios, además de los seguidores del creador, junto con collected_at, de modo que los valores públicos cambiantes tengan una hora de instantánea clara.
  • Contexto de clasificación del PinPreserva en extra los valores disponibles de post_type, categorías y hashtags para analizar formatos y temas sin mezclarlos con el texto del Pin.

Parámetros de la Pinterest Pins API

ParámetrosObligatorioDescripción
urlsObligatorioLista obligatoria de URL públicas /pin/{id} de Pinterest o enlaces cortos pin.it. Se rechazan otras rutas de Pinterest y los hosts que no son de Pinterest.

Cómo usar la Pinterest Pins API

Envíe los Pins públicos exactos que necesita, siga la tarea asíncrona y lea los registros normalizados de Pins con paginación por cursor.

  1. Prepare una o más URL públicas /pin/{id} de Pinterest o enlaces cortos pin.it.
  2. Envíe los enlaces como urls a /v1/pinterest/pins y guarde el task_id.
  3. Consulte /v1/tasks/{task_id} hasta que el procesamiento tenga éxito o devuelva un error.
  4. Lea data.results.items y solicite la página siguiente con next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/pinterest/pins" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.pinterest.com/pin/123456789/"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso de la Pinterest Pins API

  • Archivo de Pins seleccionados: Preserve los ID de Pin, las URL de origen, los títulos, el texto, los campos del creador, las referencias multimedia y la hora de publicación de una lista de URL definida.
  • Revisión de creatividades y temas: Use el tipo de contenido multimedia, post_type, las categorías, los hashtags, los títulos y el texto para comparar formatos y temas entre Pins seleccionados.
  • Comparación de señales en el momento de la recopilación: Compare los conteos visibles de Me gusta y comentarios junto con el contexto de seguidores del creador, usando collected_at para anclar cada observación.

Consejos de expertos para la Pinterest Pins API

  • Use una URL pública /pin/{id} o un enlace pin.it en cada elemento; los perfiles, las búsquedas, las ideas y otras rutas de Pinterest no cumplen la regla de entrada de este endpoint.
  • Deduplique los valores id devueltos cuando un enlace directo y uno acortado puedan resolverse al mismo Pin.
  • Trate los campos media, created_at, categories, hashtags, post_type y cada métrica como opcionales, porque un Pin público puede no exponer todos los valores.
  • Almacene collected_at junto a las métricas visibles para que las ejecuciones posteriores se interpreten como instantáneas independientes del momento de la recopilación.

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

  • 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.
  • 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 Pins API — FAQ

Pinterest Pins API obtiene registros de Pins públicos a partir de URL directas de Pin de Pinterest o enlaces cortos admitidos que usted envía. Devuelve el contenido, los datos del creador, el contenido multimedia, las fechas, las categorías, los hashtags y las métricas visibles, todo normalizado.

Envíe una URL HTTP o HTTPS de un dominio de Pinterest cuya ruta comience con /pin/{id}, o use un enlace corto pin.it. Se rechazan los perfiles, las búsquedas, las ideas y otras rutas.

No. El endpoint resuelve únicamente los enlaces públicos de Pin admitidos en urls y no expande el perfil de un creador en un feed.

El arreglo media normalizado puede contener referencias públicas de imagen o video. Permanece vacío cuando el registro de origen no expone una URL multimedia utilizable.

Un Pin público puede no exponer el contenido multimedia, la hora de publicación, las categorías, los hashtags, el tipo de publicación ni todas las métricas visibles, por lo que los valores opcionales pueden ser null o estar vacíos.

Cada registro de Pin de un resultado completado cuesta 0.5 créditos de SocQ. Un conjunto de resultados vacío no tiene cargo por resultados.