API de Detalles de la publicación de LinkedIn

POST

Salud de la API

Salud 24 h
Normal
  • Saludable / normal
  • Disponible
Normal

Últimas 24 horas

Últimos 30 días

Pasa en url el enlace de una publicación de LinkedIn, su URN (urn:li:activity:<dígitos>) o el número de activity y recibe la publicación completa como un solo objeto: texto, fecha, «me gusta», comentarios, tipo de contenido, datos del autor y, si es una republicación, reshared_post. Los enlaces de empresas, perfiles y empleos devuelven 422 y las publicaciones privadas o borradas, 503; ninguno se cobra. Para leer los comentarios, pasa el mismo enlace a comments.

Envía POST https://api.everyinfra.com/api/v1/social con platform igual a linkedin y action igual a post_detail. Precio $0.79 por 1.000 solicitudes ($0.000792 por llamada). Las llamadas fallidas y los resultados vacíos no se cobran. Síncrona. Para tareas lentas añade "mode": "async" al cuerpo, recibe un job_id y consúltalo.

Prompt para IA

#
Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra LinkedIn: Detalles de la publicación (linkedin/post_detail).

Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en linkedin y action en post_detail, y los parámetros dentro de params.
- Parámetros obligatorios:
  - url: Enlace de una publicación de LinkedIn (https://www.linkedin.com/posts/<nombre>-activity-<dígitos>-<sufijo> o https://www.linkedin.com/feed/update/urn:li:activity:<dígitos>/), un URN (urn:li:activity:<dígitos>) o el númer…
- Devuelve un objeto. Campos principales: id, url, title, text, posted_at, is_edited, like_count, comment_count, media_type (Tipo de contenido que lleva la publicac…), image_urls, video_url (Dirección del vídeo (post_detail)), thumbnail_url; 23 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=linkedin.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "linkedin",
  "action": "post_detail",
  "params": {
    "url": "https://www.linkedin.com/feed/update/urn:li:activity:7529230174937169921/"
  }
}
- Precio: $0.79 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.

Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.

Parámetros de la solicitud

#
NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código.
platformbodystringSílinkedinIdentificador de la plataforma, valor fijo.
actionbodystringSípost_detailIdentificador de la capacidad, valor fijo.
urlbody.paramsstringSí-Enlace de una publicación de LinkedIn (https://www.linkedin.com/posts/<nombre>-activity-<dígitos>-<sufijo> o https://www.linkedin.com/feed/update/urn:li:activity:<dígitos>/), un URN (urn:li:activity:<dígitos>) o el número de activity, de 15 a 25 dígitos. También sirven las formas ugcPost y share de los enlaces y del URN, y se ignora la cadena de consulta que sigue al enlace. También sirven los enlaces de artículos de LinkedIn (https://www.linkedin.com/pulse/<slug>); los artículos traen además title. Los enlaces de empresas, perfiles y empleos no son publicaciones: devuelven 422 y no se cobran.

Ejemplos de código

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "linkedin",
  "action": "post_detail",
  "params": {
    "url": "https://www.linkedin.com/feed/update/urn:li:activity:7529230174937169921/"
  }
}'

Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.

Ejemplo de respuesta

#
Todavía no hay una muestra real para estos parámetros de ejemplo: se muestra la estructura de la respuesta y sus campos según la definición de la API, con … como marcadores. No es el resultado de una llamada real.
json
{  "id": "req_…",  "platform": "linkedin",  "action": "post_detail",  "results": {    "id": …,    "url": …,    "title": …,    "text": …,    "posted_at": …,    "is_edited": …,    "like_count": …,    "comment_count": …,    "media_type": …,    "image_urls": …,    "video_url": …,    "thumbnail_url": …,    "links": …,    "mentions": …,    "hashtags": …,    "author_name": …,    "author_username": …,    "author_url": …,    "author_avatar_url": …,    "author_headline": …,    "author_type": …,    "author_follower_count": …,    "reshared_post": …,    "platform": …  },  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Campos de la respuesta

#

Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.

CampoSignificado
idIdentificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas.
urlEnlace al registro en la plataforma.
titleTítulo. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto).
textTexto del contenido sin HTML, completo y sin recortes (en algunas plataformas los resultados de listado solo traen un extracto; lo indican las notas de campos de la plataforma).
posted_atFecha de publicación en ISO 8601, UTC (por ejemplo 2026-08-07T12:34:56+00:00). Las cadenas no estándar de la plataforma se transmiten tal cual, así que conviene analizarlas con tolerancia. null significa que la plataforma no la publica.
is_editedConserva el significado de la plataforma
like_countMe gusta. null significa que la plataforma o esta capacidad no lo publica; no es 0.
comment_countComentarios. null significa no publicado, no 0.
media_typeTipo de contenido que lleva la publicación (post_detail): text, image, video, article (enlaza un artículo) o document.
image_urlsLista de enlaces de imagen en el orden en que los muestra la plataforma; no aparece si no hay imágenes.
video_urlDirección del vídeo (post_detail); solo aparece en publicaciones de vídeo.
thumbnail_urlEnlace a la miniatura, con menos resolución que image_url.
linksLista de enlaces externos del texto de la publicación (post_detail); no aparece si no hay ninguno.
mentionsLista de nombres cortos de las cuentas mencionadas en el texto de la publicación (post_detail), como microsoft; no aparece si no hay ninguna.
hashtagsLista de etiquetas de la página de empresa o de la publicación.
author_nameNombre visible del autor.
author_usernameNombre de usuario del autor (@usuario), normalmente utilizable en URL.
author_urlEnlace al perfil del autor de la publicación (search, post_detail), sin parámetros de seguimiento.
author_avatar_urlEnlace del avatar del autor de la publicación (search, post_detail).
author_headlineConserva el significado de la plataforma
author_typeConserva el significado de la plataforma
author_follower_countSeguidores del autor. null significa no publicado.
reshared_postLa publicación que se reenvió (post_detail), solo presente en una republicación: id, url, text, posted_at, author_name, author_username, author_url y author_type.
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).

Errores y facturación

#
401
Falta la clave o no es válida.
402
Saldo insuficiente. Recarga primero.
422
Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
429
Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
503
No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
200 vacío
Sin datos. Sin cargo.

Errores

Google Analytics solo si aceptas. Privacidad