Médias propriétaires et communautés
Vos propres canaux et les conversations communautaires que citent les réponses de l’IA. Toutes les lignes de la plateforme sont renvoyées, pas seulement les vôtres, chacune avec un indicateur yours pour comparer votre présence à celle de tous les autres acteurs cités au même endroit. Disponible à partir du forfait Growth.
GET/dimensions/owned_media
Citations des médias propriétaires pour une plateforme. provider est obligatoire ; s’il est omis, l’API renvoie ERR_INVALID_PARAM. Les vues dépendent de la plateforme : youtube accepte videos (par défaut), channels, own_citations ; les réseaux sociaux acceptent posts (par défaut), profiles, own_citations ; mobile_apps accepte apps ; trustpilot accepte profiles (par défaut), brands, reviews. Toutes les plateformes prennent en charge activity : une ligne par entité et par période de suivi réelle du projet, avec une date ISO de début de période, des identifiants pouvant valoir null, les métadonnées actuelles, un indicateur de propriété et les citations. Les périodes sans exécution sont omises ; une exécution sans citation renvoie zéro. Les décomptes couvrent la période sélectionnée ; les métadonnées sont actuelles, pas historiques. Les lignes d’applications mobiles incluent store et competitor_id (pouvant valoir null) ; entity_name est l’ID de l’application, sans recherche externe. own_citations ne liste que les citations des profils connectés et reste vide tant qu’aucun profil n’est connecté. Les membres de l’équipe ont besoin de l’autorisation « Réseaux et communautés : profils et applications », ainsi que de YouTube Intelligence pour provider=youtube. Période par défaut : 30 jours.
project_idobligatoireproviderobligatoire :youtube|instagram|facebook|tiktok|linkedin|mobile_apps|trustpilotviewvideos|channels|posts|profiles|own_citations|apps|brands|reviews|activity, valeurs autorisées selon la plateformestoregoogle_play|app_store, mobile_apps uniquementownedmodelcollection_idcountry_codelanguage_codebrand_kindrangefromtopageper_pageoutput
GET/dimensions/owned_media/summary
Les synthèses et graphiques des médias propriétaires incluent les citations actuelles, les citations des profils et contenus propriétaires, share_pct, les valeurs et variations de la période précédente de même durée, les décomptes hebdomadaires et les répartitions disponibles par modèle, pays, type de contenu et ancienneté. Chaque plateforme renvoie activity pour chaque période de suivi réelle du projet ; date correspond au début de la période. Les lignes incluent citations, yours et other. La vue d’ensemble met yours et other à null et renvoie l’activité de chaque plateforme lisible. Les périodes sans exécution sont omises ; une exécution sans citation vaut zéro. Les décomptes couvrent la période sélectionnée. Les semaines restent calées sur le lundi. provider=overview renvoie un cumul par plateforme ; provider=mobile_apps ajoute les totaux par boutique d’applications. Reddit ajoute unique_subreddits, unique_authors, positive_pct, share_pct ainsi que les décomptes positifs, neutres et négatifs dans activity pour les réponses de l’IA qui citent Reddit. subreddit_activity regroupe les cinq premiers subreddits et Others ; positions contient position_1, position_2_3, position_4_7 et position_7_plus ; brand_share regroupe les marques suivies et les concurrents. Les variations de décomptes sont des pourcentages, celles des parts sont des points de pourcentage, et les variations valent null quand elles ne peuvent pas être calculées. Les membres de l’équipe ont besoin de l’autorisation « Réseaux et communautés : profils et applications », ainsi que de Reddit Intelligence ou YouTube Intelligence pour ces plateformes. Période par défaut : 30 jours.
project_idobligatoireproviderobligatoire :youtube|instagram|facebook|tiktok|linkedin|mobile_apps|reddit|trustpilot|overviewmodelcollection_idcountry_codelanguage_codebrand_kindrangefromto
GET/dimensions/owned_media/citing_prompts
Les réponses de l’IA à l’origine d’une ligne d’un tableau Médias propriétaires ou YouTube Intelligence. Passez soit url (URL d’une publication ou d’une vidéo), soit profile (un nom de compte, l’URL d’un profil ou d’une chaîne, ou la key de la chaîne issue de la vue des chaînes), pas les deux. Renvoie l’élément avec ses statistiques, ses nombres de citations et de prompts, ainsi que les réponses qui le citent, des plus récentes aux plus anciennes, avec le prompt, l’ID de la réponse, le modèle, la date et un extrait en texte brut. Un membre de l’équipe a aussi besoin de l’autorisation Prompts, et de l’autorisation YouTube Intelligence pour provider=youtube. Période par défaut : 30 derniers jours.
- Paramètres :
project_id(obligatoire),provider(obligatoire :youtube|instagram|facebook|tiktok|linkedin),urlouprofile(l’un des deux),model,collection_id,country_code,language_code,brand_kind,range,from,to,page,per_page,output.
GET/dimensions/reddit
Contenus Reddit cités par les réponses de l’IA. view=subreddits (par défaut) renvoie une ligne par subreddit avec son nombre de citations, ses auteurs uniques et la répartition du sentiment entre positif et négatif. view=authors renvoie une ligne par auteur. view=threads renvoie une à une les discussions citées, avec leurs votes positifs, leurs commentaires, leur position moyenne et leur sentiment dominant. Le filtre brand lit les marques mentionnées dans le contenu Reddit collecté, et non dans la réponse de l’IA. Période par défaut : 30 derniers jours.
view=breakdowns renvoie les chiffres de Reddit Intelligence > Sentiment et répartitions. citations est le nombre de citations Reddit après filtres, et chaque ligne de data correspond à un segment : breakdown vaut sentiment (le sentiment de la réponse de l’IA qui a cité Reddit, tous les libellés étant listés, zéro compris), model ou country, avec sa key, son count et son pct, la part au sein de sa répartition, telle que la page la représente. Les citations dont la réponse n’a pas encore de sentiment sont exclues des lignes de sentiment. order et direction ne s’appliquent pas.
project_idobligatoireviewsubreddits|authors|threadssubredditauthorstatusopen|archived, vue threads uniquementownedbrandbrandou l’ID d’un concurrentorderdirectionmodelcollection_idcountry_codelanguage_codebrand_kindrangefromtopageper_pageoutput
GET/projects/:id/owned_media
Les profils dont les citations comptent comme les vôtres, par plateforme (YouTube, stores d’applications, Instagram, Facebook, TikTok, LinkedIn, Reddit) : le profil principal, les profils supplémentaires, ainsi que les subreddits et noms d’utilisateur Reddit revendiqués, chacun avec son URL, son nom de compte, son nom, son avatar et son statut de collecte. settings contient la valeur actuelle de chaque champ accepté par la mise à jour.
idobligatoire, l’ID du projet dans le chemin
PATCH/projects/:id/owned_media
Définit ou efface les profils principaux et supplémentaires de chaque plateforme, ainsi que les subreddits et noms d’utilisateur Reddit revendiqués. N’envoyez que les champs à modifier : une chaîne vide ou null efface une URL, et une liste remplace celle enregistrée ([] l’efface). Les URL sont validées comme dans Paramètres du projet, et un nouveau profil est collecté en arrière-plan pour récupérer son nom et son avatar. Nécessite une clé 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