DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Visão geral de ranking do domínio
A presença de busca de um domínio: contagens de palavras-chave orgânicas e pagas, tráfego estimado e valor do tráfego, por location_code. Retorna se_type, target, total_count, items_count e items. Encapsulado no envelope do DataForSEO: dados em tasks[0].result, resultado em tasks[0].status_code — uma requisição rejeitada ainda retorna HTTP 200. Para os mesmos números ao longo do tempo, use post_dataforseo_labs_google_historical_rank_live; para muitos domínios de uma vez, post_dataforseo_labs_google_bulk_traffic_estimation_live.
Referência de preços
- Medição: Custo da resposta reportado.
- Estimativa de referência por requisição: USD 0.0121.
- Multiplicador de referência do cliente: 1.0. Não o aplique novamente a um valor de cliente já liquidado.
Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.
- Tipo: array (object | null)[]
- ignoreTipo: boolean | null
_synonyms ignora palavras-chave altamente semelhantes
campo opcional
se definido comotrue, todas as palavras-chave altamente semelhantes serão excluídas dos cálculos de classificação e tráfego, e os resultados serão baseados nos dados das palavras-chave principais dos grupos de sinônimos
valor padrão:false - languageTipo: string | null
_code código do idioma
campo opcional
se você usar este campo, não precisa especificarlanguage_name
você pode obter a lista de idiomas disponíveis com seuslanguage_codefazendo uma requisição separada para ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore este campo para obter os resultados de todos os idiomas disponíveis
exemplo:en - languageTipo: string | null
_name nome completo do idioma
campo opcional
se você usar este campo, não precisa especificarlanguage_code
você pode obter a lista de idiomas disponíveis com seuslanguage_namefazendo uma requisição separada para ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore este campo para obter os resultados de todos os idiomas disponíveis
exemplo:English - limitTipo: integer | null
o número máximo de resultados retornados por domínio
campo opcional
valor padrão:100
valor máximo:1000 - locationTipo: integer | null
_code código do local
campo opcional
se você usar este campo, não precisa especificarlocation_name
você pode obter a lista de locais disponíveis com seulocation_codefazendo uma requisição separada para ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore este campo para obter os resultados de todos os locais disponíveis
exemplo:2840 - locationTipo: string | null
_name nome completo do local
campo opcional
se você usar este campo, não precisa especificarlocation_code
você pode obter a lista de locais disponíveis com seulocation_namefazendo uma requisição separada para ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignore este campo para obter os resultados de todos os locais disponíveis
exemplo:United Kingdom - offsetTipo: integer | null
deslocamento no array de resultados dos itens retornados
campo opcional
valor padrão:0
se você especificar o valor10, os dez primeirositemsdo array de resultados serão omitidos e os dados serão fornecidos para os itens seguintes - tagTipo: string | null
identificador de tarefa definido pelo usuário
campo opcional
o limite de caracteres é 255
você pode usar este parâmetro para identificar a tarefa e associá-la ao resultado
você encontrará o valor detagespecificado no objetodatada resposta - targetTipo: string
domínio
campo obrigatório
o nome do domínio do site de destino
o domínio deve ser especificado semhttps://ewww.
- Tipo: object | null · Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveResponseInfo200
- Tipo: number | null Formato: doublecost
custo total das tarefas, USD
- Tipo: integer | nullstatus
_code código de status geral você pode encontrar a lista completa dos códigos de resposta aqui
- Tipo: string | nullstatus
_message mensagem informativa geral você pode encontrar a lista completa das mensagens informativas gerais aqui
- Tipo: array (object | null)[] | nulltasks
array de tarefas
- Tipo: object | null · Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveTaskInfo
- costTipo: number | null Formato: double
custo total das tarefas, USD
- dataTipo: object | null
contém os mesmos parâmetros que você especificou na requisição POST
- propertyTipo: object | null
Name
- idTipo: string | null
identificador da tarefa identificador exclusivo da tarefa em nosso sistema no formato UUID
- pathTipo: array (string | null)[] | null
caminho da URL
- resultTipo: array (object | null)[] | null
array de resultados
- itemsTipo: array (object | null)[] | null
contém dados de ranking e tráfego
- languageTipo: string | null
_code código de idioma em um array POST
- locationTipo: integer | null
_code código de localização em um array POST
- metricsTipo: object | null
dados de ranking relevantes para o domínio especificado
- propertyTipo: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
Name - clickstreamTipo: object | null
_age _distribution - propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- clickstreamTipo: number | null Formato: double
_etv volume de tráfego estimado com base em dados de clickstream
calculado como o produto dos valores de click-through-rate e de volume de pesquisa de clickstream de todas as palavras-chave para as quais o domínio ranqueia
para obter resultados para este campo, o parâmetroinclude_clickstream_datadeve ser definido comotrue
saiba mais sobre como a métrica é calculada neste artigo da central de ajuda - clickstreamTipo: object | null
_gender _distribution - propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- countTipo: integer | null Formato: int64
contagem total de SERPs orgânicas que contêm o domínio ou subdomínio
- estimatedTipo: number | null
_paid _traffic _cost custo estimado da conversão de tráfego de pesquisa orgânica em pago
representa o custo mensal estimado (USD) de veicular anúncios para todas as palavras-chave da categoria para as quais o domínio ou subdomínio ranqueia
a métrica é calculada como o produto dos valores deetvorgânico ecpcpago e indica o custo de direcionar o volume estimado de tráfego orgânico mensal por meio de publicidade PPC no Google Search
saiba mais sobre como a métrica é calculada neste artigo da central de ajuda - etvTipo: number | null
volume de tráfego estimado
tráfego orgânico mensal estimado para o domínio ou subdomínio
calculado como o produto dos valores de CTR (click-through-rate) e de volume de pesquisa de todas as palavras-chave da categoria para as quais o domínio ou subdomínio ranqueia
saiba mais sobre como a métrica é calculada neste artigo da central de ajuda - isTipo: integer | null
_down rank caiu
indica quantos elementos ranqueados do destino indicado caíram - isTipo: integer | null
_lost elementos ranqueados perdidos
indica quantos elementos ranqueados do destino indicado estavam presentes anteriormente nas SERPs, mas não foram encontrados durante a última verificação - isTipo: integer | null
_new número de novos elementos ranqueados
indica quantos novos elementos ranqueados foram encontrados para o destino indicado - isTipo: integer | null
_up rank subiu
indica quantos elementos ranqueados do destino indicado subiram - posTipo: integer | null
_1 número de SERPs orgânicas em que o domínio ou subdomínio ocupa a posição #1
- posTipo: integer | null
_11 _20 número de SERPs orgânicas em que o domínio ou subdomínio ocupa a posição #11-20
- posTipo: integer | null
_2 _3 número de SERPs orgânicas em que o domínio ou subdomínio ocupa a posição #2-3
- posTipo: integer | null
_21 _30 número de SERPs orgânicas em que o domínio ou subdomínio ocupa a posição #21-30
- posTipo: integer | null
_31 _40 número de SERPs orgânicas em que o domínio ou subdomínio ocupa a posição #31-40
- posTipo: integer | null
_4 _10 número de SERPs orgânicas em que o domínio ou subdomínio ocupa a posição #4-10
- posTipo: integer | null
_41 _50 número de SERPs orgânicas em que o domínio ou subdomínio ocupa a posição #41-50
- posTipo: integer | null
_51 _60 número de SERPs orgânicas em que o domínio ou subdomínio ocupa a posição #51-60
- posTipo: integer | null
_61 _70 número de SERPs orgânicas em que o domínio ou subdomínio ocupa a posição #61-70
- posTipo: integer | null
_71 _80 número de SERPs orgânicas em que o domínio ou subdomínio ocupa a posição #71-80
- posTipo: integer | null
_81 _90 número de SERPs orgânicas em que o domínio ou subdomínio ocupa a posição #81-90
- posTipo: integer | null
_91 _100 número de SERPs orgânicas em que o domínio ou subdomínio ocupa a posição #91-100
- seTipo: string | null
_type tipo de mecanismo de busca
- itemsTipo: integer | null Formato: int64
_count o número de resultados retornados no array
items - languageTipo: string | null
_code código de idioma em um array POST
- locationTipo: integer | null
_code código de localização em um array POST
- seTipo: string | null
_type tipo de mecanismo de busca
- targetTipo: string | null
domínio de destino em um array POST
- totalTipo: integer | null Formato: int64
_count quantidade total de resultados em nosso banco de dados relevantes para a sua solicitação
- resultTipo: integer | null Formato: int64
_count número de elementos no array de resultados
- statusTipo: integer | null
_code código de status da tarefa gerado pelo DataForSEO; pode estar no seguinte intervalo: 10000-60000 você pode encontrar a lista completa dos códigos de resposta aqui
- statusTipo: string | null
_message mensagem informativa da tarefa você pode encontrar a lista completa das mensagens informativas gerais aqui
- timeTipo: string | null
tempo de execução, segundos
- Tipo: integer | null Formato: int64tasks
_count o número de tarefas no array de tarefas
- Tipo: integer | null Formato: int64tasks
_error o número de tarefas no array de tarefas retornadas com erro
- Tipo: string | nulltime
tempo total de execução, em segundos
- Tipo: string | nullversion
a versão atual da API
application/json - 400
Não foi possível processar a requisição. Verifique os parâmetros da requisição.
- 401
É necessária uma chave de API da Felo válida.
- 402
A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.
- 403
A conta não tem permissão para realizar esta operação.
- 429
Um limite de requisições ou de gastos foi atingido.
- 502
O serviço não pôde concluir a requisição.
- 503
A API ou o serviço de cobrança está temporariamente indisponível.
- 504
O serviço atingiu o tempo limite ao processar a requisição.
- default
Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/domain_rank_overview/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "dataforseo.com",
"language_name": "English",
"location_code": 2840
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"se_type": null,
"target": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"location_code": null,
"language_code": null,
"metrics": null
}
]
}
]
}
]
}