v0.2.0-beta

OpenAPI 3.1.0

Uitgebreide Naver Organic SERP-resultaten op id ophalen

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

get/v1/beta/dataforseo/serp/naver/organic/task_get/advanced/{id}

Uitgebreide Naver Organic SERP-resultaten op id ophalen

Haalt een in de wachtrij geplaatst Naver Organic-resultaat op basis van id op. 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.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.

Padparameters

id
Type: string
verplicht

taak-ID
unieke taak-ID in ons systeem in UUID-formaat
je kunt deze 30 dagen lang gebruiken om op elk moment de resultaten van de taak op te vragen

Responsen

200
Type: object | null · Response36Afe1097B20_SerpNaverOrganicTaskGetAdvancedResponseInfo
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_SerpNaverOrganicTaskGetAdvancedTaskInfo
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 nauwkeurige 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 zoekresultaten (items) die in de SERP zijn gevonden.
mogelijke itemtypen:
images, local_pack, map, organic, paid, related_searches, video

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

aanvullende items in het element
als er geen zijn, is de waarde null

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 geretourneerd met gedecodeerde %## (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
totaal aantal opgehaalde SERP's in het resultaat

refinement_chips
Type: object | null · Response36Afe1097B20_RefinementChipsInfo

chips voor zoekverfijning
is gelijk aan null

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

get/v1/beta/dataforseo/serp/naver/organic/task_get/advanced/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/naver/organic/task_get/advanced/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

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

Uitgebreide Naver Organic SERP-resultaten op id ophalen

AuthenticatieRequired

DataForSEO

Uitgebreide Naver Organic SERP-resultaten op id ophalen

Prijsreferentie