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ámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista 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.
- Prepare una o más URL públicas /pin/{id} de Pinterest o enlaces cortos pin.it.
- Envíe los enlaces como urls a /v1/pinterest/pins y guarde el task_id.
- Consulte /v1/tasks/{task_id} hasta que el procesamiento tenga éxito o devuelva un error.
- 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 trueCasos 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.
APIs relacionadas
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.