API de plataforma de EveryData
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.
- Endpoint
- POST /api/v1/social
- Funciones
- 7
- Por 1.000
- 1,389 US$
Funciones disponibles
Compara las acciones de Pinterest por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.
| 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é 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.
¿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 resultado para
search:all_pins_visual_postspara Pines de imagen/texto,videos_video_pinspara Pines de vídeo,boards_pin_collectionspara tableros yprofiles_creator_pagespara páginas de creadores. Una vez seleccionado, interpreta los resultados según el tipo de objeto correspondiente.Valores permitidos:all_pins_visual_postsboards_pin_collectionsprofiles_creator_pagesvideos_video_pinsPinterest: Pin de imagen, vídeo o productoPinterest 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 cuentaLa 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 productoLa 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 subtablerosPinterest 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- ID numérico del tablero para
board_pins. Puedes obtenerlo de los resultados de la acciónboards. No es el nombre ni la URL del tablero.Pinterest: Organización de Pines por tablero sin confundir con subtablerosLa 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 secretosLa 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 devuelto si la acción es 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 de origen contengan 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.