v0.2.0-beta

OpenAPI 3.1.0

Relevante pagina'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/dataforseo_labs/google/relevant_pages/live

Relevante pagina's

Welke pagina's van een target-site de rankings opleveren, gerangschikt naar het verkeer dat ze brengen. Paginering met limit, offset en offset_token; gebruik de token voorbij de eerste pagina's. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code; een geweigerd verzoek retourneert nog steeds HTTP 200. Gebruik het om de pagina's te vinden die het verdedigen of uitbouwen waard zijn. Voor de keywords erachter gebruik je post_dataforseo_labs_google_kw_for_site_live; voor de pagina's die links in plaats van rankings opleveren, post_dataforseo_backlinks_domain_pages_summary_live.

Prijsreferentie

Metering: Gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.015.
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
  u kunt meerdere filters tegelijk toevoegen (maximaal 8 filters)
  tussen de voorwaarden moet u een logische operator and, or plaatsen
  de volgende operators worden ondersteund:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in
  
  voorbeeld:
  ["metrics.paid.count",">",0]
  
  [["metrics.organic.count",">",50],"and",["metrics.organic.pos_1","<>",0]]
  
  [[""metrics.organic.count",">",50"], "and", [["metrics.organic.pos_1","<>",0],"or",["metrics.organic.pos_2_3","<>",0]]]
  meer informatie over filters vindt u in Dataforseo Labs - Filters of in deze Help Center-gids
  
  Leeg object
- historical_serp_mode
  Type: string | null
  
  modus voor gegevensverzameling
  optioneel veld
  met dit veld kunt u de resultaten filteren;
  mogelijke filtertypen:
  live — metrieken retourneren voor SERP's waarin de opgegeven target momenteel rankingresultaten heeft;
  lost — metrieken retourneren voor SERP's waarin de opgegeven target eerder rankingresultaten had, maar deze bij de laatste controle niet meer had;
  all — metrieken voor beide typen SERP's retourneren.
  standaardwaarde: live
- ignore_synonyms
  Type: boolean | null
  
  sterk vergelijkbare keywords negeren
  optioneel veld
  bij true worden alleen kernkeywords geretourneerd, alle sterk vergelijkbare keywords worden uitgesloten;
  standaardwaarde: false
- include_clickstream_data
  Type: boolean | null
  
  gegevens uit clickstream-gebaseerde metrieken in het resultaat opnemen of uitsluiten
  optioneel veld
  als de parameter op true is ingesteld, ontvangt u de velden clickstream_etv, clickstream_gender_distribution en clickstream_age_distribution met clickstream-gegevens in de respons
  standaardwaarde: false
  als deze parameter is ingeschakeld, wordt het dubbele tarief voor het verzoek in rekening gebracht
  
  meer informatie over de berekening van clickstream-gebaseerde metrieken vindt u in dit Help Center-artikel
- item_types
  Type: array string[] | null
  
  resultaten per itemtype weergeven
  optioneel veld
  geeft het type zoekresultaten aan dat in de respons is opgenomen
  
  Let op: als de array item_types itemtypen bevat die afwijken van organic, worden de resultaten geordend op het eerste itemtype in de array; resultaten waarvan het type zoekresultaat niet in de respons is opgenomen, kunt u niet sorteren of filteren;
  
  mogelijke waarden:
  ["organic", "paid", "featured_snippet", "local_pack"]
  standaardwaarde:
  ["organic", "paid"]
- language_code
  Type: string | null
  
  taalcode
  optioneel veld
  als u dit veld gebruikt, hoeft u language_name niet op te geven
  de lijst met beschikbare talen met language_code ontvangt u via een afzonderlijk verzoek aan
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  laat dit veld weg om resultaten voor alle beschikbare talen te krijgen
  voorbeeld:
  en
- language_name
  Type: string | null
  
  volledige naam van de taal
  optioneel veld
  als u dit veld gebruikt, hoeft u language_code niet op te geven
  de lijst met beschikbare talen met language_name ontvangt u via een afzonderlijk verzoek aan
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  laat dit veld weg om resultaten voor alle beschikbare talen te krijgen
  voorbeeld:
  English
- limit
  Type: integer | null
  
  maximaal aantal geretourneerde pagina's
  optioneel veld
  standaardwaarde: 100
  maximumwaarde: 1000
- location_code
  Type: integer | null
  
  locatiecode
  optioneel veld
  als u dit veld gebruikt, hoeft u location_name niet op te geven
  de lijst met beschikbare locaties met location_code ontvangt u via een afzonderlijk verzoek aan
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  laat dit veld weg om resultaten voor alle beschikbare locaties te krijgen
  voorbeeld:
  2840
- location_name
  Type: string | null
  
  volledige naam van de locatie
  optioneel veld
  als u dit veld gebruikt, hoeft u location_code niet op te geven
  de lijst met beschikbare locaties met location_name ontvangt u via een afzonderlijk verzoek aan
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  laat dit veld weg om resultaten voor alle beschikbare locaties te krijgen
  voorbeeld:
  United Kingdom
- 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 in oplopende volgorde gesorteerd
  desc – resultaten worden in aflopende volgorde gesorteerd
  u stelt een sorteertype in met een komma
  voorbeeld:
  ["metrics.paid.etv,asc"]
  Let op: u kunt per verzoek maximaal drie sorteerregels instellen
  meerdere sorteerregels scheidt u met een komma
  voorbeeld:
  ["metrics.organic.etv,desc","metrics.paid.count,asc"]
  
  standaardregel:
  ["metrics.organic.count,desc"]
  Let op: als de array item_types itemtypen bevat die afwijken van organic, worden de resultaten geordend op het eerste itemtype in de array
- 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
  verplicht veld
  de domeinnaam van de doelwebsite
  het domein geeft u op zonder https:// en www.

Responsen

200
Type: object | null · Response36Afe1097B20_DataforseoLabsGoogleRelevantPagesLiveResponseInfo
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_DataforseoLabsGoogleRelevantPagesLiveTaskInfo
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

relevante pagina's en gerelateerde gegevens

metrics
Type: object | null

ranking- en verkeersmetrieken voor de relevante pagina

propertyName
Type: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
clickstream_age_distribution
Type: object | null

verdeling van op clickstream gebaseerde metrieken naar leeftijd
om resultaten voor dit veld op te halen, moet de parameter include_clickstream_data op true staan
lees meer over hoe de metriek wordt berekend in dit Help Center-artikel

propertyName
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

clickstream_etv
Type: number | null Formaat: double

geschat verkeersvolume op basis van clickstreamgegevens
berekend als het product van de click-through-rate en de clickstream-zoekvolumewaarden van alle keywords waarop het domein rankt
om resultaten voor dit veld op te halen, moet de parameter include_clickstream_data op true staan
lees meer over hoe de metriek wordt berekend in dit Help Center-artikel

clickstream_gender_distribution
Type: object | null

verdeling van geschatte op clickstream gebaseerde metrieken naar geslacht
om resultaten voor dit veld op te halen, moet de parameter include_clickstream_data op true staan
lees meer over hoe de metriek wordt berekend in dit Help Center-artikel

propertyName
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

count
Type: integer | null Formaat: int64

totaal aantal organische SERP's dat het domein of subdomein bevat

estimated_paid_traffic_cost
Type: number | null

geschatte kosten om organisch zoekverkeer om te zetten in betaald verkeer
geeft de geschatte maandelijkse kosten (USD) weer voor advertenties voor alle keywords in de categorie waarop het domein of subdomein rankt
de metriek wordt berekend als het product van de organische etv- en betaalde cpc-waarden en geeft de kosten aan om het geschatte maandelijkse organische verkeersvolume via PPC-advertenties in Google Zoeken te realiseren
lees meer over hoe de metriek wordt berekend in dit Help Center-artikel

etv
Type: number | null

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

is_down
Type: integer | null

rang gedaald
geeft aan hoeveel gerangschikte elementen van het opgegeven doel zijn gedaald

is_lost
Type: integer | null

verloren gerangschikte elementen
geeft aan hoeveel gerangschikte elementen van het opgegeven doel eerder in SERP's stonden, maar bij de laatste controle niet zijn gevonden

is_new
Type: integer | null

aantal nieuwe gerangschikte elementen
geeft aan hoeveel nieuwe gerangschikte elementen voor het opgegeven doel zijn gevonden

is_up
Type: integer | null

rang gestegen
geeft aan hoeveel gerangschikte elementen van het opgegeven doel zijn gestegen

pos_1
Type: integer | null

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

pos_11_20
Type: integer | null

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

pos_2_3
Type: integer | null

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

pos_21_30
Type: integer | null

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

pos_31_40
Type: integer | null

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

pos_4_10
Type: integer | null

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

pos_41_50
Type: integer | null

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

pos_51_60
Type: integer | null

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

pos_61_70
Type: integer | null

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

pos_71_80
Type: integer | null

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

pos_81_90
Type: integer | null

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

pos_91_100
Type: integer | null

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

page_address
Type: string | null

absolute URL van de relevante pagina

se_type
Type: string | null

type zoekmachine

items_count
Type: integer | null Formaat: int64

het aantal resultaten dat in de array items wordt geretourneerd

language_code
Type: string | null

taalcode in een POST-array
als er geen gegevens zijn, is de waarde null

location_code
Type: integer | null

locatiecode in een POST-array
als er geen gegevens zijn, is de waarde null

se_type
Type: string | null

type zoekmachine

target
Type: string | null

doeldomein in een POST-array

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/dataforseo_labs/google/relevant_pages/live

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/relevant_pages/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "amazon.com",
    "language_name": "English",
    "location_code": 2840,
    "filters": [
      [
        "metrics.organic.pos_1",
        "<>",
        0
      ],
      "or",
      [
        "metrics.organic.pos_2_3",
        "<>",
        0
      ]
    ],
    "limit": 3
  }
]'

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": [
        {
          "se_type": null,
          "target": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "page_address": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}

Geslaagde bewerking

Relevante pagina's

AuthenticatieRequired

DataForSEO

Relevante pagina's

Prijsreferentie