v0.2.0-beta

OpenAPI 3.1.0

Načtení organických výsledků SERP Google podle id

Felo API Support

MIT

Server

https://openapi.felo.ai

Klientské knihovny

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operace

get/v1/beta/dataforseo/serp/google/organic/task_get/regular/{id}

Načtení organických výsledků SERP Google podle id

Zabaleno do obálky DataForSEO: data v tasks[0].result, výsledek v tasks[0].status_code — odmítnutý požadavek stále vrací HTTP 200.

Cenová reference

Účtování: nahlášené náklady na odpověď.
Referenční odhad požadavku: USD 0.02.
Referenční multiplikátor zákazníka: 1.0. Znovu jej neaplikujte na již zúčtovanou částku zákazníka.

Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

Parametry cesty

id
Typ: string
povinné

identifikátor úlohy
jedinečný identifikátor úlohy v našem systému ve formátu UUID
můžete jej po dobu 30 dní kdykoli použít k vyžádání výsledků úlohy

Odpovědi

200
Typ: object | null · Response36Afe1097B20_SerpGoogleOrganicTaskGetRegularResponseInfo
cost
Typ: number | null Formát: double

celkové náklady na úlohy, USD

status_code
Typ: integer | null

obecný kód stavu úplný seznam kódů odpovědí najdete zde

status_message
Typ: string | null

obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde

tasks
Typ: array (object | null)[] | null

pole úloh

Typ: object | null · Response36Afe1097B20_SerpGoogleOrganicTaskGetRegularTaskInfo
cost
Typ: number | null Formát: double

celkové náklady na úlohy, USD

data
Typ: object | null

obsahuje stejné parametry, které jste zadali v požadavku POST

propertyName
Typ: object | null
id
Typ: string | null

identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID

path
Typ: array (string | null)[] | null

cesta URL

result
Typ: array (object | null)[] | null

pole výsledků

check_url
Typ: string | null

přímá adresa URL na výsledky vyhledávače
můžete ji použít k ověření, že jsme poskytli přesné výsledky

datetime
Typ: string | null

datum a čas přijetí výsledku
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”
příklad:
2019-11-15 12:57:46 +00:00

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

typy výsledků vyhledávání nalezených v SERP
obsahuje typy všech výsledků vyhledávání (items) nalezených ve vráceném SERP
možné typy položek:
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

poznámka toto pole obsahuje všechny typy výsledků vyhledávání nalezené ve vráceném SERP;
tento endpoint však poskytuje data pouze pro typy featured_snippet, organic a paid;
chcete-li získat všechny položky (včetně funkcí SERP a rozšířených úryvků) nalezené ve vráceném SERP, použijte endpoint Google Organic Advanced SERP

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

položky v SERP

page
Typ: integer | null

číslo stránky výsledků vyhledávání
udává číslo stránky SERP, na které se prvek nachází

position
Typ: string | null

zarovnání prvku v SERP
může nabývat následujících hodnot:
left, right

rectangle
Typ: object | null · Response36Afe1097B20_AiModeRectangleInfo

parametry obdélníku
obsahuje kartézské souřadnice a rozměry v pixelech úryvku výsledku v SERP
rovná se null, pokud calculate_rectangles v požadavku POST není nastaveno na true

height
Typ: number | null Formát: double

výška prvku v pixelech

width
Typ: number | null Formát: double

šířka prvku v pixelech

x
Typ: number | null Formát: double

souřadnice osy x souřadnice osy x levého horního rohu úryvku výsledku, přičemž počátkem je levý horní roh obrazovky

y
Typ: number | null Formát: double

souřadnice osy y souřadnice osy y levého horního rohu úryvku výsledku, přičemž počátkem je levý horní roh obrazovky

type
Typ: string | null

typ prvku

xpath
Typ: string | null

XPath prvku

items_count
Typ: integer | null Formát: int64

počet výsledků vrácených v poli items

keyword
Typ: string | null

klíčové slovo přijaté v poli POST
klíčové slovo se vrací s dekódovaným %## (symbol „+” bude dekódován na znak mezery)

language_code
Typ: string | null

kód jazyka v poli POST

location_code
Typ: integer | null

kód lokality v poli POST

pages_count
Typ: integer | null Formát: int64

celkový počet načtených stránek výsledků vyhledávání
celkový počet načtených SERP ve výsledku

refinement_chips
Typ: object | null · Response36Afe1097B20_RefinementChipsInfo

čipy pro upřesnění vyhledávání
pokud žádné nejsou, hodnota je null

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

položky prvku

domain
Typ: string | null

doména v SERP

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

další možnosti upřesnění vyhledávání

domain
Typ: string | null

doména v SERP

title
Typ: string | null

název prvku

type
Typ: string | null

typ prvku

url
Typ: string | null

URL vyhledávání s parametry upřesnění

title
Typ: string | null

název prvku

type
Typ: string | null

typ prvku

url
Typ: string | null

URL vyhledávání s parametry upřesnění

type
Typ: string | null

typ prvku

xpath
Typ: string | null

XPath prvku

se_domain
Typ: string | null

doména vyhledávače v poli POST

se_results_count
Typ: integer | null Formát: int64

celkový počet výsledků v SERP

spell
Typ: object | null · Response36Afe1097B20_SpellInfo

automatická oprava vyhledávače
pokud vyhledávač poskytl výsledky pro opravené klíčové slovo, uvedeme klíčové slovo opravené vyhledávačem a typ automatické opravy;
pokud žádná není, hodnota je null

keyword
Typ: string | null

klíčové slovo získané v důsledku automatické opravy vyhledávače výsledky budou poskytnuty pro opravené klíčové slovo

type
Typ: string | null

typ automatické opravy možné hodnoty: did_you_mean, showing_results_for, no_results_found_for, including_results_for poznámka: Yahoo a Yandex podporují pouze následující typ automatické opravy: including_results_for

type
Typ: string | null

typ prvku

result_count
Typ: integer | null Formát: int64

počet prvků v poli result

status_code
Typ: integer | null

stavový kód úlohy vygenerovaný DataForSEO; může být v následujícím rozsahu: 10000-60000 úplný seznam kódů odpovědí najdete zde

status_message
Typ: string | null

informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde

time
Typ: string | null

doba provedení, sekundy

tasks_count
Typ: integer | null Formát: int64

počet úloh v poli tasks

tasks_error
Typ: integer | null Formát: int64

počet úloh v poli tasks vrácených s chybou

time
Typ: string | null

celková doba provádění, sekundy

version
Typ: string | null

aktuální verze API
application/json
400

Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.
401

Je vyžadován platný API klíč Felo.
402

V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.
403

Účet nemá oprávnění tuto operaci provést.
429

Byl dosažen limit požadavků nebo útraty.
502

Služba nemohla požadavek dokončit.
503

API nebo fakturační služba je dočasně nedostupná.
504

Při zpracování požadavku vypršel časový limit služby.
default

Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele

application/json

get/v1/beta/dataforseo/serp/google/organic/task_get/regular/{id}

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

Zobrazit schéma

{
  "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]"
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

Načtení organických výsledků SERP Google podle id

OvěřováníRequired

DataForSEO

Načtení organických výsledků SERP Google podle id

Cenová reference