Volver a las API
Datos públicos de Pinterest

Pinterest Public Data API

Obtenga datos de perfiles públicos de Pinterest, resuelva Pins conocidos, recopile Pins de perfiles seleccionados o busque por palabra clave para investigar creadores de contenido, contenidos y tendencias visuales.

API de Pinterest disponibles

Use Profiles para los datos de una cuenta, Pins para un Pin conocido, User Pins para el contenido de perfiles seleccionados o Search para descubrir Pins por palabra clave.

¿Qué datos de Pinterest se pueden obtener?

SocQ devuelve registros públicos normalizados de cuentas y Pins, con contexto de identidad, contenido, multimedia, clasificación, descubrimiento, interacción y momento de recopilación.

Detalles de perfiles públicos

Obtenga ID de perfil, nombres de usuario, nombres visibles, biografías, imágenes, sitios web vinculados, contexto de país y conteos visibles de la cuenta.

Contenido y multimedia de los Pins

Obtenga la identidad del Pin, su título, su texto, los datos del creador, las referencias multimedia, la fecha de publicación y las métricas visibles cuando estén disponibles.

Colecciones de Pins por creador

Explore un conjunto acotado de Pins públicos a partir de URL de perfiles seleccionados y mantenga cada resultado vinculado al perfil enviado.

Temas y clasificación

Busque Pins por palabra clave y conserve, cuando estén disponibles, el tipo de publicación, las categorías, los hashtags, los datos de origen y la entrada de descubrimiento.

SocQ vs Pinterest API

SocQ se centra en la recopilación compatible de datos públicos de Pinterest. La API oficial de Pinterest está diseñada para integraciones autenticadas de contenido, publicidad, analítica y catálogos.

FuncionalidadSocQPinterest API
Uso principalRecopilar perfiles públicos, Pins, Pins de usuarios y resultados de búsquedaAdministrar contenido, anuncios, analítica y catálogos autorizados
OAuth del clienteClave de API de SocQ; sin OAuth de Pinterest del clienteApp de Pinterest, token de acceso y scopes requeridos
Entrada inicialURL pública de un perfil o de un Pin, o una consulta de textoContexto de cuenta autorizado e ID de recursos de Pinterest
Crear o administrar PinsNo compatibleCompatible en nombre de un usuario autenticado con scopes de escritura
Formato de respuestaRegistros normalizados de SocQObjetos nativos de Pinterest API

Cómo funciona la API de Pinterest

Las cuatro API de Pinterest usan el mismo flujo de tarea asíncrona y resultados paginados.

  1. 1. Enviar la entrada

    Envíe URL de perfiles, URL de Pins o una consulta de búsqueda a la API correspondiente y guarde el task_id devuelto.

  2. 2. Seguir la tarea

    Consulte /v1/tasks/{task_id} hasta que el procesamiento termine.

  3. 3. Obtener los resultados

    Lea data.results.items y use next_cursor mientras has_more sea true.

Buscar Pins públicos por palabra clave

Autentíquese con su clave de API de SocQ y envíe una consulta de texto. Profiles, Pins y User Pins usan el mismo flujo de tarea.

curl -X POST "https://api.socq.ai/v1/pinterest/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"home office ideas","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 frecuentes de la API de Pinterest

Investigación de creadores y perfiles

Enriquezca URL de perfiles conocidos con identidad pública, biografía, sitio web, contexto de país, conteos visibles y momento de recopilación.

Análisis de Pins conocidos

Convierta URL de Pins seleccionados en contenido, creador, multimedia, taxonomía, marcas de tiempo, métricas visibles y enlaces de origen.

Monitoreo del contenido de creadores

Recopile conjuntos acotados de Pins de perfiles seleccionados y compare el contenido y las instantáneas de cuenta al momento de la recopilación.

Investigación de temas y tendencias visuales

Busque palabras clave definidas para crear conjuntos de datos estructurados de Pins con contexto de creador, multimedia, clasificación y descubrimiento.

Límites y política de datos públicos

Los resultados de Pinterest son registros públicos de un momento determinado. Estas API no acceden a contenido privado ni crean, editan, guardan o administran perfiles y Pins.

  • Profiles requiere una URL de perfil con un solo segmento de ruta de nombre de usuario. Devuelve datos de la cuenta, no tableros, Pins ni listas de miembros de la audiencia.
  • Pins requiere una URL pública /pin/{id} conocida o un enlace pin.it, y no convierte un perfil en una colección de Pins.
  • User Pins requiere URL de perfiles públicos. results_limit tiene un valor predeterminado de 100, admite de 1 a 2,000 y se aplica por separado a cada perfil.
  • Search requiere una sola consulta de texto. results_limit tiene un valor predeterminado de 100 y admite de 1 a 2,000; no se exponen el orden ni filtros adicionales.
  • Los campos opcionales de identidad, contenido, multimedia, clasificación, origen, marca de tiempo y métricas pueden ser null o estar vacíos cuando la fuente pública no los expone.
  • Las API son de solo lectura y no crean, editan, guardan ni administran perfiles, tableros o Pins de Pinterest.

Preguntas frecuentes sobre la API de Pinterest

¿Qué es la API de Pinterest?

La API de Pinterest es un conjunto de endpoints de SocQ para obtener datos de perfiles públicos, resolver Pins conocidos, recopilar Pins de perfiles seleccionados y buscar Pins públicos por palabra clave.

¿Qué API de Pinterest debo usar?

Use Profiles para los datos de una cuenta, Pins para enlaces /pin/{id} o pin.it conocidos, User Pins para una colección acotada a partir de URL de perfiles y Search para el descubrimiento por palabra clave.

¿Profiles y User Pins devuelven los mismos datos?

No. Profiles devuelve metadatos de la cuenta y conteos agregados, mientras que User Pins devuelve registros normalizados de Pins encontrados a partir de las URL de perfiles enviadas.

¿Cómo funciona el límite de resultados de User Pins?

results_limit tiene un valor predeterminado de 100, admite enteros de 1 a 2,000 y se aplica por separado a cada URL de perfil.

¿Por qué los campos pueden ser null o estar vacíos?

Es posible que un perfil o un Pin público no exponga todos los valores de identidad, contenido, multimedia, taxonomía, origen, marca de tiempo o métricas en el momento de la recopilación.

¿Cuánto cuesta la recopilación de datos de Pinterest?

Cada perfil devuelto o cada Pin de Search cuesta 0.6 créditos, mientras que cada Pin devuelto por Pins o User Pins cuesta 0.5 créditos. Los conjuntos de resultados vacíos no tienen cargo por resultado.

Reúna en un mismo flujo de trabajo perfiles públicos, contenido y datos de interacción de distintas plataformas para dar seguimiento a marcas, creadores y temas, y para realizar monitoreo y análisis entre plataformas con más eficiencia.