Projetos

Somente API

POST/v3/management/projects

As solicitações para este endpoint são gratuitas e não consomem unidades da API.

Parâmetros de consulta

outputstring

O formato de saída.

Valores permitidos:jsoncsvxmlphp

Corpo da solicitação

owned_bystring

O e-mail do proprietário do projeto. Se não for informado, o projeto será atribuído ao proprietário do Workspace.

accessstring

O tipo de acesso do projeto.

Allowed values:privateshared

Default:private

protocolstringRequired

O protocolo do alvo do projeto.

Allowed values:bothhttphttps

urlstringRequired

A URL do alvo do projeto.

modestringRequired

O escopo do alvo.

Allowed values:exactprefixdomainsubdomains

project_namestringRequired

O nome do projeto.

Respostas

projectsarray<object>

project_idstring

O identificador exclusivo do projeto. Você pode encontrá-lo na URL do seu projeto do Rank Tracker no Ahrefs: https://app.ahrefs.com/rank-tracker/overview/#project_id#.

project_namestring

O nome do projeto.

urlstring

A URL do alvo do Projeto.

modestring

O escopo do alvo. Valores possíveis: exact, prefix, domain, subdomains.

protocolstring

O protocolo do alvo. Valores possíveis: both, http, https.

accessstring

O nível de acesso do Projeto. Valores possíveis: private, shared.

owned_bystring or null

O e-mail do proprietário do Projeto.

keyword_countinteger

O número de palavras-chave no Projeto.

web_analytics_data_keystring

Chave de dados do 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" } ] }