Cet article fait référence à la version héritée de notre API (v2). Notre version la plus récente de l'API (v3) a été publiée le 7 septembre 2022 et est disponible pour les utilisateurs Enterprise.
Note: Les plans d'API hérités ne peuvent plus être achetés, et l'API héritée est prévue pour le 1er mars 2024. API via Integrations ne fonctionnera plus à cette date. La nouvelle API est disponible maintenant, et uniquement sur le plan Entreprise.
N'hésitez pas à contacter [email protected] pour plus de détails.
Cet article mettra en évidence les bases de la création d'une requête API avec l'aide de notre API Request Builder.
Commençons par regarder dans le constructeur lui-même pour voir quelles options il contient:
Token - champ requis. Doit être généré ici.
Cible - champ requis. Ce devrait être un site web, un chemin ou une URL pour lesquels vous demandez des données.
Mode - champ requis. Vous pouvez choisir parmi les sous-domaines, domaines, exacts et préfixes. Nous avons une explication détaillée sur la différence entre tous ces modes dans notre vidéo.
De - champ requis. C'est une fonction API à partir de laquelle vous allez demander des données.
Limite (le cas échéant). Par défaut, il est défini à 1 000 000 avec une limite maximale de 5 millions de lignes par requête. Note: vous ne serez facturé que pour le montant exact des lignes retournées .
Sortie. Vous pouvez choisir la sortie de votre requête. Les options disponibles sont : json (par défaut), xml, php.
Plus d'options: l'ensemble des options disponibles ici variera en fonction de la requête API choisie.
Ici, vous pouvez également définir les paramètres “where/having” , ainsi que choisir Order by et Order
À la fin vous verrez une requête API faite conformément à vos choix ci-dessus.
Maintenant, créons une requête API simple en suivant le guide ci-dessus pour obtenir des liens rétroactifs pour ahrefs. om domaine (note: toutes les requêtes faites avec ahrefs. om et ses sous-domaines en tant que cible sont totalement gratuits, alors n'hésitez pas à utiliser ce domaine pour vos tests).
Nous sommes donc là:
Target: ahrefs.com
Mode : sous-domaines
De : liens de retour
Limite : 50
Sortie : json
Où : nous vérifions les backlinks avec l'ancre « ahrefs »
Trier par : Évaluation de domaine
Ordre: Desc (pour obtenir les domaines DR les plus élevés en premier)
API Request Builder fera le travail pour que vous encodiez les données et voici la requête que nous obtiendrons en fonction de notre entrée : https://apiv2. hrefs.com/?token=XXX&target=ahrefs.&limit=50&output=json&from=backlinks&mode=subdomains&where=title%3D"ahrefs"&order_by=domain_rating:desc