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ámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista 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_limit | Opcional | Má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.
- Prepare una o más URL de perfiles públicos de Pinterest con un único segmento de ruta de perfil.
- Envíe urls y, opcionalmente, results_limit por POST a /v1/pinterest/user-pins y almacene el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o devuelva un error.
- 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 trueCasos 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.
APIs relacionadas
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.