DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Liens
Tous les liens trouvés pendant un crawl, par id. Filtrez avec page_from et page_to pour obtenir les liens sortants ou entrants d'une page. Renvoie total_items_count, items_count, items et un search_after_token pour la pagination — utilisez-le plutôt que offset au-delà des premières pages. Lit un crawl terminé : il lui faut l'id renvoyé par post_dataforseo_on_page_submit et il renvoie crawl_progress ainsi qu'un crawl_status composé de max_crawl_pages, pages_in_queue et pages_crawled — vérifiez ces valeurs avant de faire confiance à un petit résultat, car un crawl encore en cours a simplement moins à signaler.💰 Gratuit en amont : interroger un crawl terminé ne coûte rien, seul le crawl lui-même est facturé.
Référence tarifaire
- Mesure : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.012.
- Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à un montant client déjà réglé.
Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.
- Type: array (object | null)[]
- filtersType: array (object | null)[] | null
tableau de paramètres de filtrage des résultats
champ facultatif
vous pouvez ajouter plusieurs filtres à la fois (8 filtres maximum)
vous devez définir un opérateur logiqueand,orentre les conditions
les opérateurs suivants sont pris en charge :regex,not_regex,=,<>,in,not_in,like,not_like
vous pouvez utiliser l'opérateur%aveclikeetnot_likepour correspondre à toute chaîne de zéro caractère ou plus
exemple :["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%"]]]La liste complète des filtres possibles est disponible via ce lien.
Objet vide - idType: string
- limitType: integer | null
le nombre maximal de liens renvoyés
champ facultatif
valeur par défaut :100
valeur maximale :1000 - offsetType: integer | null
décalage dans le tableau de résultats des liens renvoyés
champ facultatif
valeur par défaut :0
valeur maximale :2000000
si vous spécifiez la valeur10, les dix premiers liens du tableau de résultats seront omis et les données seront fournies pour les liens suivants - pageType: string | null
_from URL relative de la page
champ facultatif
si vous utilisez ce champ, la réponse de l'API ne contiendra que les liens de la page spécifiée
notez que dans ce champ, vous ne pouvez indiquer que des URL relatives - pageType: string | null
_to URL relative de la page
champ facultatif
si vous utilisez ce champ, la réponse de l'API ne contiendra que les liens internes pointant vers la page spécifiée
notez que dans ce champ, vous ne pouvez indiquer que des URL relatives - searchType: string | null
_after _token jeton pour les requêtes suivantes
champ facultatif
fourni dans le champ identique de la réponse à chaque requête ;
utilisez ce paramètre pour éviter les délais d'attente lorsque vous essayez d'obtenir plus de20,000résultats en une seule requête ;
en indiquant la valeur uniquesearch_after_tokendu tableau de réponse, vous obtiendrez les résultats suivants de la tâche initiale ;
les valeurssearch_after_tokensont uniques pour chaque tâche suivante ;
Remarque : si lesearch_after_tokenest indiqué dans la requête, tous les autres paramètres doivent être identiques à ceux de la requête précédente - tagType: string | null
identifiant de tâche défini par l'utilisateur
champ facultatif
la limite est de 255 caractères
vous pouvez utiliser ce paramètre pour identifier la tâche et l'associer au résultat
vous trouverez la valeurtagspécifiée dans l'objetdatade la réponse
- Type: object | null · Response36Afe1097B20_OnPageLinksResponseInfo200
- Type: number | null Format: doublecost
coût total des tâches, USD
- Type: integer | nullstatus
_code code d'état général vous pouvez trouver la liste complète des codes de réponse ici
- Type: string | nullstatus
_message message d'information général vous pouvez trouver la liste complète des messages d'information généraux ici
- Type: array (object | null)[] | nulltasks
tableau de tâches
- Type: object | null · Response36Afe1097B20_OnPageLinksTaskInfo
- costType: number | null Format: double
coût total des tâches, USD
- dataType: object | null
contient les mêmes paramètres que ceux spécifiés dans la requête POST
- propertyType: object | null
Name
- idType: string | null
identifiant de la tâche identifiant unique de la tâche dans notre système au format UUID
- pathType: array (string | null)[] | null
chemin de l'URL
- resultType: array (object | null)[] | null
tableau de résultats
- crawlType: string | null
_progress état de la session d'exploration
valeurs possibles :in_progress,finished - crawlType: object | null · Response36Afe1097B20_CrawlStatusInfo
_status détails de la session d'exploration
- maxType: integer | null Format: int64
_crawl _pages nombre maximal de pages à explorer indique la limite max_crawl_pages que vous avez définie lors de la configuration d'une tâche
- pagesType: integer | null Format: int64
_crawled nombre de pages explorées
- pagesType: integer | null Format: int64
_in _queue nombre de pages actuellement dans la file d'exploration
- currentType: integer | null
_offset Integer numbers.
- itemsType: array (object | null)[] | null
tableau items
- directionType: string | null
direction du lien
valeurs possibles :internal,external - dofollowType: boolean | null
indique si le lien est dofollow
si la valeur esttrue, le lien n'a pas d'attributrel="nofollow" - domainType: string | null
_from domaine référent
le lien a été trouvé sur ce domaine - domainType: string | null
_to domaine référencé
le lien pointe vers ce domaine - isType: boolean | null
_broken lien brisé
indique si un lien mène vers une page ou une ressource brisée - isType: boolean | null
_link _relation _conflict indique que le lien peut entrer en conflit avec un autre lien
si la valeur esttrue, au moins un lien pointant verslink_topossède un attributrel="nofollow"et au moins un est dofollow - linkType: string | null
_from page référente
URL absolue de la page sur laquelle le lien a été trouvé - linkType: string | null
_to page référencée
URL absolue de la page vers laquelle pointe le lien - pageType: string | null
_from page référente
URL relative de la page sur laquelle le lien a été trouvé - pageType: string | null
_from _scheme - pageType: string | null
_to page référencée
URL relative de la page vers laquelle pointe le lien - pageType: string | null
_to _scheme - pageType: integer | null
_to _status _code code de statut de la page référencée
code de statut de la page vers laquelle pointe le lien - typeType: string | null
type d'élément
- itemsType: integer | null Format: int64
_count nombre d'éléments du tableau de résultats
- searchType: string | null
_after _token - totalType: integer | null Format: int64
_items _count nombre total d'éléments pertinents dans la base de données
- resultType: integer | null Format: int64
_count nombre d'éléments dans le tableau de résultats
- statusType: integer | null
_code code d'état de la tâche généré par DataForSEO ; peut être compris dans la plage suivante : 10000-60000 vous pouvez trouver la liste complète des codes de réponse ici
- statusType: string | null
_message message d'information de la tâche vous pouvez trouver la liste complète des messages d'information généraux ici
- timeType: string | null
temps d'exécution, en secondes
- Type: integer | null Format: int64tasks
_count le nombre de tâches dans le tableau de tâches
- Type: integer | null Format: int64tasks
_error le nombre de tâches dans le tableau de tâches renvoyées avec une erreur
- Type: string | nulltime
temps d'exécution total, en secondes
- Type: string | nullversion
la version actuelle de l'API
application/json - 400
La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.
- 401
Une clé API Felo valide est requise.
- 402
La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.
- 403
Le compte n'est pas autorisé à effectuer cette opération.
- 429
Une limite de requêtes ou de dépenses a été atteinte.
- 502
Le service n'a pas pu terminer la requête.
- 503
L'API ou le service de facturation est temporairement indisponible.
- 504
Le service a expiré lors du traitement de la requête.
- default
Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur
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
}
]
}
]
}
]
}