pinterest/
user-pins

Descubra Pins públicos de Pinterest a partir de una o más URL de perfil, con identidad del Pin, texto, datos del autor, contenido multimedia, interacción visible y contexto de origen como registros normalizados.

Pinterest User Pins API

Entrada de URL de perfil
Límite de resultados por perfil
Pins públicos normalizados
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 User Pins

Los Pins de usuario de Pinterest son publicaciones visuales públicas asociadas con un perfil y representadas por títulos, descripciones, datos del creador, referencias multimedia, categorías, hashtags, fechas e interacción visible. Estos campos de contenido y de observación sirven para archivar colecciones de perfiles, investigar temas visuales, atribuir el origen y comparar en el momento de la recopilación.

Funcionalidades de la Pinterest User Pins API

  • Descubrimiento de Pins basado en perfilesAcepta una o más URL de perfiles públicos de Pinterest y devuelve los registros de Pins asociados con cada perfil enviado, en lugar de los metadatos del perfil.
  • Profundidad de recopilación por perfilAplica results_limit por separado a cada URL de perfil, con un valor predeterminado de 100 y un rango aceptado de 1 a 2,000.
  • Registros normalizados de Pin, autor y contenido multimediaDevuelve los identificadores de Pin, las URL, los títulos, el texto, los campos públicos del autor y las referencias de imagen o video en una estructura de resultado coherente.
  • Contexto de interacción y de origenConserva los conteos visibles de Me gusta, comentarios y seguidores del creador junto con la hora de publicación, collected_at, los campos de clasificación y discovery_input, cuando están disponibles.

Parámetros de la Pinterest User Pins API

ParámetrosObligatorioDescripción
urlsObligatorioLista obligatoria de URL de perfiles públicos de Pinterest con HTTP o HTTPS y exactamente un segmento de ruta no reservado; se rechazan las URL de Pin, de búsqueda, de ideas y de pin.it.
results_limitOpcionalMáximo de Pins solicitados para cada URL de perfil; el valor predeterminado es 100 y acepta enteros de 1 a 2,000.

Cómo usar la Pinterest User Pins API

Envíe URL de perfiles públicos de Pinterest con un límite de resultados por perfil, siga la tarea asíncrona y lea los Pins normalizados con paginación por cursor.

  1. Prepare una o más URL de perfiles públicos de Pinterest con un único segmento de ruta de perfil.
  2. Envíe urls y, opcionalmente, results_limit por POST a /v1/pinterest/user-pins y almacene el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o devuelva un error.
  4. Lea data.results.items y solicite el next_cursor devuelto mientras has_more siga siendo true.
curl -X POST "https://api.socq.ai/v1/pinterest/user-pins" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.pinterest.com/example/"],"results_limit":100}'

# 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 User Pins API

  • Archivo de Pins de perfiles públicos: Preserve los ID de Pin, las URL de origen, los títulos, el texto, los campos del autor, las referencias multimedia, las fechas y discovery_input de URL de perfil definidas.
  • Investigación visual y de taxonomía: Use el tipo de contenido multimedia, post_type, las categorías, los hashtags, los títulos y el texto para examinar los formatos y temas recurrentes dentro de perfiles públicos seleccionados.
  • Comparación de señales entre perfiles: Compare los conteos visibles de Me gusta y comentarios con el contexto de seguidores del creador entre colecciones de perfiles, usando collected_at para anclar cada observación.

Consejos de expertos para la Pinterest User Pins API

  • Envíe una URL de perfil público de Pinterest con exactamente un segmento de ruta de perfil; los enlaces de Pin, los enlaces cortos pin.it, las páginas de búsqueda y las rutas más profundas no pasan la validación de perfil.
  • Calcule la profundidad solicitada y la estimación de créditos previa a la solicitud como la cantidad de urls multiplicada por results_limit, porque el límite se aplica por separado a cada perfil.
  • Almacene discovery_input y collected_at con cada Pin para que los conjuntos de datos posteriores conserven el perfil enviado y la hora de observación.
  • Trate media, created_at, categories, hashtags, source, los datos del autor y cada métrica como opcionales, y no infiera si un Pin fue creado o guardado cuando no se devuelve ninguna clasificación.

Además de la Pinterest User 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 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 User Pins API — FAQ

Pinterest User Pins API descubre registros de Pins públicos a partir de las URL de perfil de Pinterest enviadas. Devuelve la identidad del Pin, el texto, los autores, el contenido multimedia, la interacción visible, las fechas y el contexto de origen, todo normalizado, en lugar de registros de perfil.

Envíe una URL HTTP o HTTPS de un dominio de Pinterest admitido cuya ruta contenga exactamente un segmento de perfil no reservado, como /example/. Se rechazan las rutas de Pin, las páginas de búsqueda, las páginas de ideas, las rutas más profundas y los enlaces pin.it.

Los registros pueden incluir el ID del Pin, la URL, el título, el texto, los datos públicos del autor, las referencias de imagen o video, los conteos visibles de Me gusta, comentarios y seguidores, created_at, collected_at, y los campos extra de clasificación y descubrimiento. Los valores opcionales de origen pueden ser null o estar vacíos.

results_limit tiene un valor predeterminado de 100 y acepta enteros de 1 a 2,000. Se aplica a cada URL de perfil, por lo que dos URL con results_limit 50 solicitan hasta 100 Pins.

La respuesta normalizada no expone una clasificación estable entre creado y guardado. Trate los resultados como Pins públicos descubiertos desde la URL de perfil enviada, sin inferir el tipo de propiedad.

No. Este endpoint acepta únicamente URL de perfil y results_limit; no expone una URL de tablero, un identificador de tablero ni un parámetro de filtro por tablero.

Cada registro de Pin devuelto cuesta 0.5 créditos de SocQ. La estimación usa urls multiplicadas por results_limit, y un conjunto de resultados vacío no tiene cargo por resultados.