Docs
Rechercher dans la documentation...⌘K

Pages Web

API + MCPEntreprise uniquement
POST/v3/brand-radar/web-pages

Renvoie les pages web qui mentionnent les marques ou les concurrents demandés. Les mentions de marque sont mises en correspondance avec les titres des pages et le contenu issu de l’index web d’Ahrefs.

Corps de la requête

selectarray<string>Required

Liste des champs à renvoyer.

Example:["field_a","field_b"]
whereobject

L’expression de filtre. Les identifiants de colonne suivants sont reconnus (ils diffèrent des identifiants reconnus par le paramètre select).

report_idstring

L’ID du rapport à utiliser. Si un ID est fourni, les autres paramètres sont repris du rapport (marque, concurrents, marché, pays, filtres). Si le pays ou les filtres sont fournis, ils remplacent ceux du rapport. Vous pouvez le trouver dans l’URL de votre rapport Brand Radar dans Ahrefs : https://app.ahrefs.com/brand-radar/reports/#report_id#/...

brandsarray<object>

Une liste de noms de marques et de sites web dont rechercher les mentions sur des pages web.

Default:[]
At least one of names or url_groups is required
namesarray<string>

Les noms de la marque/du concurrent

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required

Le domaine de la cible

Example:ahrefs.com
scopestringrequired

Portée de la cible.

Valeurs autorisées:urlpathdomainsubdomains
competitorsarray<object>

Une liste de noms de concurrents et de sites web dont rechercher les mentions sur des pages web.

Default:[]
At least one of names or url_groups is required
namesarray<string>

Les noms de la marque/du concurrent

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required

Le domaine de la cible

Example:ahrefs.com
scopestringrequired

Portée de la cible.

Valeurs autorisées:urlpathdomainsubdomains
content_filterobject

Expressions facultatives permettant d’inclure ou d’exclure des résultats en fonction de leur contenu.

includearray<string>

Afficher uniquement les résultats contenant au moins l’une de ces expressions exactes.

excludearray<string>

Masquer les résultats contenant l’une quelconque de ces expressions exactes.

limitinteger

Le nombre de pages web à renvoyer.

Default:1000
order_bystring

Comment trier les pages web.

Valeurs autorisées:relevancetraffic
Default:relevance
page_typestring

Indique s’il faut renvoyer toutes les pages web ou uniquement les pages d’actualités.

Valeurs autorisées:all_pagesnews
Default:all_pages
publication_typestring

Indique s’il faut renvoyer toutes les pages, les pages publiées une seule fois ou les pages republiées.

Valeurs autorisées:allpublished_oncerepublished
Default:all
date_fromstring (date)

Le début de la plage de dates de publication, au format AAAA-MM-JJ. Nécessite date_to.

date_tostring (date)

La fin incluse de la plage de dates de publication, au format AAAA-MM-JJ. Nécessite date_from.

platformstring

La plateforme ou la technologie utilisée par la page.

Valeurs autorisées:allblogswordpressecommercecmsmessage-boardswikis
Default:all
languagestring

La langue de la page.

Valeurs autorisées:allenesruzh-cnjaafsqarbnbgzh-twhrcsda…
Default:all
outputstring

Le format de sortie.

Valeurs autorisées:jsoncsvxmlphp

Réponses

pagesarray<object>
contentstring

Un extrait du contenu de la page contenant la mention.

domain_ratinginteger

Le Domain Rating du domaine de la page.

referring_domainsinteger or null

Le nombre de domaines uniques liés à la page.

titlestring

Le titre de la page.

trafficnumber (float) or null

Le trafic de recherche organique mensuel estimé de la page.

traffic_valuenumber (float)

La valeur mensuelle estimée du trafic de recherche organique de la page, en USD.

urlstring (url)

L’URL de la page mentionnant une marque ou un concurrent demandé.