v0.2.0-beta

OpenAPI 3.1.0

Live: gewone Google Organic SERP

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/serp/google/organic/live/regular

Live: gewone Google Organic SERP

Retourneert synchroon de gerangschikte resultaten voor een keyword op Google. Retourneert keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count en items. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code – een geweigerd verzoek retourneert nog steeds HTTP 200.

Prijsreferentie

Afrekening: gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.008.
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)[]
- depth
  Type: integer | null
  
  parseerdiepte
  
  optioneel veld
  
  aantal resultaten in de SERP
  
  standaardwaarde: 10
  
  maximumwaarde: 200
  
  uw account wordt gefactureerd per SERP met maximaal 10 resultaten;
  een diepte boven 10 kan extra kosten veroorzaken als de zoekmachine meer dan 10 resultaten retourneert;
  
  de kosten kunnen worden berekend op de pagina Pricing.
- device
  Type: string | null
  
  apparaattype
  
  optioneel veld
  
  resultaten retourneren voor een bepaald apparaattype
  
  kan de waarden hebben:desktop, mobile
  
  standaardwaarde: desktop
- find_targets_in
  Type: array string[] | null
  
  SERP-elementtypen die op doelen worden gecontroleerd
  
  optioneel veld
  
  om deze parameter in te schakelen, moet ook stop_crawl_on_match zijn ingeschakeld
  
  geeft aan welke SERP-elementtypen op doelovereenkomsten moeten worden gecontroleerd
  
  als niet opgegeven, worden alle elementen van het eerste niveau met de velden url en domain op doelen gecontroleerd
  
  mogelijke waarden: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter
  
  Let op: mag niet dezelfde elementtypen bevatten als ignore_targets_in
  
  voorbeeld:
  
  "find_targets_in": ["organic", "featured_snippet"]
  
  meer informatie over deze parameter vindt u in ons Help Center
- group_organic_results
  Type: boolean | null
  
  verwante resultaten weergeven
  
  optioneel veld
  
  bij instelling op true wordt het element related_result in de respons geleverd als een snippet van het bovenliggende organische resultaat;
  
  bij instelling op false wordt het element related_result geleverd als een afzonderlijk organisch resultaat;
  
  standaardwaarde: true
- ignore_targets_in
  Type: array string[] | null
  
  SERP-elementtypen die van de doelzoekopdracht worden uitgesloten
  
  optioneel veld
  
  om deze parameter in te schakelen, moet ook stop_crawl_on_match zijn ingeschakeld
  
  geeft aan welke SERP-elementtypen moeten worden uitgesloten bij het zoeken naar doelovereenkomsten
  
  mogelijke waarden: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter
  
  Let op: mag niet dezelfde elementtypen bevatten als find_targets_in
  
  voorbeeld:
  
  "ignore_targets_in": ["paid", "images"]
  
  meer informatie over deze parameter vindt u in ons Help Center
- keyword
  Type: string
  
  keyword
  
  verplicht veld
  
  u kunt in het veld keyword maximaal 700 tekens opgeven
  
  alle %## worden gedecodeerd (het teken '+' wordt gedecodeerd naar een spatie)
  
  als u het teken '%' voor uw keyword nodig hebt, geeft u het op als '%25';
  
  als u het teken '+' voor uw keyword nodig hebt, geeft u het op als '%2B';
  
  als dit veld parameters bevat zoals 'allinanchor:', 'allintext:', 'allintitle:', 'allinurl:', ‘cache:’, 'define:', 'filetype:', 'id:', 'inanchor:', 'info:', 'intext:', 'intitle:', 'inurl:', 'link:', 'site:', worden de kosten per taak met 5 vermenigvuldigd
- language_code
  Type: string
  
  taalcode van de zoekmachine
  
  verplicht veld als u niet opgeeft language_name
  
  als u dit veld gebruikt, hoeft u language_name niet op te geven
  
  de lijst met beschikbare talen van de zoekmachine met hun language_code ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/serp/google/languages
  
  voorbeeld:
  
  en
- language_name
  Type: string
  
  volledige naam van de taal van de zoekmachine
  
  verplicht veld als u niet opgeeft language_code
  
  als u dit veld gebruikt, hoeft u language_code niet op te geven
  
  de lijst met beschikbare talen van de zoekmachine met hun language_name ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/serp/google/languages
  
  voorbeeld:
  
  English
- location_code
  Type: integer
  
  locatiecode van de zoekmachine
  
  verplicht veld als u niet opgeeft location_name of location_coordinate
  
  als u dit veld gebruikt, hoeft u location_name of location_coordinate niet op te geven
  
  de lijst met beschikbare locaties van de zoekmachines met hun location_code ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/serp/google/locations
  
  voorbeeld:
  
  2840
- location_coordinate
  Type: string
  
  GPS-coördinaten van een locatie
  
  verplicht veld als niet opgegeven location_name of location_code
  
  bij gebruik van dit veld hoef je location_name of location_code niet op te geven
  
  de parameter location_coordinate moet in het formaat "latitude,longitude,radius" worden opgegeven
  
  het maximale aantal decimalen voor "latitude" en "longitude": 7
  
  de minimumwaarde voor "radius": 199 (mm)
  
  de maximumwaarde voor "radius": 199999 (mm)
  
  voorbeeld:
  
  53.476225,-2.243572,200
- location_name
  Type: string
  
  volledige naam van de locatie van de zoekmachine
  
  verplicht veld als u niet opgeeft location_code of location_coordinate
  
  als u dit veld gebruikt, hoeft u location_code of location_coordinate niet op te geven
  
  de lijst met beschikbare locaties van de zoekmachine met hun location_name ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/serp/google/locations
  
  voorbeeld:
  
  London,England,United Kingdom
- match_type
  Type: string
  
  type doelovereenkomst
  
  verplicht veld als stop_crawl_on_match is opgegeven
  
  type overeenkomst voor de match_value
  
  mogelijke waarden:
  
  domain – specifiek domein of subdomein
  
  with_subdomains – hoofddomein en subdomeinen
  
  wildcard – wildcardpatroon
- match_value
  Type: string
  
  doeldomein, subdomein of jokertekenwaarde
  
  verplicht veld als stop_crawl_on_match is opgegeven
  
  geef een doeldomein, subdomein of jokertekenwaarde op;
  
  Let op: domein of subdomein moet worden opgegeven zonder aanvraagprotocol;
  
  voorbeeld: "match_value": "dataforseo.com",
  
  "match_value": "/blog/post-*"
- max_crawl_pages
  Type: integer | null
  
  crawllimiet voor pagina's
  
  optioneel veld
  
  aantal te crawlen pagina's met zoekresultaten
  
  maximumwaarde: 100
  
  Let op: voor elke gecrawlde pagina worden kosten in rekening gebracht (10 organische resultaten per pagina);
  
  meer informatie over de prijzen vindt u op onze pagina Pricing;
  
  Let op #2: de parameters max_crawl_pages en depth vullen elkaar aan;
  
  meer informatie vindt u in ons Help Center
- os
  Type: string | null
  
  besturingssysteem van het apparaat
  
  optioneel veld
  
  als u desktop in het veld device opgeeft, kiest u uit de volgende waarden: windows, macos
  
  standaardwaarde: windows
  
  als u mobile in het veld device opgeeft, kiest u uit de volgende waarden: android, ios
  
  standaardwaarde: android
- se_domain
  Type: string | null
  
  zoekmachinedomein
  
  optioneel veld
  
  we kiezen het relevante zoekmachinedomein automatisch op basis van de locatie en taal die u opgeeft
  
  u kunt in dit veld echter een aangepast zoekmachinedomein instellen
  
  voorbeeld:
  
  google.co.uk, google.com.au, google.de, enz.
- search_param
  Type: string | null
  
  aanvullende parameters van de zoekopdracht
  
  optioneel veld
  
  de lijst met beschikbare parameters en meer details vindt u hier
  
  Let op: de volgende zoekmachineparameters worden niet ondersteund en worden automatisch uitgeschakeld als ze worden opgegeven: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
- stop_crawl_on_match
  Type: array (object | null)[] | null
  
  array van doelen waarop het crawlen moet stoppen optioneel veld indien opgegeven, bevat de respons SERP-resultaten tot en met de opgegeven match_value; u kunt maximaal 10 doelwaarden in deze array opgeven voorbeeld: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] meer informatie over deze parameter vindt u in ons Helpcentrum - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api uw account wordt gefactureerd voor elke SERP die via de opgegeven doelen wordt gecrawld
  
  match_type
  Type: string | null
  
  type doelovereenkomst verplicht veld als stop_crawl_on_match is opgegeven; type overeenkomst voor de match_value mogelijke waarden: domain, with_subdomains, wildcard
  
  match_value
  Type: string | null
  
  doeldomein of wildcardwaarde verplicht veld als stop_crawl_on_match is opgegeven; geef een doeldomein of wildcardwaarde op; Opmerking: de domeinnaam moet worden opgegeven zonder aanvraagprotocol; voorbeeld: dataforseo.com
- tag
  Type: string | null
  
  door gebruiker gedefinieerde taakidentificatie
  
  optioneel veld
  
  de tekenlimiet is 255
  
  u kunt deze parameter gebruiken om de taak te identificeren en aan het resultaat te koppelen
  
  u vindt de opgegeven tag-waarde in het data-object van de respons
- target
  Type: string | null
  
  doeldomein, subdomein of webpagina waarvoor resultaten worden opgehaald
  
  optioneel veld
  
  een domein of subdomein moet worden opgegeven zonder https:// en www.
  
  let op: de resultaten van target-specifieke taken bevatten alleen SERP-elementen die een tekenreeks url bevatten;
  
  u kunt ook een jokerteken (‘*’) gebruiken om het zoekpatroon in de SERP op te geven en de resultaten te verfijnen;
  
  voorbeelden:
  
  example.com - retourneert resultaten voor de startpagina van de website met URL's zoals https://example.com, of https://www.example.com/, of https://example.com/;
  
  example.com* - retourneert resultaten voor het domein, inclusief al zijn pagina's;
  
  *example.com* - retourneert resultaten voor het hele domein, inclusief al zijn pagina's en subdomeinen;
  
  *example.com - retourneert resultaten voor de startpagina, ongeacht het subdomein, zoals https://en.example.com;
  
  example.com/example-page - retourneert resultaten voor de exacte URL;
  
  example.com/example-page* - retourneert resultaten voor alle URL's van het domein die met de opgegeven tekenreeks beginnen
- target_search_mode
  Type: string | null
  
  modus voor doelovereenkomst
  
  optioneel veld
  
  om deze parameter in te schakelen, moet stop_crawl_on_match ook zijn ingeschakeld
  
  bepaalt hoe het crawlen moet stoppen wanneer meerdere doelen in stop_crawl_on_match zijn opgegeven
  
  mogelijke waarden: all, any
  
  all – het crawlen stopt pas wanneer alle opgegeven doelen zijn gevonden
  
  any – het crawlen stopt zodra één enkel doel is gevonden
  
  standaardwaarde: any
  
  meer informatie over deze parameter vindt u in ons Helpcentrum
- url
  Type: string | null
  
  directe URL van de zoekopdracht
  
  optioneel veld
  
  u kunt een directe URL opgeven en wij leiden de benodigde velden daaruit af. Houd er rekening mee dat deze methode het moeilijkst is voor onze API om te verwerken en dat u ook de exacte taal en locatie in de URL moet opgeven. In de meeste gevallen raden wij deze methode niet aan.
  
  voorbeeld:
  
  https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS
  
  Opmerking: de volgende zoekmachineparameters worden niet ondersteund en worden automatisch uitgeschakeld als ze in de URL worden opgegeven: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.

Responsen

200
Type: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveRegularResponseInfo
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_SerpGoogleOrganicLiveRegularTaskInfo
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

check_url
Type: string | null

directe URL naar zoekmachineresultaten
u kunt deze gebruiken om te controleren of we exacte resultaten hebben geleverd

datetime
Type: string | null

datum en tijd waarop het resultaat is ontvangen
in UTC-indeling: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2019-11-15 12:57:46 +00:00

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

soorten zoekresultaten in de SERP
bevat de soorten van alle zoekresultaten (items) die in de geretourneerde SERP zijn gevonden
mogelijke itemtypen:
answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, recipes, top_sights, scholarly_articles, popular_products, questions_and_answers, find_results_on, stocks_box, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, short_videos, refine_products, perspectives, discussions_and_forums, compare_sites, ai_overview

let op: deze array bevat alle soorten zoekresultaten die in de geretourneerde SERP zijn gevonden;
dit endpoint levert echter alleen gegevens voor de typen featured_snippet, organic en paid
raadpleeg voor alle items (inclusief SERP-functies en rich snippets) die in de geretourneerde SERP zijn gevonden de Google Organic Advanced SERP-endpoint

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

items van het element

page
Type: integer | null

paginanummer van de zoekresultaten
geeft het nummer aan van de SERP-pagina waarop het element zich bevindt

position
Type: string | null

de uitlijning van het element in de SERP
kan de volgende waarden aannemen:
left, right

rectangle
Type: object | null · Response36Afe1097B20_AiModeRectangleInfo

rechthoekparameters
bevat cartesische coördinaten en pixeldimensies van het snippet van het resultaat in de SERP
gelijk aan null als calculate_rectangles in het POST-verzoek niet op true staat

height
Type: number | null Formaat: double

hoogte van het element in pixels

width
Type: number | null Formaat: double

breedte van het element in pixels

x
Type: number | null Formaat: double

x-ascoördinaat de x-ascoördinaat van de linkerbovenhoek van het snippet van het resultaat, waarbij de linkerbovenhoek van het scherm de oorsprong is

y
Type: number | null Formaat: double

y-ascoördinaat de y-ascoördinaat van de linkerbovenhoek van het snippet van het resultaat, waarbij de linkerbovenhoek van het scherm de oorsprong is

type
Type: string | null

elementtype

xpath
Type: string | null

het XPath van het element

items_count
Type: integer | null Formaat: int64

het aantal resultaten dat in de array items wordt geretourneerd

keyword
Type: string | null

keyword ontvangen in een POST-array
het keyword wordt gedecodeerd geretourneerd (%##; het plusteken '+' wordt gedecodeerd naar een spatie)

language_code
Type: string | null

taalcode in een POST-array

location_code
Type: integer | null

locatiecode in een POST-array

pages_count
Type: integer | null Formaat: int64

totaal opgehaalde pagina's met zoekresultaten
totaal aantal opgehaalde SERP's in het resultaat

refinement_chips
Type: object | null · Response36Afe1097B20_RefinementChipsInfo

chips voor zoekverfijning

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

items van het element

domain
Type: string | null

domein in SERP

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

verdere opties voor zoekverfijning

domain
Type: string | null

domein in SERP

title
Type: string | null

titel van het element

type
Type: string | null

elementtype

url
Type: string | null

zoek-URL met verfijningsparameters

title
Type: string | null

titel van het element

type
Type: string | null

elementtype

url
Type: string | null

zoek-URL met verfijningsparameters

type
Type: string | null

elementtype

xpath
Type: string | null

de XPath van het element

se_domain
Type: string | null

zoekmachinedomein in een POST-array

se_results_count
Type: integer | null Formaat: int64

totaal aantal resultaten in de SERP

spell
Type: object | null · Response36Afe1097B20_SpellInfo

autocorrectie van de zoekmachine
als de zoekmachine resultaten heeft geleverd voor een keyword dat is gecorrigeerd, specificeren we het door de zoekmachine gecorrigeerde keyword en het type autocorrectie

keyword
Type: string | null

keyword verkregen als resultaat van de autocorrectie van de zoekmachine de resultaten worden geleverd voor het gecorrigeerde keyword

type
Type: string | null

type autocorrectie mogelijke waarden: did_you_mean, showing_results_for, no_results_found_for, including_results_for let op: Yahoo en Yandex ondersteunen alleen het volgende type autocorrectie: including_results_for

type
Type: string | null

elementtype

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/serp/google/organic/live/regular

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/organic/live/regular \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein"
  }
]'

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": [
        {
          "keyword": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "refinement_chips": {
            "type": null,
            "xpath": null,
            "items": [
              "[Max Depth Exceeded]"
            ]
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "pages_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "page": null,
              "position": null,
              "xpath": null,
              "rectangle": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Geslaagde bewerking

Live: gewone Google Organic SERP

AuthenticatieRequired

DataForSEO

Live: gewone Google Organic SERP

Prijsreferentie