Meios próprios e comunidades

Que canais próprios e que conversas de comunidade as respostas de IA citam. São devolvidas todas as linhas da plataforma, não apenas as suas, cada uma com um indicador yours para comparar a sua presença com a de todos os outros aí citados. Requer o plano Growth ou superior.

GET/dimensions/owned_media

Citações de Owned Media numa plataforma. provider é obrigatório; se for omitido, a resposta é ERR_INVALID_PARAM. As vistas dependem do fornecedor: youtube aceita videos (predefinição), channels e own_citations; as plataformas sociais aceitam posts (predefinição), profiles e own_citations; mobile_apps aceita apps; trustpilot aceita profiles (predefinição), brands e reviews. Todos os fornecedores aceitam activity, que devolve uma linha por entidade e período real de monitorização do projeto, com uma data ISO de início do período, identificadores que podem ser nulos, metadados atuais, um indicador de propriedade e citações. Os períodos sem execuções são omitidos; quando há uma execução sem citações, o valor é zero. As contagens abrangem o intervalo de datas selecionado. Os metadados são atuais, não históricos. As linhas de aplicações móveis incluem store e competitor_id, que pode ser nulo; entity_name contém o ID da aplicação, sem consulta externa. own_citations apresenta apenas citações dos perfis ligados e permanece vazio até ligar um perfil. Os membros da equipa precisam de Social & Communities: profiles and apps, além de YouTube Intelligence para provider=youtube. Intervalo predefinido: 30 dias.

Parâmetros:
  • project_idobrigatório
  • providerobrigatório: youtube|instagram|facebook|tiktok|linkedin|mobile_apps|trustpilot
  • viewvideos|channels|posts|profiles|own_citations|apps|brands|reviews|activity, os valores permitidos dependem do fornecedor
  • storegoogle_play|app_store, apenas mobile_apps
  • owned
  • model
  • collection_id
  • country_code
  • language_code
  • brand_kind
  • range
  • from
  • to
  • page
  • per_page
  • output

GET/dimensions/owned_media/summary

Os resumos e gráficos de Owned Media incluem citações atuais, citações de perfis e conteúdos próprios, share_pct, valores e variações do período anterior com a mesma duração, contagens semanais e desagregações disponíveis por modelo, país, tipo de conteúdo e idade. Cada fornecedor devolve activity por período real de monitorização do projeto; date corresponde ao início do período. As linhas incluem citations, yours e other. Na vista geral, yours e other são null e cada plataforma a que tem acesso devolve a respetiva activity. Os períodos sem execuções são omitidos; quando há uma execução sem citações, o valor é zero. As contagens abrangem o intervalo de datas selecionado. O campo weekly continua ancorado à segunda-feira. provider=overview devolve uma agregação por plataforma; provider=mobile_apps acrescenta totais por loja. O Reddit acrescenta unique_subreddits, unique_authors, positive_pct, share_pct e contagens positivas, neutras e negativas em activity para respostas de IA que citam o Reddit. subreddit_activity agrupa os cinco principais subreddits e Others; positions inclui position_1, position_2_3, position_4_7 e position_7_plus; brand_share agrupa as marcas monitorizadas e os concorrentes. As variações das contagens são percentagens; as variações das proporções são pontos percentuais. As variações são null quando não podem ser calculadas. Os membros da equipa precisam de Social & Communities: profiles and apps, além de Reddit Intelligence ou YouTube Intelligence para esses fornecedores. Intervalo predefinido: 30 dias.

Parâmetros:
  • project_idobrigatório
  • providerobrigatório: youtube|instagram|facebook|tiktok|linkedin|mobile_apps|reddit|trustpilot|overview
  • model
  • collection_id
  • country_code
  • language_code
  • brand_kind
  • range
  • from
  • to

GET/dimensions/owned_media/citing_prompts

As respostas de IA por trás de uma linha de uma tabela de Meios próprios ou do YouTube Intelligence. Indique exatamente um destes parâmetros: url (o URL de uma publicação ou de um vídeo) ou profile (um identificador, o URL de um perfil ou de um canal, ou a key do canal na vista de canais). Devolve o item com as respetivas estatísticas e contagens de citações e de prompts, bem como as respostas que o citam, da mais recente para a mais antiga, com o prompt, o id da resposta, o modelo, a data e um excerto em texto simples. Um membro da equipa também precisa da permissão Prompts e, para provider=youtube, da permissão YouTube Intelligence. Predefinição: os últimos 30 dias.

  • Parâmetros: project_id (obrigatório), provider (obrigatório: youtube|instagram|facebook|tiktok|linkedin), url ou profile (um dos dois), model, collection_id, country_code, language_code, brand_kind, range, from, to, page, per_page, output.

GET/dimensions/reddit

Conteúdo do Reddit citado em respostas de IA. view=subreddits (predefinição) devolve uma linha por subreddit, com a respetiva contagem de citações, autores únicos e a divisão entre sentimento positivo e negativo. view=authors devolve uma linha por autor. view=threads devolve as threads citadas individualmente, com votos positivos, comentários, posição média e sentimento dominante. O filtro brand lê as marcas mencionadas no conteúdo do Reddit recolhido, não na resposta de IA. Predefinição: os últimos 30 dias.

view=breakdowns devolve os valores por detrás de Reddit Intelligence > Sentimento e divisões. citations é o número de citações do Reddit depois de aplicados os filtros, e cada linha de data é uma fatia: breakdown é sentiment (o sentimento da resposta de IA que citou o Reddit, com todas as categorias listadas, incluindo as que estão a zero), model ou country, com key, count e pct (a percentagem dentro da respetiva divisão, tal como aparece nos gráficos da página). As citações cuja resposta ainda não tem sentimento ficam de fora das linhas de sentimento. order e direction não se aplicam.

Parâmetros:
  • project_idobrigatório
  • viewsubreddits|authors|threads
  • subreddit
  • author
  • statusopen|archived, apenas threads
  • owned
  • brandbrand ou um id de concorrente
  • order
  • direction
  • model
  • collection_id
  • country_code
  • language_code
  • brand_kind
  • range
  • from
  • to
  • page
  • per_page
  • output

GET/projects/:id/owned_media

Os perfis cujas citações contam como suas, por plataforma (YouTube, lojas de aplicações, Instagram, Facebook, TikTok, LinkedIn, Reddit): o perfil principal, os perfis adicionais e os subreddits e nomes de utilizador do Reddit reivindicados, cada um com o respetivo URL, identificador, nome, avatar e estado de recolha. settings contém o valor atual de cada campo que a atualização aceita.

Parâmetros:
  • idobrigatório, o ID do projeto no caminho

PATCH/projects/:id/owned_media

Define ou remove os perfis principais e adicionais de cada plataforma e os subreddits e nomes de utilizador do Reddit reivindicados. Envie apenas os campos a alterar: uma string vazia ou null remove um URL, e uma lista substitui a lista guardada ([] esvazia-a). Os URLs são validados como nas Definições do projeto, e um perfil novo é recolhido em segundo plano para obter o nome e o avatar. Requer uma chave de API com o âmbito read_write.

Corpo:
  • youtube_channel_url
  • app_store_url
  • google_play_url
  • instagram_profile_url
  • facebook_page_url
  • tiktok_profile_url
  • linkedin_company_url
  • <platform>_extra_profile_urlsyoutube, mobile_apps, instagram, facebook, tiktok, linkedin
  • reddit_subreddits
  • reddit_usernames