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.

pinterest/profiles
Perfiles0.6 créditos por resultado

pinterest/pins
Publicaciones0.5 créditos por resultado

pinterest/user-pins
Publicaciones0.5 créditos por resultado

pinterest/search
Búsqueda0.6 créditos por resultado

pinterest/user-boards
Perfiles0.5 créditos por resultado

pinterest/board
Publicaciones0.5 créditos por resultado

pinterest/topic
Búsqueda0.5 créditos por resultado
¿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.
| Funcionalidad | SocQ | Pinterest API |
|---|---|---|
| Uso principal | Recopilar perfiles públicos, Pins, Pins de usuarios y resultados de búsqueda | Administrar contenido, anuncios, analítica y catálogos autorizados |
| OAuth del cliente | Clave de API de SocQ; sin OAuth de Pinterest del cliente | App de Pinterest, token de acceso y scopes requeridos |
| Entrada inicial | URL pública de un perfil o de un Pin, o una consulta de texto | Contexto de cuenta autorizado e ID de recursos de Pinterest |
| Crear o administrar Pins | No compatible | Compatible en nombre de un usuario autenticado con scopes de escritura |
| Formato de respuesta | Registros normalizados de SocQ | Objetos 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. 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. Seguir la tarea
Consulte /v1/tasks/{task_id} hasta que el procesamiento termine.
3. Obtener los resultados
Lea data.results.items y use next_cursor mientras has_more sea true.
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 trueCasos 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.
Combine datos de varias plataformas para obtener información de negocio más completa
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.
Threads API
Obtenga perfiles públicos de Threads, resuelva publicaciones conocidas o recopile publicaciones de perfiles seleccionados con campos normalizados de identidad, contenido, multimedia, interacción y marca de tiempo.
Bluesky API
Obtenga perfiles públicos de Bluesky, resuelva URL de publicaciones conocidas o recopile una página de publicaciones de una cuenta con identidad, contenido, contenido multimedia, marcas de tiempo y campos visibles de interacción normalizados.
Snapchat API
Obtenga un Spotlight público conocido de Snapchat como un registro normalizado con los campos disponibles de creador, descripción, multimedia, audio, marca de tiempo, duración e interacción.
Twitch API
Convierta un nombre de usuario público conocido de Twitch en un perfil normalizado, recopile su inventario público de videos u obtenga un clip con su video descargable para investigación de creadores de contenido, enriquecimiento de catálogos, comparaciones y monitoreo mediante instantáneas.
Rednote API
Obtenga perfiles y notas públicos, busque notas o usuarios, recopile comentarios y respuestas anidadas, y capture una página de recomendaciones de inicio.
Kwai API
Obtenga perfiles públicos de Kwai, una página de publicaciones de una cuenta o una publicación conocida, con identidad, contenido, contenido multimedia, marcas de tiempo e interacción visible normalizados.