DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Backlinks
De afzonderlijke inkomende links naar één target, één rij per link. Retourneert total_count, items_count, items en een search_after_token voor paginering; gebruik dat in plaats van offset voorbij de eerste paar pagina's. mode en custom_mode bepalen de groepering, backlinks_status_type kiest live, lost of all. Voor aantallen in plaats van rijen gebruik je post_dataforseo_backlinks_summary_live; voor de verlinkende domeinen gegroepeerd post_dataforseo_backlinks_referring_domains_live.
Prijsreferentie
- Afrekening: gerapporteerde responskosten.
- Referentieschatting per verzoek: USD 0.06.
- Referentiemultiplier voor klanten: 1.0. Niet opnieuw toepassen op een al afgerekend klantbedrag.
Alleen referentiemetadata, geen accountofferte en geen gegarandeerde prijs of bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.
- Type: array (object | null)[]
- backlinksType: string | null
_status _type bepalen welke backlinks worden geretourneerd en geteld
optioneel veld
u kunt dit veld gebruiken om te kiezen welke backlinks worden geretourneerd en gebruikt voor geaggregeerde metrieken voor uwtarget;
mogelijke waarden:all- alle backlinks worden geretourneerd en geteld;live- backlinks die tijdens de laatste controle zijn gevonden, worden geretourneerd en geteld;lost- verloren backlinks worden geretourneerd en geteld;standaardwaarde:
live - customType: object | null
_mode groepeerwijze voor gedetailleerde resultaten
optioneel veld
gebruik dit object om een bepaald aantal backlinks perfieldte krijgen
bij gebruik vancustom_modewordtmodegenegeerd
voorbeeld:"custom_mode": {"field": "domain", "value": 100}- propertyType: object | null
Name
- excludeType: boolean | null
_internal _backlinks geeft aan of interne backlinks van subdomeinen naar het
targetuit de resultaten worden uitgesloten
optioneel veld
bijtruebevatten de resultaten geen gegevens over interne backlinks van subdomeinen van hetzelfde domein alstarget
bijfalseworden interne links in de resultaten opgenomen
standaardwaarde:true - filtersType: array (object | null)[] | null
array met filterparameters voor resultaten
optioneel veld
u kunt meerdere filters tegelijk toevoegen (maximaal 8 filters)
tussen de voorwaarden zet u een logische operatorandofor
de volgende operators worden ondersteund:=,<>,in,not_in,like,not_like,ilike,not_ilike,regex,not_regex,match,not_match
met de operator%inlikeennot_likekunt u elke tekenreeks van nul of meer tekens matchen
voorbeeld:["rank",">","80"][["page_from_rank",">","55"],
"and",
["dofollow","=",true]][["first_seen",">","2017-10-23 11:31:45 +00:00"],
"and",
[["anchor","like","%seo%"],"or",["text_pre","like","%seo%"]]]Leeg object - includeType: boolean | null
_subdomains geeft aan of de subdomeinen van het
targetin de zoekopdracht worden opgenomen
optioneel veld
bijfalseworden subdomeinen genegeerd
standaardwaarde:true - limitType: integer | null
het maximale aantal teruggegeven backlinks
optioneel veldstandaardwaarde:
100
maximale waarde:1000 - modeType: string | null
groepeerwijze voor resultaten
optioneel veld
mogelijke groepeerwijzen:as_is- retourneert alle backlinksone_per_domain- retourneert één backlink per domeinone_per_anchor- retourneert één backlink per ankerstandaardwaarde:
as_is - offsetType: integer | null
offset in de resultatenarray van de teruggegeven backlinks
optioneel veldstandaardwaarde:
0
bij de waarde10worden de eerste tien backlinks in de resultatenarray overgeslagen en worden de gegevens voor de volgende backlinks geleverd;
let op: de maximale waarde is20,000; gebruiksearch_after_tokenals u meer resultaten wilt overslaan - orderType: array string[] | null
_by sorteerregels voor resultaten
optioneel veld
u kunt dezelfde waarden als in de arrayfiltersgebruiken om de resultaten te sorteren
mogelijke sorteertypen:asc- resultaten worden oplopend gesorteerddesc- resultaten worden aflopend gesorteerd
sorteertype en -richting scheidt u met een komma
voorbeeld:["rank,desc"]
let op: u kunt per verzoek maximaal drie sorteerregels instellen
meerdere sorteerregels scheidt u met een komma
voorbeeld:["domain_from_rank,desc","page_from_rank,asc"] - rankType: string | null
_scale bepaalt de schaal die wordt gebruikt voor het berekenen en weergeven van de waarden
rank,domain_from_rankenpage_from_rank
optioneel veldmet deze parameter kiest u of rangwaarden op een schaal van 0–100 of 0–1000 worden weergegeven
mogelijke waarden:
one_hundred— rangwaarden worden weergegeven op een schaal van 0–100one_thousand— rangwaarden worden weergegeven op een schaal van 0–1000standaardwaarde:
one_thousandlees meer over hoe deze parameter werkt en hoe rangmeters worden berekend in dit Help Center-artikel
- searchType: string | null
_after _token token voor vervolgverzoeken
optioneel veld
wordt bij elk verzoek in het gelijknamige veld van de respons geleverd;
gebruik deze parameter om time-outs te voorkomen bij het ophalen van meer dan20,000resultaten in één verzoek;
met de unieke waardesearch_after_tokenuit de responsarray krijgt u de volgende resultaten van de oorspronkelijke taak;search_after_token-waarden zijn uniek per vervolgtaak;
let op: alssearch_after_tokenin het verzoek wordt opgegeven, moeten alle andere parameters identiek zijn aan die van het vorige verzoek - tagType: string | null
door gebruiker gedefinieerde taak-ID
optioneel veld
de tekenslimiet is 255
je kunt deze parameter gebruiken om de taak te identificeren en aan het resultaat te koppelen
de opgegeven waardetagvind je in hetdata-object van de respons - targetType: string
domein, subdomein of webpagina waarvoor backlinks worden opgehaald
verplicht veld
een domein of subdomein geeft u op zonderhttps://enwww.
een pagina geeft u op als absolute URL (inclusiefhttp://ofhttps://)
- Type: object | null · Response36Afe1097B20_BacklinksBacklinksLiveResponseInfo200
- Type: number | null Formaat: doublecost
Totale kosten van taken, USD
- Type: integer | nullstatus
_code algemene statuscode de volledige lijst met responscodes vindt u hier
- Type: string | nullstatus
_message algemeen informatief bericht de volledige lijst met algemene informatieve berichten vindt u hier
- Type: array (object | null)[] | nulltasks
array van taken
- Type: object | null · Response36Afe1097B20_BacklinksBacklinksLiveTaskInfo
- costType: number | null Formaat: double
Totale kosten van taken, USD
- dataType: object | null
Bevat dezelfde parameters die je in het POST-verzoek hebt opgegeven
- propertyType: object | null
Name
- idType: string | null
taak-id eenduidige taak-id in ons systeem in UUID-indeling
- pathType: array (string | null)[] | null
URL-pad
- resultType: array (object | null)[] | null
array van resultaten
- customType: object | null
_mode aangepaste modus opgegeven in een POST-array
- propertyType: object | null
Name
- itemsType: array (object | null)[] | null
bevat relevante gegevens over backlinks en verwijzende domeinen
- altType: string | null
alternatieve tekst van de afbeelding
dit veld isnullals hettypevan de backlink niet image is - anchorType: string | null
ankertekst van de backlink
- attributesType: array (string | null)[] | null
linkattributen van de verwijzende links
voorbeeld:nofollow - backlinkType: integer | null
_spam _score - dofollowType: boolean | null
geeft aan of de backlink dofollow is
alsfalse, is de backlink nofollow - domainType: string | null
_from domein dat verwijst naar het doeldomein of de doelwebpagina
- domainType: string | null
_from _country ISO-landcode van het verwijzende domein
- domainType: string | null
_from _ip IP-adres van het verwijzende domein
- domainType: boolean | null
_from _is _ip geeft aan of het domein een IP is
alstrue, fungeert het domein als IP-adres en heeft het geen domeinnaam - domainType: array (string | null)[] | null
_from _platform _type platformtypen van het verwijzende domein
mogelijke waarden:
cms,blogs,ecommerce,message-boards,wikis,news,organization - domainType: integer | null
_from _rank - domainType: string | null
_to domein waarnaar de backlink verwijst
- firstType: string | null
_seen datum en tijd waarop onze crawler de backlink voor het eerst heeft gevonden
in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:2019-11-15 12:57:46 +00:00 - groupType: integer | null Formaat: int64
_count geeft het totale aantal backlinks van dit domein aan
alsmodebijvoorbeeld opone_per_domainis ingesteld, geeft dit veld het totale aantal backlinks aan dat van dit domein afkomstig is - imageType: string | null
_url URL van de afbeelding
de URL die naar de afbeelding leidt op de oorspronkelijke bron of in de DataForSEO-opslag (als de oorspronkelijke bron niet beschikbaar is) - indirectType: array (object | null)[] | null
_link _path pad van de indirecte link
geeft een URL of een reeks URL's aan die naarurl_toleiden- statusType: integer | null
_code algemene statuscode
de volledige lijst met responscodes vindt u hier
Let op: we raden sterk aan een geschikt systeem te ontwerpen voor het afhandelen van gerelateerde uitzonderings- en foutsituaties - typeType: string | null
elementtype
- urlType: string | null
URL van de indirecte link
- isType: boolean | null
_broken geeft aan of de backlink kapot is
alstrue, verwijst de backlink naar een pagina die met statuscode 4xx of 5xx antwoordt - isType: boolean | null
_indirect _link geeft aan of de backlink een indirecte link is
alstrue, is de backlink een indirecte link die verwijst naar een pagina die doorverwijst naarurl_toof naar een canonieke pagina verwijst - isType: boolean | null
_lost geeft aan of de backlink is verwijderd
alstrue, zijn de backlink of de hele pagina verwijderd - isType: boolean | null
_new geeft aan of de backlink nieuw is
alstrue, is de backlink gevonden op de pagina tijdens het laatste bezoek van onze crawler - itemType: string | null
_type linktype
mogelijke waarden:anchor,image,meta,canonical,alternate,redirect - lastType: string | null
_seen meest recente datum waarop onze crawler de backlink heeft bezocht
in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:2019-11-15 12:57:46 +00:00 - linksType: integer | null Formaat: int64
_count aantal identieke backlinks op de verwijzende pagina
- originalType: boolean | null
geeft aan of de backlink aanwezig was op de verwijzende pagina bij het eerste bezoek van onze crawler
- pageType: string | null
_from _encoding tekencodering van de verwijzende pagina
voorbeeld:utf-8 - pageType: integer | null
_from _external _links aantal externe links op de verwijzende pagina
- pageType: integer | null
_from _internal _links aantal interne links op de verwijzende pagina
- pageType: string | null
_from _language taal van de verwijzende pagina
in ISO 639-1-formaat
voorbeeld:en - pageType: integer | null
_from _rank - pageType: integer | null
_from _size grootte van de verwijzende pagina, in bytes
voorbeeld:63357 - pageType: integer | null
_from _status _code HTTP-statuscode geretourneerd door de verwijzende pagina
voorbeeld:200 - pageType: string | null
_from _title titel van de verwijzende pagina
- prevType: string | null
_seen vóór de meest recente datum waarop onze crawler de backlink heeft bezocht
in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:2019-11-15 12:57:46 +00:00 - rankType: integer | null
- rankedType: object | null · Response36Afe1097B20_RankedKeywordsInfo
_keywords _info - pageType: integer | null Formaat: int64
_from _keywords _count _top _10 Signed 64-bit integers (long type).
- pageType: integer | null Formaat: int64
_from _keywords _count _top _100 Signed 64-bit integers (long type).
- pageType: integer | null Formaat: int64
_from _keywords _count _top _3 Signed 64-bit integers (long type).
- semanticType: string | null
_location - textType: string | null
_post snippet na de ankertekst
- textType: string | null
_pre snippet vóór de ankertekst
- tldType: string | null
_from topleveldomein van de verwijzende URL
- typeType: string | null
elementtype
- urlType: string | null
_from URL van de pagina waarop de backlink is gevonden
- urlType: boolean | null
_from _https geeft aan of de verwijzende URL met HTTPS is beveiligd
alstrue, is de verwijzende URL met HTTPS beveiligd - urlType: string | null
_to URL waarnaar de backlink verwijst
- urlType: boolean | null
_to _https geeft aan of de URL waarnaar de backlink verwijst met HTTPS is beveiligd
alstrue, is de URL met HTTPS beveiligd - urlType: string | null
_to _redirect _target doel-URL van de redirect
doelpagina waarnaar de redirect verwijst - urlType: integer | null
_to _spam _score - urlType: integer | null
_to _status _code statuscode van de pagina waarnaar wordt verwezen
als de waardenullis, heeft onze crawler de webpagina waarnaar de link verwijst nog niet bezocht
voorbeeld:200
- itemsType: integer | null Formaat: int64
_count het aantal resultaten dat in de array
itemswordt geretourneerd - modeType: string | null
modus opgegeven in een POST-array
- searchType: string | null
_after _token token voor volgende verzoeken
als u bij het instellen van een nieuwe taak de uniekesearch_after_tokenopgeeft, krijgt u de volgende resultaten van de oorspronkelijke taak;search_after_token-waarden zijn uniek voor elke volgende taak - targetType: string | null
doeldomein in een POST-array
- totalType: integer | null Formaat: int64
_count totaal aantal resultaten dat relevant is voor het verzoek
- resultType: integer | null Formaat: int64
_count Aantal elementen in de result-array
- statusType: integer | null
_code statuscode van de taak gegenereerd door DataForSEO, kan binnen het volgende bereik liggen: 10000-60000 de volledige lijst met responscodes vindt u hier
- statusType: string | null
_message informatief bericht van de taak de volledige lijst met algemene informatieve berichten vindt u hier
- timeType: string | null
Uitvoeringstijd in seconden
- Type: integer | null Formaat: int64tasks
_count Het aantal taken in de tasks-array
- Type: integer | null Formaat: int64tasks
_error Het aantal taken in de tasks-array dat met een fout is geretourneerd
- Type: string | nulltime
totale uitvoeringstijd, seconden
- Type: string | nullversion
De huidige versie van de API
application/json - 400
Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.
- 401
Een geldige Felo-API-sleutel is vereist.
- 402
Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.
- 403
Het account mag deze bewerking niet uitvoeren.
- 429
Een verzoek- of bestedingslimiet is bereikt.
- 502
De dienst kon het verzoek niet voltooien.
- 503
De API of factureringsdienst is tijdelijk niet beschikbaar.
- 504
Er is een time-out opgetreden bij het verwerken van het verzoek.
- default
Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/backlinks/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "forbes.com",
"mode": "as_is",
"filters": [
"dofollow",
"=",
true
],
"limit": 5
}
]'
{
"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": [
{
"target": null,
"mode": null,
"custom_mode": null,
"total_count": null,
"items_count": null,
"items": [
{
"type": null,
"domain_from": null,
"url_from": null,
"url_from_https": null,
"domain_to": null,
"url_to": null,
"url_to_https": null,
"tld_from": null,
"is_new": null,
"is_lost": null,
"backlink_spam_score": null,
"rank": null,
"page_from_rank": null,
"domain_from_rank": null,
"domain_from_platform_type": [
"[Max Depth Exceeded]"
],
"domain_from_is_ip": null,
"domain_from_ip": null,
"domain_from_country": null,
"page_from_external_links": null,
"page_from_internal_links": null,
"page_from_size": null,
"page_from_encoding": null,
"page_from_language": null,
"page_from_title": null,
"page_from_status_code": null,
"first_seen": null,
"prev_seen": null,
"last_seen": null,
"item_type": null,
"attributes": [
"[Max Depth Exceeded]"
],
"dofollow": null,
"original": null,
"alt": null,
"image_url": null,
"anchor": null,
"text_pre": null,
"text_post": null,
"semantic_location": null,
"links_count": null,
"group_count": null,
"is_broken": null,
"url_to_status_code": null,
"url_to_spam_score": null,
"url_to_redirect_target": null,
"ranked_keywords_info": "[Max Depth Exceeded]",
"is_indirect_link": null,
"indirect_link_path": [
"[Max Depth Exceeded]"
]
}
],
"search_after_token": null
}
]
}
]
}