API de Pinterest
Busca Pines y consulta perfiles, publicaciones, tableros y su contenido público en Pinterest. username, URL de Pin, board_id y URL de tablero identifican objetos diferentes.
Una imagen o enlace externo no concede licencia ni valida el destino. Los tableros secretos y las listas completas de colaboradores no se deducen de los recuentos públicos.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Pinterest, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar Pines en Pinterestsearch | Busca Pines mediante keyword y tipo de contenido opcional, devolviendo imagen, dominio de origen, autor y reacciones. | $1.39 por 1.000 solicitudes | Normal |
Consultar un perfil de Pinterestprofile | Resuelve un username de Pinterest y recoge biografía, web, verificación y contadores públicos. | $1.39 por 1.000 solicitudes | Normal |
Listar Pines de una cuentauser_posts | Obtiene Pines públicos del username, distinguiendo imagen, video, enlace externo y métricas. | $1.39 por 1.000 solicitudes | Normal |
Consultar un Pin concretopin | Abre la url de un Pin concreto y devuelve su contenido, autor, dominio, medio e interacciones visibles. | $1.39 por 1.000 solicitudes | Normal |
Enumerar tableros públicosboards | Enumera tableros públicos del username con descripción, portada, privacidad y recuentos. | $1.39 por 1.000 solicitudes | Normal |
Listar los Pines de un tableroboard_pins | Consulta los Pines de board_id y conserva medio, enlace, autor y métricas por elemento. | $1.39 por 1.000 solicitudes | Normal |
Consultar los datos de un tableroboard_detail | Abre la url de un tablero y devuelve propietario, descripción, privacidad y recuentos públicos. | $1.39 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Pinterest?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar Pines en Pinterest Busca Pines mediante | keyword | content_type | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 50 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · title · text · image_url · reaction_count · source_domain · dominant_color · posted_at · author_username · author_name · author_follower_count · board_name · platform |
profileConsultar un perfil de Pinterest Resuelve un | username | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | user_id · username · name · bio · avatar_url · follower_count · following_count · pin_count · board_count · video_count · website · is_verified · is_private · created_at · platform |
user_postsListar Pines de una cuenta Obtiene Pines públicos del | username | — | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 50 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · title · text · image_url · video_url · media_type · external_link · source_domain · reaction_count · repin_count · comment_count · share_count · dominant_color · alt_text · posted_at · author_username · author_name · board_name · price · platform |
pinConsultar un Pin concreto Abre la | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · url · title · text · image_url · video_url · media_type · external_link · source_domain · reaction_count · repin_count · comment_count · share_count · dominant_color · alt_text · posted_at · author_username · author_name · board_name · price · platform |
boardsEnumerar tableros públicos Enumera tableros públicos del | username | — | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 50 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · name · url · description · pin_count · section_count · follower_count · cover_image_url · is_collaborative · privacy · owner_username · owner_name · created_at · platform |
board_pinsListar los Pines de un tablero Consulta los Pines de | board_id | — | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 50 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · title · text · image_url · video_url · media_type · external_link · source_domain · reaction_count · repin_count · comment_count · share_count · dominant_color · alt_text · posted_at · author_username · author_name · board_name · price · platform |
board_detailConsultar los datos de un tablero Abre la | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · name · url · description · pin_count · section_count · follower_count · cover_image_url · is_collaborative · privacy · owner_username · owner_name · created_at · platform |
¿Qué significan los parámetros de Pinterest search?
Busca Pines mediante keyword y tipo de contenido opcional, devolviendo imagen, dominio de origen, autor y reacciones. No concede derechos sobre el medio ni valida el sitio enlazado.
keywordObligatorio- Palabra clave de inspiración o tema para
search, por ejemplo,Scandinavian kitchen. El tipo de resultado lo selecciona el parámetrocontent_type. content_typeOpcional- Tipo de Pin para
search:all_pins_visual_postspara todos los Pines (no solo de imagen) ovideos_video_pinssolo para Pines de vídeo.searchdevuelve solo Pines, no tableros ni creadores.Valores permitidos:all_pins_visual_postsvideos_video_pinsPinterest: Pin de imagen, vídeo o producto — Pinterest define el Pin como un marcador visual y distingue varios formatos, entre ellos imagen, vídeo y producto. La fuente aclara el tipo de objeto; no promete todos los formatos ni campos multimedia en cada resultado. · Consultada
¿Qué significan los parámetros de Pinterest profile?
Resuelve un username de Pinterest y recoge biografía, web, verificación y contadores públicos. No acredita identidad o propiedad del dominio ni expone tableros secretos.
usernameObligatorio- Nombre de usuario corto de Pinterest para
profile,user_postsoboards. Puede incluir el prefijo@. Este campo no analiza URLs completas de perfiles.
¿Qué significan los parámetros de Pinterest user_posts?
Obtiene Pines públicos del username, distinguiendo imagen, video, enlace externo y métricas. El resultado no garantiza cubrir todos los tableros o publicaciones antiguas.
usernameObligatorio- Nombre de usuario corto de Pinterest para
profile,user_postsoboards. Puede incluir el prefijo@. Este campo no analiza URLs completas de perfiles.Pinterest: Un Pin guardado no siempre es contenido original de la cuenta — La documentación oficial explica que un Pin de imagen puede crearse subiendo una foto o guardando una imagen externa, y esta última opción puede conservar el enlace al sitio original. Por tanto, los Pines asociados a una cuenta no equivalen directamente a obras originales, y la verificación de la fuente no sustituye la licencia de uso del contenido. · Consultada
¿Qué significan los parámetros de Pinterest pin?
Abre la url de un Pin concreto y devuelve su contenido, autor, dominio, medio e interacciones visibles. No sigue el enlace externo como extracción adicional ni otorga licencia.
urlObligatorio- Para
pin, usa el enlace específico del Pin que contiene/pin/ID_numérico/. Paraboard_detail, usa el enlace del tablero con el formato/nombre_de_usuario/nombre_del_tablero/, que también acepta rutas relativas. No uses la URL de un tablero como si fuera un Pin.Pinterest: Enlaces de minoristas en los Pines de producto — La documentación oficial indica que un Pin de producto puede redirigir al sitio web del minorista y que algunos Pines enriquecidos sincronizan la información del artículo. Esta página solo devuelve los campos del Pin obtenidos realmente; no promete obtener el inventario en tiempo real, la capacidad de realizar pedidos ni datos de transacciones. · Consultada
¿Qué significan los parámetros de Pinterest boards?
Enumera tableros públicos del username con descripción, portada, privacidad y recuentos. Un tablero colaborativo no revela automáticamente todos sus miembros ni contenido privado.
usernameObligatorio- Nombre de usuario corto de Pinterest para
profile,user_postsoboards. Puede incluir el prefijo@. Este campo no analiza URLs completas de perfiles.Pinterest: Jerarquía de los tableros y sus subtableros — Pinterest utiliza el `board section` para organizar los Pines dentro de un mismo tablero; los subtableros son un método de organización interna. Por ello, el `section_count` de aquí no debe interpretarse como el número de tableros. Citar el tutorial de creación de subtableros no significa que esta API pueda crear, mover o editar contenido. · Consultada
¿Qué significan los parámetros de Pinterest board_pins?
Consulta los Pines de board_id y conserva medio, enlace, autor y métricas por elemento. No incluye secciones privadas ni garantiza recuperar el tablero entero.
board_idObligatorio- Identificador del tablero para
board_pins: la parte «usuario/nombre-del-tablero» de la URL del tablero después de pinterest.com/, por ejemplopinterest/official-news. Cada tablero de los resultados deboardstrae suurl; quita el dominio para obtener este valor.Pinterest: Organización de Pines por tablero sin confundir con subtableros — La documentación oficial explica que los Pines pueden agruparse en subtableros dentro de un tablero. El `board_id` de aquí sigue localizando únicamente el tablero; el tutorial oficial no proporciona la capacidad de conversión de ID para esta API ni implica que se hayan habilitado parámetros de consulta para subtableros. · Consultada
¿Qué significan los parámetros de Pinterest board_detail?
Abre la url de un tablero y devuelve propietario, descripción, privacidad y recuentos públicos. No añade los Pines; para ellos se usa la acción específica con board_id.
urlObligatorio- Para
pin, usa el enlace específico del Pin que contiene/pin/ID_numérico/. Paraboard_detail, usa el enlace del tablero con el formato/nombre_de_usuario/nombre_del_tablero/, que también acepta rutas relativas. No uses la URL de un tablero como si fuera un Pin.Pinterest: Alcance de visibilidad de los tableros secretos — La documentación oficial aclara que los tableros secretos solo son visibles para el propietario y las personas a las que invite. Conocer el enlace o el ID del tablero no debe interpretarse como un permiso de acceso; esta página no ofrece la capacidad de eludir la configuración de privacidad. · Consultada
Cómo usar la API de Pinterest
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"pinterest","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de Pinterest
¿Cómo llamo a la API de Pinterest?
Envía POST /api/v1/social con platform igual a pinterest, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Pinterest?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye title, text, image_url y reaction_count. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Pinterest?
Pinterest define el Pin como un marcador visual y distingue varios formatos, entre ellos imagen, vídeo y producto. La fuente aclara el tipo de objeto; no promete todos los formatos ni campos multimedia en cada resultado.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; profile requiere username; user_posts requiere username; consulta las demás acciones en la lista de funciones.
¿Las acciones de Pinterest responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.