v0.2.0-beta

OpenAPI 3.1.0

Domein-whois-overzicht

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/domain_analytics/whois/overview/live

Domein-whois-overzicht

Whois-records verrijkt met SEO-metrieken. Elk item bevat domain, created_datetime, changed_datetime, expiration_datetime, updated_datetime, first_seen, epp_status_codes, tld, registered, registrar, plus metrics en backlinks_info. Gepagineerd met limit, offset en offset_token, gefilterd op de velden in get_dataforseo_domains_whois_available_filters.

Prijsreferentie

Metering: Gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.012.
Referentieklantvermenigvuldiger: 1.0. Pas deze niet opnieuw toe op een afgerekend klantbedrag.

Alleen referentiemetadata, geen accountofferte, geen gegarandeerde prijs en geen bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Body

application/json

Type: array (object | null)[]
- filters
  Type: array (object | null)[] | null
  
  array met parameters voor het filteren van resultaten
  optioneel veld
  je kunt meerdere filters tegelijk toevoegen (maximaal 8 filters)
  tussen de voorwaarden moet je een logische operator and, or plaatsen
  de volgende operators worden ondersteund:
  regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
  met de operator % kun je bij like en not_like elke tekenreeks van nul of meer tekens matchen
  
  Leeg object
- limit
  Type: integer | null
  
  maximaal aantal geretourneerde domeinen
  optioneel veld
  standaardwaarde: 100
  maximumwaarde: 1000
- offset
  Type: integer | null
  
  offset in de resultatenarray van geretourneerde items
  optioneel veld
  standaardwaarde: 0
  als je de waarde 10 opgeeft, worden de eerste tien items in de resultatenarray weggelaten en worden de gegevens voor de daaropvolgende items geleverd;
  Let op: we raden aan deze parameter alleen te gebruiken bij het ophalen van maximaal 10.000 resultaten; gebruik voor meer dan 10.000 resultaten in plaats daarvan offset_token
- offset_token
  Type: string | null
  
  token voor vervolgverzoeken
  optioneel veld
  wordt geleverd in het identieke veld van de respons op elk verzoek;
  gebruik deze parameter om time-outs te voorkomen bij het ophalen van meer dan 100.000 resultaten in één verzoek;
  door de unieke waarde van offset_token uit de responsarray op te geven, krijg je de vervolgresultaten van de oorspronkelijke taak;
  offset_token-waarden zijn uniek voor elke vervolgtaak
  Let op: als offset_token in het verzoek is opgegeven, moeten alle andere parameters identiek zijn aan die van het vorige verzoek
  meer informatie over deze parameter vind je in ons Help Center
- order_by
  Type: array string[] | null
  
  sorteerregels voor resultaten
  optioneel veld
  je kunt dezelfde waarden als in de array filters gebruiken om de resultaten te sorteren
  mogelijke sorteertypen:
  asc - resultaten worden in oplopende volgorde gesorteerd
  desc - resultaten worden in aflopende volgorde gesorteerd
  de komma wordt als scheidingsteken gebruikt
  voorbeeld:
  ["metrics.organic.pos_1,desc"]
  standaardregel:
  ["metrics.organic.count,desc"]
  let op: je kunt per verzoek maximaal drie sorteerregels instellen
  meerdere sorteerregels moeten door een komma worden gescheiden
  voorbeeld:
  ["expiration_datetime,asc","metrics.organic.etv,desc","metrics.organic.pos_1,desc"]
- 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

Responsen

200
Type: object | null · Response36Afe1097B20_DomainAnalyticsWhoisOverviewLiveResponseInfo
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_DomainAnalyticsWhoisOverviewLiveTaskInfo
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

bevat ranking- en verkeersgegevens

items-array

backlinks_info
Type: object | null · Response36Afe1097B20_BacklinksInfo

backlinkgegevens voor het geretourneerde domein

backlinks
Type: integer | null Formaat: int64

gemiddeld aantal backlinks

dofollow
Type: integer | null Formaat: int64

gemiddeld aantal dofollowlinks

referring_domains
Type: integer | null Formaat: int64

gemiddeld aantal verwijzende domeinen

referring_main_domains
Type: integer | null Formaat: int64

gemiddeld aantal verwijzende hoofddomeinen

referring_pages
Type: integer | null Formaat: int64

gemiddeld aantal verwijzende pagina's

time_update
Type: string | null

datum en tijd waarop de backlinkgegevens zijn bijgewerkt
in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”;
voorbeeld:
2019-11-15 12:57:46 +00:00

changed_datetime
Type: string | null

datum en tijd waarop het domeinitem is gewijzigd
datum en tijd (in het ISO 8601-formaat) waarop het domeinitem voor het laatst is gewijzigd
voorbeeld:
"2021-01-14 08:36:28 +00:00"

created_datetime
Type: string | null

datum en tijd van registratie
datum en tijd (in het ISO 8601-formaat) waarop het domein voor het eerst is geregistreerd
voorbeeld:
"1997-03-29 03:00:00 +00:00"

domain
Type: string | null

domeinnaam

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

statuscodes van het Extensive Provisioning Protocol
de status van een domeinnaamregistratie zoals gedefinieerd door ICANN

expiration_datetime
Type: string | null

datum en tijd waarop het domein verloopt
datum en tijd (in het ISO 8601-formaat) waarop het domein verloopt
voorbeeld:
"2022-11-26 17:21:23 +00:00"

first_seen
Type: string | null

datum en tijd waarop onze crawler het domein 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"

metrics
Type: object | null · Response36Afe1097B20_MetricsBundleInfo

rankinggegevens voor het opgegeven domein

organic
Type: object | null · Response36Afe1097B20_MetricsInfo

ranking- en trafficgegevens uit organisch zoeken

count
Type: integer | null Formaat: int64

totaal aantal organische SERP's dat het domein bevat

estimated_paid_traffic_cost
Type: number | null

geschatte kosten van het omzetten van organisch zoekverkeer in betaald
vertegenwoordigt de geschatte maandelijkse kosten (USD) van advertenties voor alle keywords waarop een domein rankt
de metriek wordt berekend als het product van de organische etv- en de betaalde cpc-waarde en geeft de kosten aan om het geschatte maandelijkse organische trafficvolume via PPC-advertenties in Google Zoeken te realiseren
meer over de berekening van de metriek lees je in dit Help Center-artikel

etv
Type: number | null

geschat verkeersvolume
geschat organisch maandelijks verkeer naar het domein
berekend als het product van CTR (click-through-rate) en zoekvolume van alle keywords waarop het domein rankt
lees meer over hoe deze metriek wordt berekend in dit Help Center-artikel

is_down
Type: integer | null Formaat: int64

rang gedaald geeft aan hoeveel gerangschikte elementen van dit domein in Google Zoeken zijn gedaald

is_lost
Type: integer | null Formaat: int64

verloren gerangschikte elementen geeft aan hoeveel gerangschikte elementen van dit domein eerder in SERP's verschenen, maar bij de laatste controle niet zijn gevonden

is_new
Type: integer | null Formaat: int64

aantal nieuwe gerangschikte elementen geeft aan hoeveel nieuwe gerangschikte elementen voor dit domein zijn gevonden

is_up
Type: integer | null Formaat: int64

rang gestegen geeft aan hoeveel gerangschikte elementen van dit domein in Google Zoeken zijn gestegen

pos_1
Type: integer | null

aantal organische SERP's waarin het domein op #1 rankt

pos_11_20
Type: integer | null

aantal organische SERP's waarin het domein op #11-20 rankt

pos_2_3
Type: integer | null

aantal organische SERP's waarin het domein op #2-3 rankt

pos_21_30
Type: integer | null

aantal organische SERP's waarin het domein op #21-30 rankt

pos_31_40
Type: integer | null

aantal organische SERP's waarin het domein op #31-40 rankt

pos_4_10
Type: integer | null

aantal organische SERP's waarin het domein op #4-10 rankt

pos_41_50
Type: integer | null

aantal organische SERP's waarin het domein op #41-50 rankt

pos_51_60
Type: integer | null

aantal organische SERP's waarin het domein op #51-60 rankt

pos_61_70
Type: integer | null

aantal organische SERP's waarin het domein op #61-70 rankt

pos_71_80
Type: integer | null

aantal organische SERP's waarin het domein op #71-80 rankt

pos_81_90
Type: integer | null

aantal organische SERP's waarin het domein op #81-90 rankt

pos_91_100
Type: integer | null

aantal organische SERP's waarin het domein op #91-100 rankt

paid
Type: object | null · Response36Afe1097B20_MetricsInfo

ranking- en trafficgegevens uit betaald zoeken

count
Type: integer | null Formaat: int64

totaal aantal organische SERP's dat het domein bevat

estimated_paid_traffic_cost
Type: number | null

geschatte kosten van het omzetten van organisch zoekverkeer in betaald
vertegenwoordigt de geschatte maandelijkse kosten (USD) van advertenties voor alle keywords waarop een domein rankt
de metriek wordt berekend als het product van de organische etv- en de betaalde cpc-waarde en geeft de kosten aan om het geschatte maandelijkse organische trafficvolume via PPC-advertenties in Google Zoeken te realiseren
meer over de berekening van de metriek lees je in dit Help Center-artikel

etv
Type: number | null

geschat verkeersvolume
geschat organisch maandelijks verkeer naar het domein
berekend als het product van CTR (click-through-rate) en zoekvolume van alle keywords waarop het domein rankt
lees meer over hoe deze metriek wordt berekend in dit Help Center-artikel

is_down
Type: integer | null Formaat: int64

rang gedaald geeft aan hoeveel gerangschikte elementen van dit domein in Google Zoeken zijn gedaald

is_lost
Type: integer | null Formaat: int64

verloren gerangschikte elementen geeft aan hoeveel gerangschikte elementen van dit domein eerder in SERP's verschenen, maar bij de laatste controle niet zijn gevonden

is_new
Type: integer | null Formaat: int64

aantal nieuwe gerangschikte elementen geeft aan hoeveel nieuwe gerangschikte elementen voor dit domein zijn gevonden

is_up
Type: integer | null Formaat: int64

rang gestegen geeft aan hoeveel gerangschikte elementen van dit domein in Google Zoeken zijn gestegen

pos_1
Type: integer | null

aantal organische SERP's waarin het domein op #1 rankt

pos_11_20
Type: integer | null

aantal organische SERP's waarin het domein op #11-20 rankt

pos_2_3
Type: integer | null

aantal organische SERP's waarin het domein op #2-3 rankt

pos_21_30
Type: integer | null

aantal organische SERP's waarin het domein op #21-30 rankt

pos_31_40
Type: integer | null

aantal organische SERP's waarin het domein op #31-40 rankt

pos_4_10
Type: integer | null

aantal organische SERP's waarin het domein op #4-10 rankt

pos_41_50
Type: integer | null

aantal organische SERP's waarin het domein op #41-50 rankt

pos_51_60
Type: integer | null

aantal organische SERP's waarin het domein op #51-60 rankt

pos_61_70
Type: integer | null

aantal organische SERP's waarin het domein op #61-70 rankt

pos_71_80
Type: integer | null

aantal organische SERP's waarin het domein op #71-80 rankt

pos_81_90
Type: integer | null

aantal organische SERP's waarin het domein op #81-90 rankt

pos_91_100
Type: integer | null

aantal organische SERP's waarin het domein op #91-100 rankt

registered
Type: boolean | null

registratiestatus van het domein
als false, is de domeinnaamregistratie verlopen
Opmerking: verlopen domeinen blijven slechts korte tijd in de database

registrar
Type: string | null

domeinregistrar
als null, is de domeinregistrar onbekend
voorbeeld:
NameCheap, Inc.

tld
Type: string | null

topleveldomein
topleveldomein in de DNS-rootzone

updated_datetime
Type: string | null

datum en tijd waarop het domein is bijgewerkt
datum en tijd (in het ISO 8601-formaat) waarop het domein voor het laatst is bijgewerkt
voorbeeld:
"2021-01-29 13:59:38 +00:00"

items_count
Type: integer | null Formaat: int64

het aantal resultaten dat in de array items wordt geretourneerd

offset
Type: integer | null

offsetwaarde van de resultaten die in het POST-verzoek is opgegeven

offset_token
Type: string | null
total_count
Type: integer | null Formaat: int64

totaal aantal resultaten in onze database dat relevant is voor uw verzoek

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/domain_analytics/whois/overview/live

curl https://openapi.felo.ai/v1/beta/dataforseo/domain_analytics/whois/overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "limit": 2,
    "filters": [
      [
        "epp_status_codes",
        "in",
        [
          "client_transfer_prohibited",
          "client_update_prohibited"
        ]
      ]
    ]
  }
]'

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": [
        {
          "total_count": null,
          "items_count": null,
          "offset": null,
          "offset_token": null,
          "items": [
            {
              "domain": null,
              "created_datetime": null,
              "changed_datetime": null,
              "expiration_datetime": null,
              "updated_datetime": null,
              "first_seen": null,
              "epp_status_codes": [
                "[Max Depth Exceeded]"
              ],
              "tld": null,
              "registered": null,
              "registrar": null,
              "metrics": "[Max Depth Exceeded]",
              "backlinks_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Geslaagde bewerking

Domein-whois-overzicht

AuthenticatieRequired

DataForSEO

Domein-whois-overzicht

Prijsreferentie