Visão geral
Seção intitulada “Visão geral”LinkedIn é a maior plataforma de networking profissional do mundo, conectando profissionais, empresas e líderes de pensamento para criação de conteúdo, geração de oportunidades de negócio e desenvolvimento de carreira. Com a integração LinkedIn no SquadOS, seus agentes podem publicar posts e artigos, interagir com conteúdo, gerenciar mídias e acessar dados analíticos de páginas organizacionais diretamente pela API.
- Site oficial: https://www.linkedin.com/
- Documentação na Composio: docs.composio.dev/toolkits/linkedin
Autenticação
Seção intitulada “Autenticação”Esta ferramenta utiliza OAuth 2.0 (OAUTH2) para conectar.
A autenticação é feita via fluxo OAuth no navegador — ao clicar em Conectar, você será redirecionado para a página segura da Composio, onde autoriza o acesso à sua conta LinkedIn. Nenhuma credencial manual é necessária.
Como conectar no SquadOS
Seção intitulada “Como conectar no SquadOS”- Acesse Ferramentas no menu lateral (
/admin/tools). - Abra a aba Disponíveis e procure por
LinkedIn. - Clique no card para abrir o modal de detalhes e em Conectar.
- Você é levado para a página de conexão segura hospedada pela Composio, onde autoriza o acesso via OAuth.
- Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)
Perguntas frequentes
Seção intitulada “Perguntas frequentes”Como configuro credenciais OAuth personalizadas para o LinkedIn?
Seção intitulada “Como configuro credenciais OAuth personalizadas para o LinkedIn?”Para um guia passo a passo sobre como criar e configurar suas próprias credenciais OAuth do LinkedIn na Composio, consulte Como criar credenciais OAuth para o LinkedIn.
Por que estou recebendo erros 429 de limite de taxa no LinkedIn?
Seção intitulada “Por que estou recebendo erros 429 de limite de taxa no LinkedIn?”O app OAuth padrão é compartilhado entre usuários e possui limites de taxa rigorosos. Use seu próprio app OAuth em produção para evitar cotas compartilhadas.
Por que não consigo usar certas combinações de escopos do LinkedIn?
Seção intitulada “Por que não consigo usar certas combinações de escopos do LinkedIn?”O LinkedIn restringe certas combinações de escopos. Por exemplo, w_member_social e r_organization_admin não podem ser usados juntos. Se precisar de escopos conflitantes, crie seu próprio app OAuth com as permissões necessárias.
Ações disponíveis
Seção intitulada “Ações disponíveis”Criar compartilhamento de artigo ou URL
Seção intitulada “Criar compartilhamento de artigo ou URL”LINKEDIN_CREATE_ARTICLE_OR_URL_SHARE
Cria um compartilhamento de artigo ou URL no LinkedIn usando a API de Posts UGC. Use quando precisar compartilhar um link com comentário opcional no LinkedIn. Suporta compartilhamento de URLs como artigos com configurações de visibilidade personalizáveis.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
author | string | Sim | URN do autor (pessoa ou organização). Para pessoa: urn:li:person:{id}. Para organização: urn:li:organization:{id}. Use a ação GET_MY_INFO para obter seu ID de pessoa. |
visibility | object | Sim | Configurações de visibilidade do post. Controla quem pode ver o conteúdo compartilhado. |
lifecycleState | string ("PUBLISHED" | "DRAFT") | Não | Estado do post. Use 'PUBLISHED' para publicar imediatamente ou 'DRAFT' para salvar como rascunho. |
specificContent | object | Sim | Container do conteúdo do compartilhamento, incluindo URL, comentário e categoria de mídia. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar comentário em post do LinkedIn
Seção intitulada “Criar comentário em post do LinkedIn”LINKEDIN_CREATE_COMMENT_ON_POST
Cria um comentário de primeiro nível ou aninhado em um share, post UGC ou comentário pai do LinkedIn via API Social Actions Comments. Use quando precisar interagir com posts adicionando comentários ou respondendo a comentários existentes. Suporta comentários de texto com @-menções e anexos de imagem opcionais.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
actor | string | Sim | Entidade autora do comentário. Para comentários pessoais: urn:li:person:{id}. Para comentários organizacionais: urn:li:organization:{id}. Use a ação GET_USER_INFO para obter o campo id. |
object | string | Sim | URN do share ou ugcPost que contém o comentário. Normalmente igual ao target_urn para comentários de primeiro nível, ou o URN do post raiz para comentários aninhados. Deve ser urn:li:share:{id} ou urn:li:ugcPost:{id}. URNs de Activity (urn:li:activity:{id}) NÃO são suportados. |
content | array | Não | Array de entidades de conteúdo como imagens a incluir no comentário. Cada entidade deve conter um URN de imagem ou outro tipo de conteúdo. |
message | object | Sim | Conteúdo da mensagem do comentário, incluindo texto e @-menções opcionais. |
target_urn | string | Sim | URN do share, post UGC ou comentário pai onde o comentário será criado. Deve ser urn:li:share:{id}, urn:li:ugcPost:{id} ou urn:li:comment:({parentUrn},{commentId}). URNs de Activity NÃO são suportados. |
parentComment | string | Não | Para comentários aninhados (respostas), o URN do comentário pai sendo respondido. Formato: urn:li:comment:({parentUrn},{commentId}). Deixe vazio para comentários de primeiro nível no post. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar um post no LinkedIn
Seção intitulada “Criar um post no LinkedIn”LINKEDIN_CREATE_LINKED_IN_POST
Cria um novo post no LinkedIn para o usuário autenticado ou uma organização que ele gerencia. Requer o escopo w_member_social para publicar como pessoa, e w_organization_social para publicar como organização (com papel ADMINISTRATOR, DIRECT_SPONSORED_CONTENT_POSTER ou CONTENT_ADMIN).
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
author | string | Sim | URN do membro LinkedIn ou organização que cria o post. Para pessoa: urn:li:person:{id} (ex: urn:li:person:F6kGF1Uduq). Para organização: urn:li:organization:{id}. Obtenha seu ID de pessoa com GET_MY_INFO ou IDs de organização com GET_COMPANY_INFO. |
images | array | Não | Array de imagens a fazer upload e anexar ao post. Suporta 1 a 20 imagens. |
container | string | Não | URN de entidade container para publicar em um container específico (ex: urn:li:group:123456 para posts em grupos). |
commentary | string | Sim | Conteúdo de texto principal do post. Suporta texto simples e @-menções. Comprimento máximo: 3000 caracteres. |
visibility | string ("PUBLIC" | "CONNECTIONS" | "LOGGED_IN" | "CONTAINER") | Não | Controla quem pode ver o post. 'PUBLIC' para todos, 'CONNECTIONS' apenas para conexões, 'LOGGED_IN' para membros logados, 'CONTAINER' para posts em grupos/eventos. |
distribution | object | Não | Especifica regras de distribuição do post, incluindo distribuição no feed e segmentação. |
lifecycleState | string | Não | Estado do post. Use 'PUBLISHED' para publicar diretamente, 'DRAFT' para salvar como rascunho ou 'PUBLISH_REQUESTED' se o post requer revisão antes de publicar. |
reshareContext | object | Não | Contexto para compartilhar outro post. |
contentLandingPage | string | Não | URL da página de destino que abre ao clicar no botão de call-to-action. Obrigatório quando contentCallToActionLabel estiver especificado. |
contentCallToActionLabel | string | Não | Rótulos de botão call-to-action para posts. Valores: "APPLY", "DOWNLOAD", "VIEW_QUOTE", "LEARN_MORE", "SIGN_UP", "SUBSCRIBE", "REGISTER", "JOIN", "ATTEND", "REQUEST_DEMO", "SEE_MORE", "BUY_NOW", "SHOP_NOW". |
isReshareDisabledByAuthor | boolean | Não | Defina como true para impedir que outros compartilhem este post. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Excluir post LinkedIn (legado)
Seção intitulada “Excluir post LinkedIn (legado)”LINKEDIN_DELETE_LINKED_IN_POST
Exclui um post específico do LinkedIn (share) pelo seu share_id único, que deve corresponder a um share existente.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
share_id | string | Sim | Identificador único do share (post) do LinkedIn a ser excluído. Aceita ID numérico (ex: '7245341016004718592') ou formato URN (ex: 'urn:li:share:7245341016004718592'). |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Excluir post
Seção intitulada “Excluir post”LINKEDIN_DELETE_POST
Exclui um post do LinkedIn usando o endpoint REST da Posts API. Suporta formatos URN de ugcPost e share. O endpoint é idempotente — posts já excluídos anteriormente retornam sucesso (204).
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
post_urn | string | Sim | URN do post a excluir. Aceita formatos ugcPost ou share (ex: 'urn:li:ugcPost:7890123456' ou 'urn:li:share:7245341016004718592'). O URN será codificado em URL automaticamente. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Excluir post UGC (legado)
Seção intitulada “Excluir post UGC (legado)”LINKEDIN_DELETE_UGC_POST
Exclui um post UGC usando o endpoint legado da UGC Post API. Use quando precisar excluir um post pelo endpoint v2/ugcPosts. A exclusão é idempotente — posts já excluídos também retornam sucesso.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ugc_post_urn | string | Sim | URN do post UGC ou share a excluir. Formato: 'urn:li:ugcPost:{id}' ou 'urn:li:share:{id}'. Será codificado em URL automaticamente pela ação. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter facetas de segmentação para anúncios
Seção intitulada “Obter facetas de segmentação para anúncios”LINKEDIN_GET_AD_TARGETING_FACETS
Recupera as facetas de segmentação de anúncios disponíveis na LinkedIn Marketing API. Use quando precisar descobrir quais opções de segmentação estão disponíveis para campanhas de anúncios (ex: localizações, setores, funções de trabalho).
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter contagens de público
Seção intitulada “Obter contagens de público”LINKEDIN_GET_AUDIENCE_COUNTS
Recupera contagens de tamanho de público para critérios de segmentação especificados. Use ao estimar o alcance de campanhas de anúncios ou conteúdo segmentado no LinkedIn.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
q | string ("targetingCriteriaV2") | Não | Parâmetro de tipo de consulta. Deve ser 'targetingCriteriaV2' para consultas de critérios de segmentação. |
targetingCriteria | string | Sim | Critérios de segmentação com URNs codificados em URL. Formato: (include:(and:List((or:(urn%3Ali%3AadTargetingFacet%3AFACET:List(urn%3Ali%3ATYPE%3AID)))))). Apenas os dois-pontos dos URNs devem ser codificados como %3A; mantenha a sintaxe estrutural (parênteses, dois-pontos em 'and:' e 'or:') sem codificação. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter informações da empresa
Seção intitulada “Obter informações da empresa”LINKEDIN_GET_COMPANY_INFO
Recupera organizações onde o usuário autenticado possui papéis específicos (ACLs), para determinar suas capacidades de gerenciamento ou publicação de conteúdo em páginas de empresa do LinkedIn.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
role | string ("ADMINISTRATOR" | "DIRECT_SPONSORED_CONTENT_POSTER") | Não | O papel específico para filtrar os ACLs de organização. |
count | integer | Não | Número de ACLs de organização a retornar por página. |
start | integer | Não | Índice inicial para paginação, representando o número de ACLs iniciais a pular. |
state | string ("APPROVED" | "REQUESTED") | Não | Estado de aprovação do papel para filtrar. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter detalhes de imagem
Seção intitulada “Obter detalhes de imagem”LINKEDIN_GET_IMAGE
Recupera detalhes de uma imagem do LinkedIn usando seu URN. Use quando precisar verificar o status da imagem, obter URLs de download ou acessar metadados de uma única imagem.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
image_urn | string | Sim | Identificador URN da imagem. Pode ser fornecido como 'urn:li:image:XXX' ou apenas o ID 'XXX'. O URN será codificado em URL automaticamente na requisição à API. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter imagens
Seção intitulada “Obter imagens”LINKEDIN_GET_IMAGES
Recupera metadados de imagens incluindo URLs de download, status e dimensões pela Images API do LinkedIn. Use quando precisar acessar detalhes de imagens para posts, perfis ou ativos da biblioteca de mídia.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ids | array | Sim | Lista de URNs de imagens a recuperar. Cada URN deve estar no formato 'urn:li:image:{ID}' (ex: 'urn:li:image:C4E10AQFn10iWtKexVA'). O tamanho máximo recomendado do lote depende dos limites da API do LinkedIn. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter meus dados
Seção intitulada “Obter meus dados”LINKEDIN_GET_MY_INFO
Obtém as informações de perfil do usuário LinkedIn autenticado, incluindo nome, título, foto de perfil e outros detalhes do perfil.
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter tamanho da rede
Seção intitulada “Obter tamanho da rede”LINKEDIN_GET_NETWORK_SIZE
Recupera a contagem de seguidores de uma organização no LinkedIn. Use quando precisar obter o número de membros que seguem uma empresa ou organização específica no LinkedIn.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
edgeType | string ("COMPANY_FOLLOWED_BY_MEMBER") | Não | Tipo de relacionamento de rede a contar. Use COMPANY_FOLLOWED_BY_MEMBER para obter a contagem de seguidores. |
organization_id | string | Sim | Identificador único da organização LinkedIn. É o ID numérico do URN da organização (ex: para 'urn:li:organization:3803', use '3803'). |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter estatísticas da página da organização
Seção intitulada “Obter estatísticas da página da organização”LINKEDIN_GET_ORG_PAGE_STATS
Recupera estatísticas da página de uma organização no LinkedIn. Use quando precisar de métricas de engajamento como visualizações de página e cliques em botões personalizados. Suporta estatísticas vitalícias (dados de todos os tempos segmentados por demografia) e estatísticas por período (dados agregados para intervalos de tempo específicos). Requer permissão rw_organization_admin com papel ADMINISTRATOR na organização.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
organization | string | Sim | URN da organização no formato urn:li:organization:{id}. Exemplo: urn:li:organization:2414183. |
timeRangeEnd | integer | Não | Timestamp de fim (inclusive) em milissegundos desde a época. Obrigatório apenas para estatísticas por período. Omita para estatísticas vitalícias. |
timeRangeStart | integer | Não | Timestamp de início (exclusivo) em milissegundos desde a época. Obrigatório apenas para estatísticas por período. Omita para estatísticas vitalícias. |
timeGranularityType | string ("DAY" | "MONTH") | Não | Granularidade das estatísticas. Use DAY para estatísticas diárias ou MONTH para mensais. Obrigatório apenas para estatísticas por período. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter perfil de pessoa
Seção intitulada “Obter perfil de pessoa”LINKEDIN_GET_PERSON
Recupera informações de perfil de um membro LinkedIn pelo seu ID de pessoa. Retorna campos de perfil básico (nome, foto de perfil) por padrão, ou campos de perfil estendido (incluindo título e nome de vaidade) com as permissões adequadas.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
person_id | string | Sim | Identificador único do membro LinkedIn. Nota: cada ID de membro é único no contexto da sua aplicação. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter conteúdo do post
Seção intitulada “Obter conteúdo do post”LINKEDIN_GET_POST_CONTENT
Recupera o conteúdo detalhado de um post, incluindo texto, imagens, vídeos e metadados do LinkedIn pelo URN do post. Use quando precisar buscar o conteúdo completo e detalhes de um post específico do LinkedIn.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
post_id | string | Sim | Identificador URN do post no formato 'urn:li:ugcPost:{id}' ou 'urn:li:share:{id}'. Também pode ser codificado em URL. Exemplo: 'urn:li:ugcPost:7428263313739988992'. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter estatísticas de compartilhamentos
Seção intitulada “Obter estatísticas de compartilhamentos”LINKEDIN_GET_SHARE_STATS
Recupera estatísticas de compartilhamentos de uma organização no LinkedIn, incluindo impressões, cliques, curtidas, comentários e compartilhamentos. Use para analisar o desempenho de conteúdo de uma página organizacional. Opcionalmente filtre por intervalos de tempo para obter estatísticas por período.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
time_intervals | string | Não | Filtro de estatísticas por período no formato de objeto complexo RestLi 2.0. Especifique intervalo de tempo e granularidade como: '(timeRange:(start:<timestamp_inicio>,end:<timestamp_fim>),timeGranularityType:<GRANULARIDADE>)' onde os timestamps são em milissegundos desde a época e GRANULARIDADE é um de: DAY, WEEK, MONTH. Se omitido, retorna estatísticas vitalícias. |
organizational_entity | string | Sim | URN da organização para recuperar estatísticas de compartilhamentos. Deve estar no formato 'urn:li:organization:<id>' (ex: 'urn:li:organization:2414183'). Obtenha IDs de organização com GET_COMPANY_INFO. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter vídeos
Seção intitulada “Obter vídeos”LINKEDIN_GET_VIDEOS
Recupera metadados de vídeos da LinkedIn Marketing API. Suporta recuperação de vídeo único, em lote (múltiplos vídeos) e por conta associada com paginação. Use quando precisar obter detalhes de vídeos incluindo duração, dimensões, status, URLs de download e informações da biblioteca de mídia.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
count | integer | Não | Número de elementos a retornar por página, até 1.000. Usado apenas com 'associated_account'. Padrão: 10. |
start | integer | Não | Índice inicial para paginação. Usado apenas com 'associated_account'. Padrão: 0. |
video_ids | array | Não | Lista de URNs de vídeos para recuperação em lote (ex: ['urn:li:video:C4D10AQE9WE5n4uJKUg', 'urn:li:video:C5F10AQElP1fVH1Ke6g']). Mutuamente exclusivo com 'video_urn' e 'associated_account'. |
video_urn | string | Não | URN de vídeo único a recuperar (ex: 'urn:li:video:C4E10AQGUkQY7trgh-Q'). Mutuamente exclusivo com 'video_ids' e 'associated_account'. |
associated_account | string | Não | URN de conta patrocinada para encontrar vídeos por conta associada (ex: 'urn:li:sponsoredAccount:123456789'). Mutuamente exclusivo com 'video_urn' e 'video_ids'. |
media_library_status | string ("ACTIVE" | "ARCHIVED") | Não | Filtro por status na biblioteca de mídia. Usado apenas com 'associated_account'. Quando omitido, retorna todos os vídeos independentemente do status. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Inicializar upload de imagem
Seção intitulada “Inicializar upload de imagem”LINKEDIN_INITIALIZE_IMAGE_UPLOAD
Inicializa um upload de imagem no LinkedIn e retorna uma URL de upload pré-assinada mais o URN da imagem resultante. Use quando precisar preparar um upload de imagem para posts no LinkedIn. Após chamar esta ação, faça o upload dos bytes da imagem para a upload_url retornada via requisição PUT e use o URN da imagem na ação CREATE_LINKED_IN_POST.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
owner | string | Sim | URN do proprietário (pessoa ou organização) que será dono da imagem enviada. Deve estar no formato 'urn:li:person:{id}' para posts pessoais ou 'urn:li:organization:{id}' para posts organizacionais. Use a ação GET_MY_INFO para obter o ID de pessoa. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar reações em entidade
Seção intitulada “Listar reações em entidade”LINKEDIN_LIST_REACTIONS
Recupera reações (curtidas, comemorações, etc.) em uma entidade do LinkedIn como share, post ou comentário. Use quando precisar ver quem reagiu ao conteúdo e quais tipos de reações foram usados.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
sort | string ("CHRONOLOGICAL" | "REVERSE_CHRONOLOGICAL" | "RELEVANCE") | Não | Ordem de classificação das reações. CHRONOLOGICAL classifica por data de criação crescente, REVERSE_CHRONOLOGICAL decrescente (padrão), RELEVANCE por relevância para o visualizador. |
count | integer | Não | Número de reações a retornar por página. |
start | integer | Não | Índice inicial para paginação (número de reações a pular). |
entity | string | Sim | URN da entidade (share, post ou comentário) para obter reações. Formato: 'urn:li:share:{id}', 'urn:li:ugcPost:{id}', 'urn:li:activity:{id}' ou 'urn:li:comment:(activity:{activityId},{commentId})'. Não codifique este valor em URL. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Registrar upload de imagem
Seção intitulada “Registrar upload de imagem”LINKEDIN_REGISTER_IMAGE_UPLOAD
Inicializa um upload de imagem nativo do LinkedIn para shares no feed e retorna uma URL de upload pré-assinada mais o URN do ativo de mídia digital resultante. Use quando precisar fazer upload de uma imagem para anexar a um post LinkedIn. Após chamar esta ação, faça o upload dos bytes da imagem para a upload_url retornada e use o asset_urn em LINKEDIN_CREATE_LINKED_IN_POST.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
recipe | string | Não | URN de receita de mídia digital especificando a receita de processamento para a imagem. Padrão: 'urn:li:digitalmediaRecipe:feedshare-image' para imagens de feed share. |
owner_urn | string | Sim | URN da entidade proprietária que será dona da imagem enviada. Deve estar no formato 'urn:li:person:{id}' para posts pessoais ou 'urn:li:organization:{id}' para posts organizacionais. Use a ação GET_USER_INFO para obter o ID de pessoa. |
supported_upload_mechanism | array | Não | Array de mecanismos de upload suportados. Se não especificado, o LinkedIn retornará o mecanismo padrão (normalmente SYNCHRONOUS_UPLOAD). |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Pesquisar entidades de segmentação de anúncios
Seção intitulada “Pesquisar entidades de segmentação de anúncios”LINKEDIN_SEARCH_AD_TARGETING_ENTITIES
Pesquisa entidades de segmentação de anúncios usando busca por typeahead. Use quando precisar encontrar entidades de segmentação como localizações geográficas, cargos, setores ou outros critérios de segmentação para campanhas de anúncios no LinkedIn.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
count | integer | Não | Número máximo de resultados a retornar por página. |
facet | string | Sim | URN de faceta de segmentação de anúncios para especificar o tipo de entidade a pesquisar (ex: 'urn:li:adTargetingFacet:locations' para localizações geográficas, 'urn:li:adTargetingFacet:titles' para cargos, 'urn:li:adTargetingFacet:industries' para setores). |
query | string | Sim | String de consulta para encontrar entidades de segmentação (ex: 'united states', 'software engineer', 'technology'). |
start | integer | Não | Índice inicial para paginação, representando o número de resultados iniciais a pular. |
queryVersion | string ("QUERY_USES_URNS") | Não | Versão da consulta para a requisição de pesquisa. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |