pinterest/
profiles

Recopile perfiles públicos de Pinterest a partir de una o más URL de perfil, con identidad, biografía y sitio web, imágenes de perfil y conteos visibles de la cuenta como registros normalizados.

Pinterest Profiles API

Entrada de URL de perfil
Campos de identidad y sitio web
Métricas visibles de la cuenta
0.6 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 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ámetrosObligatorioDescripción
urlsObligatorioLista 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.

  1. Prepare una o más URL de perfiles públicos de Pinterest cuya ruta contenga un único segmento de nombre de usuario.
  2. Envíe los enlaces como urls a /v1/pinterest/profiles 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/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 true

Casos 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.

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.

Explorar otras plataformas

Combine los datos de Pinterest con datos públicos de otras plataformas sociales compatibles.

Pinterest Profiles API — FAQ

Pinterest Profiles API obtiene metadatos de perfiles públicos a partir de una o más URL de perfil de Pinterest admitidas. Devuelve la identidad, la biografía, la imagen de perfil, el sitio web, los conteos visibles de la cuenta y el contexto de recopilación, todo normalizado.

Envíe una URL completa HTTP o HTTPS de un dominio de Pinterest cuya ruta contenga un segmento de nombre de usuario no reservado. Se rechazan las URL de Pin, los enlaces pin.it, las páginas de búsqueda y las rutas reservadas como /ideas/ o /today/.

Los resultados pueden incluir el ID del perfil, la URL, el nombre de usuario, el nombre visible, la biografía, el avatar, el sitio web, los conteos de seguidores y seguidos, los conteos de tableros y guardados, la hora de recopilación, el código de país y la URL de una página de Pins creados.

No. Devuelve metadatos del perfil y conteos agregados visibles, no registros de tableros ni de Pins, ni los miembros de las listas de seguidores y seguidos; use Pinterest User Pins API cuando necesite los Pins descubiertos desde una URL de perfil.

Un perfil público puede no exponer una biografía, un sitio web, una imagen, un código de país, la URL de la página de Pins creados, el valor de actualización del origen ni todos los conteos visibles. Los clientes deben aceptar valores opcionales null o vacíos.

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