Crawl links
dataforseo.x.on-page-linksThis endpoint will provide you with a list of internal and external links detected on a target website.
- Preço
- freePelo preço de tabela
- Taxa de sucesso
- —Ainda não há dados da taxa de sucessoAinda não há dados da taxa de sucesso
- Latência p50
- ——
- Última verificação
- —Ainda não verificado
POSThttps://toolswitch.dev/v1/tools/dataforseo.x.on-page-linksBeta- Usa a cota da plataforma
- Resposta síncrona
- Lê dados públicos
Parâmetros
the POST body is a JSON array holding exactly one task object with these fields
| Parâmetro | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| Corpo (JSON) | ||||
id | string | Opcional | ID of the task required field you can get this ID in the response of the Task POST endpoint example: “07131248-1535-0216-1000-17384017ad04” | 07281559-0695-0216-0000-c269be8b7592 |
tag | string | Opcional | user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response | |
limit | inteiro | Opcional | the maximum number of returned links optional field default value: 100 maximum value: 1000 | 10 |
offset | inteiro | Opcional | offset in the results array of returned links optional field default value: 0 maximum value: 2000000 if you specify the 10 value, the first ten links in the results array will be omitted and the data will be provided for the successive links | |
filters | matriz | Opcional | array of results filtering parameters optional field you can add several filters at once (8 filters maximum) you should set a logical operator and, or between the conditions the following operators are supported: regex, not_regex, =, <>, in, not_in, like, not_like you can use the % operator with lik | [["dofollow","=",true],"and",["direction","=","external"]] |
page_to | string | Opcional | relative page URL optional field if you use this field, the API response will contain only internal links pointing to the specified page note that in this field you can specify relative URLs only | |
page_from | string | Opcional | relative page URL optional field if you use this field, the API response will contain only links from the specified page note that in this field you can specify relative URLs only | /apis/google-trends-api |
search_after_token | string | Opcional | token for subsequent requests optional field provided in the identical filed of the response to each request; use this parameter to avoid timeouts while trying to obtain over 20,000 results in a single request; by specifying the unique search_after_token value from the response array, you will get t | |
- Corpo (JSON)
idstringOpcionalID of the task required field you can get this ID in the response of the Task POST endpoint example: “07131248-1535-0216-1000-17384017ad04”
Exemplo:
07281559-0695-0216-0000-c269be8b7592tagstringOpcionaluser-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response
limitinteiroOpcionalthe maximum number of returned links optional field default value: 100 maximum value: 1000
Exemplo:
10offsetinteiroOpcionaloffset in the results array of returned links optional field default value: 0 maximum value: 2000000 if you specify the 10 value, the first ten links in the results array will be omitted and the data will be provided for the successive links
filtersmatrizOpcionalarray of results filtering parameters optional field you can add several filters at once (8 filters maximum) you should set a logical operator and, or between the conditions the following operators are supported: regex, not_regex, =, <>, in, not_in, like, not_like you can use the % operator with lik
Exemplo:
[["dofollow","=",true],"and",["direction","=","external"]]page_tostringOpcionalrelative page URL optional field if you use this field, the API response will contain only internal links pointing to the specified page note that in this field you can specify relative URLs only
page_fromstringOpcionalrelative page URL optional field if you use this field, the API response will contain only links from the specified page note that in this field you can specify relative URLs only
Exemplo:
/apis/google-trends-apisearch_after_tokenstringOpcionaltoken for subsequent requests optional field provided in the identical filed of the response to each request; use this parameter to avoid timeouts while trying to obtain over 20,000 results in a single request; by specifying the unique search_after_token value from the response array, you will get t
Exemplos de código
Substitua $TOOLSWITCH_KEY pela chave criada no console.
curl -X POST 'https://toolswitch.dev/v1/tools/dataforseo.x.on-page-links' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"POST",
"https://toolswitch.dev/v1/tools/dataforseo.x.on-page-links",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/dataforseo.x.on-page-links", {
method: "POST",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());Esta API de gateway está em Beta; a URL e a autenticação podem mudar. Os parâmetros do exemplo são dados de amostra. As chamadas são cobradas a free, incluindo a taxa de serviço.