v0.2.0-beta

OpenAPI 3.1.0

Live: Yahoo Organic SERP HTML

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/yahoo/organic/live/html

Live: Yahoo Organic SERP HTML

Retourneert synchroon de gerangschikte resultaten voor een keyword op Yahoo. Ruwe paginabron in plaats van geparseerde resultaten. 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.02.
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
  
  parsingdiepte
  optioneel veld
  aantal resultaten in de SERP
  standaardwaarde: 10
  maximale waarde: 200
  Uw account wordt gefactureerd per SERP met maximaal 10 resultaten;
  Een diepte boven 10 kan extra kosten opleveren als de zoekmachine meer dan 10 resultaten retourneert;
  De kosten kunnen worden berekend op de pagina Prijzen.
- device
  Type: string | null
  
  apparaattype
  optioneel veld
  resultaten retourneren voor een bepaald apparaattype
  kan de waarden hebben:desktop, mobile
  standaardwaarde: desktop
- 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 “%” in uw keyword wilt gebruiken, geeft u dit op als “%25”;
  als u het teken “+” in uw keyword wilt gebruiken, geeft u dit op als “%2B”
  
  meer informatie over de regels en beperkingen van de velden keyword en keywords in DataForSEO-API's vindt u in dit Helpcentrum-artikel
- language_code
  Type: string
  
  taalcode van de zoekmachine
  verplicht veld als u language_name niet opgeeft
  als u dit veld gebruikt, hoeft u language_name niet op te geven
  u kunt de lijst met beschikbare talen van de zoekmachine met hun language_code opvragen met een afzonderlijk verzoek aan https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
  voorbeeld:
  enn
- language_name
  Type: string
  
  volledige naam van de taal van de zoekmachine
  verplicht veld als u language_code niet opgeeft
  als u dit veld gebruikt, hoeft u language_code niet op te geven
  u kunt de lijst met beschikbare talen van de zoekmachine met hun language_name opvragen met een afzonderlijk verzoek aan https://api.dataforseo.com/v3/serp/{{low_se_name}}/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/{{low_se_name}}/locations
  voorbeeld:
  2840
- location_coordinate
  Type: string
  
  GPS-coördinaten van een locatie
  verplicht veld als u location_name of location_code niet opgeeft
  als u dit veld gebruikt, hoeft u 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 minimale waarde voor "radius": 199.9 (mm)
  de maximale waarde 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/{{low_se_name}}/locations
  voorbeeld:
  London,England,United Kingdom
- max_crawl_pages
  Type: integer | null
  
  paginalimiet voor crawlen
  optioneel veld
  aantal pagina's met zoekresultaten dat moet worden gecrawld
  standaardwaarde: 1
  maximale waarde: 100
  Opmerking: de parameters max_crawl_pages en depth vullen elkaar aan;
  meer informatie vindt u in ons helpcentrum
- os
  Type: string | null
  
  besturingssysteem van het apparaat
  optioneel veld
  als u in het veld device desktop opgeeft, kiest u uit de volgende waarden: windows, macos
  standaardwaarde: windows
  als u in het veld device mobile opgeeft, kiest u uit de volgende waarden: android, ios
  standaardwaarde: android
- se_domain
  Type: string | null
  
  zoekmachinedomein
  optioneel veld
  wij kiezen het relevante zoekmachinedomein automatisch op basis van de door u opgegeven locatie en taal
  u kunt echter een aangepast zoekmachinedomein instellen in dit veld
  voorbeeld:
  au.search.yahoo.com, uk.search.yahoo.com, ca.search.yahoo.com, enz.
- search_param
  Type: string | null
  
  aanvullende parameters van de zoekopdracht
  optioneel veld
  bekijk hier de lijst met beschikbare parameters en aanvullende details
- 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
- 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://search.yahoo.com/search?p=rank+checker&n=100&vl=lang_en&vc=us&ei=UTF-8

Responsen

200
Type: object | null · Response36Afe1097B20_SerpYahooOrganicLiveHtmlResponseInfo
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_SerpYahooOrganicLiveHtmlTaskInfo
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

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

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

elementen van zoekresultaten die in de SERP zijn gevonden

date
Type: string | null

datum en tijd waarop de HTML-pagina is gescand
in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2019-11-15 12:57:46 +00:00

html
Type: string | null

HTML-pagina

page
Type: integer | null

volgnummer van de geretourneerde HTML-pagina

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

se_domain
Type: string | null

zoekmachinedomein in een POST-array

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/yahoo/organic/live/html

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/yahoo/organic/live/html \
  --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,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "page": null,
              "date": null,
              "html": null
            }
          ]
        }
      ]
    }
  ]
}

Geslaagde bewerking

Live: Yahoo Organic SERP HTML

AuthenticatieRequired

DataForSEO

Live: Yahoo Organic SERP HTML

Prijsreferentie