DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Links de página
Todos os links encontrados durante um rastreamento, por id. Filtre com page_from e page_to para obter os links que saem de uma página ou entram nela. Retorna total_items_count, items_count, items e um search_after_token para paginação — use-o em vez de offset depois das primeiras páginas. Lê um rastreamento concluído, portanto precisa do id de post_dataforseo_on_page_submit e retorna crawl_progress mais um crawl_status com max_crawl_pages, pages_in_queue e pages_crawled — verifique esses valores antes de confiar em um resultado pequeno, pois um rastreamento ainda em andamento simplesmente tem menos a relatar.💰 Gratuito no upstream: consultar um rastreamento concluído não custa nada; só o próprio rastreamento custa.
Referência de preços
- Medição: Custo da resposta reportado.
- Estimativa de referência por requisição: USD 0.012.
- 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)[]
- filtersTipo: array (object | null)[] | null
array de parâmetros de filtragem de resultados
campo opcional
você pode adicionar vários filtros de uma vez (máximo de 8 filtros)
você deve definir um operador lógicoand,orentre as condições
os seguintes operadores são suportados:regex,not_regex,=,<>,in,not_in,like,not_like
você pode usar o operador%comlikeenot_likepara corresponder a qualquer string de zero ou mais caracteres
exemplo:["direction","=","external"][["domain_to","<>","example.com"],
"and",
["link_from","not_like","%example.com/blog%"]][["direction","=","external"],
"and",
[["link_from","like","%example.com/blog%"],"or",["link_from","like","%example.com/help%"]]]A lista completa dos filtros possíveis está disponível neste link.
Objeto vazio - idTipo: string
- limitTipo: integer | null
o número máximo de links retornados
campo opcional
valor padrão:100
valor máximo:1000 - offsetTipo: integer | null
deslocamento no array de resultados dos links retornados
campo opcional
valor padrão:0
valor máximo:2000000
se você especificar o valor10, os dez primeiros links do array de resultados serão omitidos e os dados serão fornecidos para os links seguintes - pageTipo: string | null
_from URL relativa da página
campo opcional
se você usar este campo, a resposta da API conterá apenas links da página especificada
observe que neste campo você pode especificar apenas URLs relativas - pageTipo: string | null
_to URL relativa da página
campo opcional
se você usar este campo, a resposta da API conterá apenas links internos que apontam para a página especificada
observe que neste campo você pode especificar apenas URLs relativas - searchTipo: string | null
_after _token token para requisições subsequentes
campo opcional
fornecido no campo idêntico da resposta a cada requisição;
use este parâmetro para evitar timeouts ao tentar obter mais de20,000resultados em uma única requisição;
ao especificar o valor exclusivo desearch_after_tokendo array de resposta, você receberá os resultados subsequentes da tarefa inicial;
os valores desearch_after_tokensão exclusivos para cada tarefa subsequente ;
Observação: se osearch_after_tokenfor especificado na requisição, todos os outros parâmetros deverão ser idênticos aos da requisição anterior - 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
- Tipo: object | null · Response36Afe1097B20_OnPageLinksResponseInfo200
- 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_OnPageLinksTaskInfo
- 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
- crawlTipo: string | null
_progress status da sessão de rastreamento
valores possíveis:in_progress,finished - crawlTipo: object | null · Response36Afe1097B20_CrawlStatusInfo
_status detalhes da sessão de rastreamento
- maxTipo: integer | null Formato: int64
_crawl _pages número máximo de páginas a rastrear indica o limite max_crawl_pages que você especificou ao definir uma tarefa
- pagesTipo: integer | null Formato: int64
_crawled número de páginas rastreadas
- pagesTipo: integer | null Formato: int64
_in _queue número de páginas atualmente na fila de rastreamento
- currentTipo: integer | null
_offset Integer numbers.
- itemsTipo: array (object | null)[] | null
array items
- directionTipo: string | null
direção do link
valores possíveis:internal,external - dofollowTipo: boolean | null
indica se o link é dofollow
se o valor fortrue, o link não tem um atributorel="nofollow" - domainTipo: string | null
_from domínio de referência
o link foi encontrado neste domínio - domainTipo: string | null
_to domínio referenciado
o link aponta para este domínio - isTipo: boolean | null
_broken link quebrado
indica se um link direciona para uma página ou recurso quebrado - isTipo: boolean | null
_link _relation _conflict indica que o link pode ter conflito com outro link
se fortrue, pelo menos um link que aponta paralink_totem um atributorel="nofollow"e pelo menos um é dofollow - linkTipo: string | null
_from página de referência
URL absoluta da página onde o link foi encontrado - linkTipo: string | null
_to página referenciada
URL absoluta da página para a qual o link aponta - pageTipo: string | null
_from página de referência
URL relativa da página onde o link foi encontrado - pageTipo: string | null
_from _scheme - pageTipo: string | null
_to página referenciada
URL relativa da página para a qual o link aponta - pageTipo: string | null
_to _scheme - pageTipo: integer | null
_to _status _code código de status da página referenciada
código de status da página para a qual o link aponta - typeTipo: string | null
tipo de elemento
- itemsTipo: integer | null Formato: int64
_count número de itens no array de resultados
- searchTipo: string | null
_after _token - totalTipo: integer | null Formato: int64
_items _count número total de itens relevantes no banco de dados
- 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/on_page/links \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"id": "07281559-0695-0216-0000-c269be8b7592",
"page_from": "/apis/google-trends-api",
"filters": [
[
"dofollow",
"=",
true
],
"and",
[
"direction",
"=",
"external"
]
],
"limit": 10
}
]'
{
"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": [
{
"crawl_progress": null,
"crawl_status": {
"max_crawl_pages": null,
"pages_in_queue": null,
"pages_crawled": null
},
"search_after_token": null,
"current_offset": null,
"total_items_count": null,
"items_count": null,
"items": [
{
"type": null,
"domain_from": null,
"domain_to": null,
"page_from": null,
"page_to": null,
"link_from": null,
"link_to": null,
"dofollow": null,
"page_from_scheme": null,
"page_to_scheme": null,
"direction": null,
"is_broken": null,
"is_link_relation_conflict": null,
"page_to_status_code": null
}
]
}
]
}
]
}