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.
project_idobrigatórioproviderobrigatório:youtube|instagram|facebook|tiktok|linkedin|mobile_apps|trustpilotviewvideos|channels|posts|profiles|own_citations|apps|brands|reviews|activity, os valores permitidos dependem do fornecedorstoregoogle_play|app_store, apenas mobile_appsownedmodelcollection_idcountry_codelanguage_codebrand_kindrangefromtopageper_pageoutput
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.
project_idobrigatórioproviderobrigatório:youtube|instagram|facebook|tiktok|linkedin|mobile_apps|reddit|trustpilot|overviewmodelcollection_idcountry_codelanguage_codebrand_kindrangefromto
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),urlouprofile(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.
project_idobrigatórioviewsubreddits|authors|threadssubredditauthorstatusopen|archived, apenas threadsownedbrandbrandou um id de concorrenteorderdirectionmodelcollection_idcountry_codelanguage_codebrand_kindrangefromtopageper_pageoutput
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.
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.
youtube_channel_urlapp_store_urlgoogle_play_urlinstagram_profile_urlfacebook_page_urltiktok_profile_urllinkedin_company_url<platform>_extra_profile_urlsyoutube, mobile_apps, instagram, facebook, tiktok, linkedinreddit_subredditsreddit_usernames