Pinterest Profiles
Los perfiles de Pinterest son páginas de cuenta públicas con nombres de usuario, nombres visibles, biografías, imágenes de perfil, sitios web vinculados y los conteos visibles de seguidores, seguidos, tableros y guardados. Estos campos de identidad y señales de la cuenta sirven para enriquecer perfiles, comparar cuentas públicas y monitorear a lo largo del tiempo.
Funcionalidades de la Pinterest Profiles API
- Alcance de URL de perfil públicoProcesa una o más URL de perfil de Pinterest admitidas y excluye los enlaces de Pin, los enlaces cortos, las páginas de búsqueda y otras rutas que no son de perfil.
- Identidad y presentación del perfilDevuelve el ID del perfil, la URL canónica, el nombre de usuario, el nombre visible, la biografía, la imagen de perfil y el sitio web vinculado en un solo registro normalizado.
- Conteos visibles de la cuentaMantiene los conteos disponibles de seguidores, seguidos, tableros y guardados como métricas separadas para comparar cuentas.
- Contexto de recopilación y de origenAdjunta collected_at junto con el código de país, la URL de la página de Pins creados, el valor de actualización del origen y la entrada de descubrimiento disponibles, sin mezclarlos con los campos de identidad.
Parámetros de la Pinterest Profiles API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista obligatoria de URL de perfiles públicos de Pinterest. Cada URL debe usar HTTP o HTTPS en un dominio de Pinterest y contener un segmento de ruta de nombre de usuario no reservado. |
Cómo usar la Pinterest Profiles API
Envíe URL de perfiles públicos conocidos, siga la tarea asíncrona y lea los registros normalizados de perfiles con paginación por cursor.
- Prepare una o más URL de perfiles públicos de Pinterest cuya ruta contenga un único segmento de nombre de usuario.
- Envíe los enlaces como urls a /v1/pinterest/profiles 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/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.pinterest.com/example/"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la Pinterest Profiles API
- Enriquecimiento de perfiles públicos: Agregue el nombre de usuario, el nombre visible, la biografía, la imagen de perfil, el sitio web y el contexto de país a los registros vinculados a URL de perfil conocidas.
- Comparación de la presencia de cuentas: Compare los conteos visibles de seguidores, seguidos, tableros y guardados en un conjunto seleccionado de perfiles públicos.
- Monitoreo de perfiles públicos: Almacene los campos de identidad y las métricas visibles con collected_at para comparar la presentación del perfil y las señales de la cuenta entre momentos de recopilación.
Consejos de expertos para la Pinterest Profiles API
- Use una URL completa de perfil de Pinterest con HTTP o HTTPS y un solo segmento de ruta de nombre de usuario; se rechazan pin.it, /pin/, /search/ y otras rutas reservadas.
- Normalice las URL enviadas y deduplique los perfiles devueltos por id cuando esté disponible, usando url como clave estable alternativa.
- Trate la biografía, la imagen, el sitio web, el código de país, el valor de actualización del origen, la URL de la página de Pins creados y cada métrica como campos opcionales.
- Conserve collected_at junto a los conteos visibles de la cuenta para que las ejecuciones posteriores se distingan como instantáneas públicas independientes.
- Use Pinterest User Pins API cuando necesite registros de Pins de un perfil; este endpoint devuelve metadatos y conteos del perfil, no tableros, Pins ni listas de audiencia.
APIs relacionadas
Además de la Pinterest Profiles 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 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.