v0.2.0-beta

OpenAPI 3.1.0

Domeinpagina's

Felo API Support

MIT

Server

https://openapi.felo.ai

Clientbibliotheken

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operaties

post/v1/beta/dataforseo/backlinks/domain_pages/live

Domeinpagina's

De pagina's van één target met inkomende links, inclusief de blik van de crawler op elk daarvan: main_domain, domain, tld, page, ip, first_visited, prev_visited en fetch_time. Gebruik dit om te zien welke pagina's daadwerkelijk links verdienen. Voor backlinkaantallen per pagina in plaats van crawlmetadata gebruik je post_dataforseo_backlinks_domain_pages_summary_live.

Prijsreferentie

Afrekening: gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.0276.
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.

Body

application/json

Type: array (object | null)[]
- backlinks_filters
  Type: array (object | null)[] | null
  
  filter de backlinks van uw target
  optioneel veld
  met dit veld filtert u de initiële backlinks die in de dataset voor geaggregeerde statistieken van uw target worden opgenomen
  u kunt de backlinks filteren op alle velden die beschikbaar zijn in de respons van dit endpoint
  met deze parameter kunt u alleen dofollow-backlinks in de respons opnemen en een flexibele backlink-dataset samenstellen om de statistieken voor te berekenen
  voorbeeld:
  "backlinks_filters": ["dofollow", "=", true]
  
  Leeg object
- backlinks_status_type
  Type: string | null
  
  bepaalt welke backlinks worden teruggegeven en geteld
  optioneel veld
  met dit veld kiest u welke backlinks worden teruggegeven en gebruikt voor geaggregeerde statistieken;
  mogelijke waarden:
  all - alle backlinks worden teruggegeven en geteld;
  live - backlinks die bij de laatste controle zijn gevonden, worden teruggegeven en geteld;
  lost - verloren backlinks worden teruggegeven en geteld;
  
  standaardwaarde: live
- exclude_internal_backlinks
  Type: boolean | null
  
  geeft aan of interne backlinks van subdomeinen naar het target uit de resultaten worden uitgesloten
  optioneel veld
  bij true bevatten de resultaten geen gegevens over interne backlinks van subdomeinen van hetzelfde domein als target
  bij false worden interne links in de resultaten opgenomen
  standaardwaarde: true
- filters
  Type: 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 operator and of or
  de volgende operators worden ondersteund:
  regex, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
  met de operator % in like en not_like kunt u elke tekenreeks van nul of meer tekens matchen
  voorbeeld:
  ["meta.internal_links_count",">","1"]
  
  [["meta.external_links_count",">","2"], "and", ["backlinks",">","10"]]
  
  [["first_visited",">","2017-10-23 11:31:45 +00:00"], "and", [["title","like","%seo%"],"or",["referring_domains",">","10"]]]
  
  de volledige lijst met mogelijke filters vindt u hier.
  
  Leeg object
- include_subdomains
  Type: boolean | null
  
  geeft aan of de subdomeinen van het target in de zoekopdracht worden opgenomen
  optioneel veld
  bij false worden subdomeinen genegeerd
  standaardwaarde: true
- internal_list_limit
  Type: integer | null
  
  maximaal aantal elementen in interne arrays
  optioneel veld
  met dit veld beperkt u het aantal elementen in de volgende arrays:
  referring_links_tld
  referring_links_types
  referring_links_attributes
  referring_links_platform_types
  referring_links_semantic_locations
  
  standaardwaarde: 10
  maximale waarde: 1000
- limit
  Type: integer | null
  
  maximaal aantal geretourneerde pagina's
  optioneel veld
  standaardwaarde: 100
  maximumwaarde: 1000
- offset
  Type: integer | null
  
  offset in de resultatenarray van geretourneerde pagina's
  optioneel veld
  standaardwaarde: 0
  als u de waarde 10 opgeeft, worden de eerste tien pagina's in de resultatenarray overgeslagen en worden de gegevens voor de volgende pagina's geleverd
- order_by
  Type: array string[] | null
  
  sorteerregels voor resultaten
  optioneel veld
  u kunt dezelfde waarden als in de array filters gebruiken om de resultaten te sorteren
  mogelijke sorteertypen:
  asc - resultaten worden oplopend gesorteerd
  desc - resultaten worden aflopend gesorteerd
  sorteertype en -richting scheidt u met een komma
  voorbeeld:
  ["page_summary.backlinks,desc"]
  let op: u kunt per verzoek maximaal drie sorteerregels instellen
  meerdere sorteerregels scheidt u met een komma
  voorbeeld:
  ["page_summary.backlinks,desc","page_summary.rank,asc"]
- rank_scale
  Type: string | null
  
  bepaalt de schaal die wordt gebruikt voor het berekenen en weergeven van de waarden rank, domain_from_rank en page_from_rank
  optioneel veld
  
  met 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–100
  one_thousand — rangwaarden worden weergegeven op een schaal van 0–1000
  
  standaardwaarde: one_thousand
  
  lees meer over hoe deze parameter werkt en hoe rangmeters worden berekend in dit Help Center-artikel
- tag
  Type: 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 waarde tag vind je in het data-object van de respons
- target
  Type: string
  
  domein of subdomein
  verplicht veld
  een domein of subdomein geeft u op zonder https:// en www.
  voorbeeld:
  forbes.com

Responsen

200
Type: object | null · Response36Afe1097B20_BacklinksDomainPagesLiveResponseInfo
cost
Type: number | null Formaat: double

Totale kosten van taken, USD

status_code
Type: integer | null

algemene statuscode de volledige lijst met responscodes vindt u hier

status_message
Type: string | null

algemeen informatief bericht de volledige lijst met algemene informatieve berichten vindt u hier

tasks
Type: array (object | null)[] | null

array van taken

Type: object | null · Response36Afe1097B20_BacklinksDomainPagesLiveTaskInfo
cost
Type: number | null Formaat: double

Totale kosten van taken, USD

data
Type: object | null

Bevat dezelfde parameters die je in het POST-verzoek hebt opgegeven

propertyName
Type: object | null
id
Type: string | null

taak-id eenduidige taak-id in ons systeem in UUID-indeling

path
Type: array (string | null)[] | null

URL-pad

result
Type: array (object | null)[] | null

array van resultaten

items
Type: array (object | null)[] | null

items-array

content_encoding
Type: string | null

type codering

domain
Type: string | null

domein
domein waar de pagina is gevonden

encoded_size
Type: integer | null

paginagrootte na codering
geeft de grootte van de gecodeerde pagina aan, in bytes

fetch_time
Type: string | null

meest recente datum en tijd waarop onze crawler de pagina heeft bezocht
in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2017-01-24 13:20:59 +00:00

first_visited
Type: string | null

datum en tijd van het eerste paginabezoek
datum en tijd waarop onze crawler deze pagina voor het eerst heeft bezocht
in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2017-01-24 13:20:59 +00:00

ip
Type: string | null

Internet Protocol-adres

location
Type: string | null

location-header
geeft de URL aan waarnaar een pagina wordt omgeleid, indien aanwezig

main_domain
Type: string | null

hoofddomein van de website
het hoofddomein van de website bevat geen subdomeinen

media_type
Type: string | null

mediatypen die worden gebruikt om een pagina weer te geven

meta
Type: object | null · Response36Afe1097B20_BacklinksPageMeta

paginametagegevens

canonical
Type: string | null

canonieke pagina

charset
Type: string | null

tekencodering
voorbeelden:
utf-8

external_links_count
Type: integer | null Formaat: int64

aantal externe links op de pagina

h1
Type: array (string | null)[] | null

h1-tag
inhoud van h1-tags

h2
Type: array (string | null)[] | null

h2-tag
inhoud van h2-tags

h3
Type: array (string | null)[] | null

h3-tag
inhoud van h3-tags

images_alt
Type: array (string | null)[] | null

inhoud van alt-tags

images_count
Type: integer | null Formaat: int64

aantal afbeeldingen op de pagina

internal_links_count
Type: integer | null Formaat: int64

aantal interne links op de pagina

language
Type: string | null

taal van de pagina-inhoud
voorbeeld:
en

page_spam_score
Type: integer | null

spamscore van de pagina
lees meer over hoe deze metriek wordt berekend op deze Help Center-pagina

platform_type
Type: array (string | null)[] | null

type platform

powered_by
Type: array (string | null)[] | null

CMS-details

social_media_tags
Type: object | null
propertyName
Type: string | null
technologies
Type: object | null

technologieën van de website

propertyName
Type: string | null
title
Type: string | null

paginatitel

words_count
Type: integer | null Formaat: int64

aantal woorden op de pagina

page
Type: string | null

pagina-URL
relevante pagina-URL

page_summary
Type: object | null · Response36Afe1097B20_PageSummary

bevat backlinkgegevens voor deze pagina

backlinks
Type: integer | null Formaat: int64

geeft het aantal backlinks aan

backlinks_spam_score
Type: integer | null Formaat: int64

gemiddelde spamscore van de backlinks die naar de pagina verwijzen
lees meer over hoe deze metriek wordt berekend op deze Help Center-pagina

broken_backlinks
Type: integer | null Formaat: int64

aantal kapotte backlinks
aantal kapotte backlinks die naar de page verwijzen

broken_pages
Type: integer | null

aantal kapotte pagina's
aantal pagina's waarnaar backlinks verwijzen en die met statuscode 4xx of 5xx antwoorden

first_seen
Type: string | null

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

lost_date
Type: string | null

datum en tijd waarop de laatste backlink voor deze pagina verloren ging
geeft de datum en tijd aan waarop onze crawler de pagina heeft bezocht en deze reageerde met een 4xx- of 5xx-statuscode, of waarop de laatste backlink is verwijderd
in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2017-01-24 13:20:59 +00:00

rank
Type: integer | null

paginarrang
rang van de page
rank wordt berekend met de methode voor noderanking in een gekoppelde database – een principe uit het oorspronkelijke Google PageRank-algoritme
lees meer over deze metriek en hoe deze wordt berekend in dit Help Center-artikel

referring_domains
Type: integer | null Formaat: int64

geeft het aantal verwijzende domeinen aan

referring_domains_nofollow
Type: integer | null Formaat: int64

aantal domeinen dat minstens één nofollow-link naar de page laat wijzen

referring_ips
Type: integer | null Formaat: int64

aantal verwijzende IP-adressen
aantal IP-adressen dat naar deze pagina verwijst

referring_links_attributes
Type: object | null
propertyName
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

referring_links_countries
Type: object | null
propertyName
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

referring_links_platform_types
Type: object | null
propertyName
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

referring_links_semantic_locations
Type: object | null
propertyName
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

referring_links_tld
Type: object | null
propertyName
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

referring_links_types
Type: object | null
propertyName
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

referring_main_domains
Type: integer | null Formaat: int64

geeft het aantal verwijzende hoofddomeinen aan

referring_main_domains_nofollow
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

referring_pages
Type: integer | null Formaat: int64

geeft het aantal pagina's aan dat naar de page verwijst

referring_pages_nofollow
Type: integer | null Formaat: int64

aantal verwijzende pagina's dat minstens één nofollow-link naar de page laat wijzen

referring_subnets
Type: integer | null Formaat: int64

aantal verwijzende subnetten

prev_visited
Type: string | null

vóór de meest recente datum waarop onze crawler de pagina heeft bezocht
in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2017-01-24 13:20:59 +00:00

server
Type: string | null

serverversie

size
Type: integer | null

geeft de paginagrootte aan, in bytes

status_code
Type: integer | null

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

tld
Type: string | null

topleveldomein
topleveldomein in de DNS-rootzone

type
Type: string | null

elementtype

items_count
Type: integer | null Formaat: int64

aantal items in de array items

target
Type: string | null

target in een POST-array

total_count
Type: integer | null Formaat: int64

totaal aantal relevante items in de database

result_count
Type: integer | null Formaat: int64

Aantal elementen in de result-array

status_code
Type: integer | null

statuscode van de taak gegenereerd door DataForSEO, kan binnen het volgende bereik liggen: 10000-60000 de volledige lijst met responscodes vindt u hier

status_message
Type: string | null

informatief bericht van de taak de volledige lijst met algemene informatieve berichten vindt u hier

time
Type: string | null

Uitvoeringstijd in seconden

tasks_count
Type: integer | null Formaat: int64

Het aantal taken in de tasks-array

tasks_error
Type: integer | null Formaat: int64

Het aantal taken in de tasks-array dat met een fout is geretourneerd

time
Type: string | null

totale uitvoeringstijd, seconden

version
Type: string | null

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

post/v1/beta/dataforseo/backlinks/domain_pages/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_pages/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "limit": 5,
    "filters": [
      [
        "page_summary.backlinks",
        ">",
        5
      ],
      "and",
      [
        "page",
        "like",
        "%sites%"
      ]
    ]
  }
]'

Schema tonen

{
  "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,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "main_domain": null,
              "domain": null,
              "tld": null,
              "page": null,
              "ip": null,
              "first_visited": null,
              "prev_visited": null,
              "fetch_time": null,
              "status_code": null,
              "location": null,
              "size": null,
              "encoded_size": null,
              "content_encoding": null,
              "media_type": null,
              "server": null,
              "meta": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "social_media_tags": "[Max Depth Exceeded]"
              },
              "page_summary": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "referring_main_domains_nofollow": "[Max Depth Exceeded]",
                "referring_links_tld": "[Max Depth Exceeded]",
                "referring_links_types": "[Max Depth Exceeded]",
                "referring_links_attributes": "[Max Depth Exceeded]",
                "referring_links_platform_types": "[Max Depth Exceeded]",
                "referring_links_semantic_locations": "[Max Depth Exceeded]",
                "referring_links_countries": "[Max Depth Exceeded]"
              }
            }
          ]
        }
      ]
    }
  ]
}

Geslaagde bewerking

Domeinpagina's

AuthenticatieRequired

DataForSEO

Domeinpagina's

Prijsreferentie