Como estudar os papéis públicos dos autores de comentários no LinkedIn

Separe comentários e contas

Uma linha salva é um comentário de primeiro nível disponível. Não é uma pessoa. Não é uma reação. Não é um perfil completo. Não é uma discussão completa.

Estes são os campos da linha:

• `commentId`
• `commentUrl`
• `postUrl`
• `postUrn`
• `authorType`
• `authorUrl`
• `authorId`
• `authorUrn`
• `authorPublicIdentifier`
• `authorName`
• `authorHeadline`
• `authorLocation`
• `authorCurrentOrganizations`
• `text`
• `observedAt`

`authorUrn` e `postUrn` são valores de URN. Uma URN é um identificador de texto com tipo, vindo da fonte pública. Um `authorId` também é um identificador da fonte pública. Esses identificadores são públicos. Não são chaves secretas.

`authorType` tem três valores verificados: `person`, `organization` ou `null`. `null` significa que o tipo não foi informado. Não leia `null` como person.

`observedAt` é o momento em que você observou a linha. Não é o momento em que a publicação foi publicada. Anote os dois momentos se você tiver os dois. Não os troque.

`authorCurrentOrganizations` pode conter mais de um registro público. Guarde todos os registros. Não invente um empregador. Se o campo for null ou estiver vazio, a evidência de organização é desconhecida. Desconhecido não é zero. Desconhecido não significa desempregado. Desconhecido não significa nenhuma empresa.

Os dados do autor podem estar ausentes. Uma solicitação pode devolver uma linha com título vazio ou organizações vazias. Deixe essas células como desconhecidas. Não as preencha a partir do texto do comentário.

Use somente uma tabela de comentários. Você não precisa de um segundo conjunto de dados para classificar papéis.

Defina uma execução pequena

1. Escolha publicações públicas conhecidas. Escreva a pergunta do estudo antes de coletar. Declare o momento da coleta. Declare um teto para cada publicação. Marque comentários de promoção, comentários do autor da publicação e contas de organização quando essas linhas mudariam o estudo. Um comentário de promoção promove principalmente um produto ou um serviço. Mantenha as linhas marcadas. Não as apague. Se você deixar uma conta do autor da publicação fora da parcela, diga isso e altere o total.
2. Colete uma amostra pequena com os dados do autor ativados. A tarefa salva verificada em 13 de outubro de 2026 é LinkedIn Comment Authors with Public Profile Details. A entrada salva é:

{"startUrls": ["https://www.linkedin.com/posts/timferriss_how-to-become-dramatically-more-productive-activity-7386884213343428608-wrF3"], "maxComments": 100, "collectAllAvailable": false, "includeAuthorDetails": true}

Substitua essa publicação de amostra pela publicação pública que você quer estudar. Na primeira execução, defina `maxComments` como 3. Mantenha `collectAllAvailable` false. O valor false mantém o teto numérico ativo. Mantenha `includeAuthorDetails` true.

Os dados do autor são uma solicitação separada da linha do comentário. Um detalhe extra bem-sucedido pode causar um evento de cobrança separado. Um evento de cobrança é um registro de cobrança. Nem toda solicitação causa uma cobrança. Os campos de detalhe ainda podem voltar vazios. Este artigo não informa preço.

1. Salve as linhas de comentários e o OUTPUT da execução. Leia o OUTPUT de cada publicação antes de classificar qualquer papel.

O OUTPUT no nível da execução inclui `savedRows`, `authorProfileRequests`, `authorDetailEvents` e `rowsWithAuthorDetails`. Leia esses campos para ver quantas linhas e solicitações de detalhe foram registradas. `rowsWithAuthorDetails` pode ser menor que a contagem de comentários quando faltam detalhes. Não use essas contagens como o total de papéis. Não as leia como uma fatura.

Cada publicação tem um registro `inputResults`. Leia estes campos ali:

• `status`
• `statusReason`
• `pageCommentCount`
• `publicRowsOnPage`
• `savedRows`
• `isPublicPageComplete`
• `isComplete`
• `stopReason`

Use o `stopReason` dentro do `inputResults` dessa publicação. Um `stopReason` na raiz do OUTPUT não é o estado do teto da publicação.

`isPublicPageComplete` true significa que a página pública exposta foi extraída. Isso não significa que a discussão completa foi salva. `isComplete` false significa que a coleta salva está incompleta. Um teto, uma restrição de prévia pública, uma restrição da fonte ou um limite de cobrança pode causar esse resultado. Leia o status, o motivo e o stopReason de cada entrada. Um status de execução bem-sucedido não torna a tabela completa. `pageCommentCount` e `publicRowsOnPage` são contagens da página. Essas contagens da página não são contagens de contas de pessoa observadas.

Em 13 de outubro de 2026, uma verificação delimitada salvou 3 comentários de 1 publicação. Ela fez 3 solicitações de detalhe do autor. O teto interrompeu a execução enquanto a contagem da página exposta era 4. Para essa publicação, `isPublicPageComplete` era true, `isComplete` era false e `stopReason` era `max_comments_reached`. As 3 linhas salvas não eram a discussão inteira. Elas só mostram que dados públicos do autor podem ser devolvidos. Não são um relatório de papéis. Não as use como o exemplo resolvido.

Monte as duas tabelas

Mantenha uma tabela de comentários. Dê a cada linha o próprio `commentId`.

Se `commentId` estiver ausente, mantenha essa linha como a própria observação de fonte. Dê a ela um rótulo que você cria, como `missing-comment-1`. Nunca una dois ids de comentário em branco. Nunca una duas linhas porque o texto do comentário coincide. Texto igual não é o mesmo comentário.

Monte uma tabela de contas-pessoa somente depois de confirmar o tipo.

1. Leia `authorType`.
2. Agrupe um id somente quando `authorType` for `person`.
3. Prefira `authorUrn` ou `authorId` como a chave segura.
4. Se esses ids estiverem ausentes, uma URL de perfil público verificada pode ser um rótulo provisório. Diga que o rótulo de URL é mais fraco que um id estável. Um rótulo de URL não é não resolvido.
5. Não resolvido significa que não há chave segura. Não há `authorUrn`, não há `authorId` e não há URL de perfil verificada. Não chame uma linha de não resolvida só porque o id estável está ausente quando existe uma URL verificada.
6. Nunca una linhas por `authorName`.
7. Nunca una ids em branco entre si.

Contas `organization` ficam em um grupo separado. Mantenha os ids delas separados dos ids de pessoa. Elas não entram no total de contas-pessoa. Declare a contagem delas ao lado desse total.

Se `authorType` for `null`, não trate a linha como uma conta de pessoa. Se essa linha também não tiver chave segura de pessoa, ela permanece não resolvida. Não a atribua a um nome próximo.

Papel desconhecido e identidade não resolvida são coisas diferentes. Papel desconhecido significa que você encontrou a conta de pessoa, mas o título não declara um papel. Essa conta permanece no total de contas-pessoa. A identidade não resolvida fica de fora.

Classifique o título que você consegue ver

Escreva um livro de códigos antes de contar. Um livro de códigos é uma lista curta de categorias e da evidência de título que cada uma exige.

Use esta regra.

• `operations`: o título declara trabalho de operações.
• `technical`: o título declara trabalho de software ou de engenharia.
• `marketing`: o título declara trabalho de marketing.
• `mixed`: o título declara mais de uma dessas funções, e a regra não consegue escolher uma.
• `unknown`: o título está ausente, ou não declara nenhuma função. Um slogan é desconhecido.

Salve o texto exato do título ao lado da categoria. Use a função declarada por inteiro. Não infira um cargo a partir de um slogan. Não infira um papel a partir do tom do comentário. O texto do comentário não é evidência de papel.

Use uma categoria primária para cada identidade de conta-pessoa. As parcelas então somam uma vez. Você pode guardar etiquetas extras em um segundo campo. Não some essas etiquetas como mais contas.

Guarde os dois instantâneos datados do título quando a mesma conta tiver textos conflitantes. Guarde o texto exato da evidência de cada instantâneo. Não escolha o título que deixa o gráfico mais limpo. Use uma regra declarada de observação selecionada para o relatório. Se você não puder usar essa regra, o papel primário permanece `unknown`. Use `conflict pending review` somente para um estado separado de revisão do leitor. Não classifique papéis de momentos diferentes como `mixed`. Classifique como `mixed` somente quando o título selecionado declara vários papéis e o livro de códigos não consegue escolher um papel. Classifique como `unknown` quando o título selecionado não mostra uma função clara.

Uma categoria de papel é o seu rótulo para uma função declarada. Não é uma credencial verificada.

Conte uma vez e depois divida

Conte comentários repetidos em uma tabela de atividade. Conte cada identidade observada de conta-pessoa uma vez na tabela de papéis.

Um denominador é o total pelo qual você divide. Um numerador é a contagem que você divide. Uma parcela é o numerador dividido pelo denominador declarado.

No relatório de papéis, o denominador é o número de identidades observadas de conta-pessoa. As linhas de organização ficam fora dele. As linhas não resolvidas ficam fora dele. As contas com papel desconhecido permanecem dentro dele.

A cobertura de papéis conhecidos usa um segundo relatório, não um novo público. O numerador são as identidades de conta-pessoa cujo papel primário não é `unknown`. O denominador são todas as identidades observadas de conta-pessoa. `mixed` não é `unknown`.

Você também pode mostrar parcelas só dentro do grupo de papéis conhecidos. Essa visão tem um denominador menor. Escreva esse denominador na tabela. Mantenha a contagem de desconhecidos ao lado. Não compare essas parcelas com as parcelas do denominador maior. As contas não mudaram. O total mudou.

Peça a um segundo leitor que classifique alguns títulos com o mesmo livro de códigos. Revise as linhas que vocês classificam de modo diferente. Isso verifica a consistência. Não prova que o cargo é real.

Exemplo resolvido fictício

As publicações, os rótulos, os nomes, os títulos e as contagens nesta seção são fictícios. Não são a verificação de 13 de outubro de 2026. Não são pessoas reais.

Uma publicação inventada produz 8 linhas de comentário. Os valores fictícios de `commentId` são `c1` até `c8`. Nenhuma dessas 8 linhas tem um `commentId` em branco. Os ids de pessoa das linhas de pessoa foram verificados. `c8` não tem chave segura.

Tabela de contas-pessoa:

`org1` tem `authorType` `organization` e 1 comentário. Ele fica fora da tabela de contas-pessoa. `c8` tem `authorType` `null` e nenhuma chave segura. É 1 comentário não resolvido. Nunca atribua `c8` a `p4`.

Os 8 comentários contêm 4 identidades observadas de conta-pessoa, 1 autor de organização e 1 linha de autor não resolvida. Não diga que havia exatamente 6 pessoas. A linha não resolvida pode repetir uma conta de pessoa. `org1` é uma organização.

As parcelas de papéis usam 4 identidades observadas de conta-pessoa como denominador.

A parcela operations é 1 dividido por 4. Isso é 25%. A mesma conta dá 25% para technical, marketing e unknown. Essas quatro parcelas usam um denominador, então somam 100%.

A cobertura de papéis conhecidos usa 3 como numerador e 4 como denominador. 3 dividido por 4 é 75%. A conta desconhecida continua visível como 1 das 4.

Uma segunda visão usa somente as 3 contas de papel conhecido. Cada grupo conhecido é 1 dividido por 3, o que é cerca de 33,3%. Mantenha a contagem de desconhecidos ao lado desta visão. Essa conta desconhecida é 1, e ela está fora deste denominador.

Não compare 33,3% com 25%. Esses números usam denominadores diferentes. Não são uma mudança no público.

A atividade de comentários é um total diferente. Ela soma 8.

`p1` e `p2` escreveram 2 comentários cada um. Um relatório de papéis que usa todas as 8 linhas de comentário contaria essas duas contas duas vezes. Use a tabela de atividade para o volume. Use as 4 identidades de conta-pessoa para a composição.

Nota fictícia de cobertura: o teto é 8. A contagem observada da página de origem é 12. Em `inputResults`, `stopReason` é `max_comments_reached` e `isComplete` é false. Esta nota fictícia não atribui `status` nem `statusReason`.

Decisão: mantenha a tabela de papéis de 4 contas como uma amostra observada. Colete mais somente se o estudo precisar de mais cobertura. Nunca chame esta amostra de todos os 12 participantes. Não leia 12 como 12 identidades de conta-pessoa.

Achado fictício: nesta amostra com teto, cada papel primário é 25% de 4 identidades observadas de conta-pessoa. A cobertura de papéis conhecidos é 75%. O achado é somente sobre essa amostra. Ele não descreve todos os clientes. Ele não mostra quem pode comprar.

O que você entrega

Entregue estes itens.

• A tabela de contas-pessoa, com um papel primário para cada uma.
• O livro de códigos e o texto exato do título usado como evidência.
• A contagem de organizações, fora do denominador de contas-pessoa.
• A contagem de identidades não resolvidas, com rótulos feitos pelo leitor para qualquer `commentId` ausente.
• Uma nota de cobertura para cada publicação, a partir de `inputResults`.
• Um achado de escopo limitado que identifica o denominador e o teto da coleta.

Diga o momento da coleta. Não o substitua pelo momento de publicação da postagem. Se um título ou uma lista de organizações estava vazio, mostre desconhecido. Não transforme desconhecido em zero.

Se `isComplete` for false, diga que a tabela não é a discussão inteira. Se dois instantâneos do título discordarem, mostre os dois. Não esconda aquele que você não classificou.