v0.2.0-beta

OpenAPI 3.1.0

Nastavení úloh SERP Google Events

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

post/v1/beta/dataforseo/serp/google/events/task_post

Nastavení úloh SERP Google Events

Zařadí do fronty události, které Google u dotazu zobrazuje, a vrátí id úlohy v tasks[0].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. Živá verze odpovídá okamžitě a u jediného dotazu je jednodušší; do fronty zařaďte, když by dávka trvala déle než volání nástroje.

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. Neaplikujte jej znovu na 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.

Tělo

povinné

application/json

Typ: array object[]
- keyword
  Typ: string
  povinné
  
  Klíčové slovo k vyhledání
- language_code
  Typ: string
  
  Kód jazyka vyhledávače
- language_name
  Typ: string
  
  Úplný název jazyka vyhledávače
- location_code
  Typ: integer
  
  Kód lokality vyhledávače
- location_coordinate
  Typ: string
  
  GPS souřadnice lokality
- location_name
  Typ: string
  
  Úplný název lokality vyhledávače
- pingback_url
  Typ: string
  
  URL oznámení o dokončené úloze
- postback_data
  Typ: string
  
  Datový typ postback
- postback_url
  Typ: string
  
  URL pro odesílání výsledků úlohy
- priority
  Typ: integer
  
  Priorita úlohy

Odpovědi

200
Typ: object

Úspěšná odpověď
cost
Typ: number

Celkové náklady na úlohy, USD

status_code
Typ: integer

Obecný kód stavu

status_message
Typ: string

Obecná informační zpráva

tasks
Typ: array string[]

Pole objektů úloh

tasks_count
Typ: integer

Počet úloh v poli úloh

tasks_error
Typ: integer

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

tasks[].cost
Typ: number

Náklady na úlohu, USD

tasks[].id
Typ: string

Identifikátor úlohy ve formátu UUID

tasks[].result_count
Typ: integer

Počet prvků v poli výsledků

tasks[].status_code
Typ: integer

Kód stavu úlohy

tasks[].status_message
Typ: string

Zpráva o stavu úlohy

time
Typ: string

Doba provedení, sekundy

version
Typ: string

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

post/v1/beta/dataforseo/serp/google/events/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/events/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "",
    "location_code": 1,
    "location_name": "",
    "location_coordinate": "",
    "language_code": "",
    "language_name": "",
    "priority": 1,
    "postback_url": "",
    "pingback_url": "",
    "postback_data": ""
  }
]'

Zobrazit schéma

{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks[].id": "string",
  "tasks[].status_code": 1,
  "tasks[].status_message": "string",
  "tasks[].cost": 1,
  "tasks[].result_count": 1
}

Úspěšná odpověď

Nastavení úloh SERP Google Events

OvěřováníRequired

DataForSEO

Nastavení úloh SERP Google Events

Cenová reference