Projets

API uniquement

POST/v3/management/projects

Les requêtes vers ce point de terminaison sont gratuites et ne consomment aucune unité d’API.

Paramètres de requête

outputstring

Le format de sortie.

Valeurs autorisées:jsoncsvxmlphp

Corps de la requête

owned_bystring

L’adresse e-mail du propriétaire du projet. Si elle n’est pas fournie, le projet est attribué au propriétaire de l’espace de travail.

accessstring

Le type d’accès du projet.

Allowed values:privateshared

Default:private

protocolstringRequired

Le protocole de la cible du projet.

Allowed values:bothhttphttps

urlstringRequired

L’URL de la cible du projet.

modestringRequired

La portée de la cible.

Allowed values:exactprefixdomainsubdomains

project_namestringRequired

Le nom du projet.

Réponses

projectsarray<object>

project_idstring

L’identifiant unique du projet. Vous pouvez le trouver dans l’URL de votre projet Rank Tracker dans Ahrefs : https://app.ahrefs.com/rank-tracker/overview/#project_id#.

project_namestring

Le nom du projet.

urlstring

L'URL de la cible du projet.

modestring

La portée de la cible. Valeurs possibles : exact, prefix, domain, subdomains.

protocolstring

Le protocole de la cible. Valeurs possibles : both, http, https.

accessstring

Le niveau d'accès du projet. Valeurs possibles : private, shared.

owned_bystring or null

L'e-mail du propriétaire du projet.

keyword_countinteger

Le nombre de mots-clés dans le projet.

web_analytics_data_keystring

Clé de données Web Analytics.

curl "https://api.ahrefs.com/v3/management/projects" \ -X POST \ -H "Authorization: Bearer $AHREFS_API_KEY" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ --data-raw '{ "owned_by": "string", "access": "private", "protocol": "both", "url": "string", "mode": "exact", "project_name": "string" }'

{ "projects": [ { "project_id": "string", "project_name": "string", "url": "string", "mode": "string", "protocol": "string", "access": "string", "owned_by": "string", "keyword_count": 0, "web_analytics_data_key": "string" } ] }