v0.2.0-beta

OpenAPI 3.1.0

Vytváření úloh rozšířených recenzí Google (Business Data)

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/business_data/google/extended_reviews/task_post

Vytváření úloh rozšířených recenzí Google (Business Data)

Zařadí do fronty úplnou historii recenzí Google pro firmu, nad rámec první stránky, kterou vrací standardní endpoint, a vrátí id úlohy. Odpověď je zabalena 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. Načtěte pomocí get_dataforseo_business_google_extended_reviews_fetch; kratší verze je post_dataforseo_business_google_reviews_submit.

Referenční ceny

Účtování: vykázaná cena odpovědi.
Referenční odhad ceny požadavku: USD 0.2428.
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 ani limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

Tělo

application/json

Typ: array (object | null)[]
- cid
  Typ: string
  
  jedinečný identifikátor obchodního subjektu definovaný Googlem
  povinné pole, pokud nezadáte keyword nebo place_id
  příklad:
  194604053573767737
  více o identifikátoru v tomto článku nápovědy
  
  Poznámka: pokud toto pole použijete, bude vám za úlohy týkající se Google Reviews API účtována dvojnásobná standardní sazba
- depth
  Typ: integer | null
  
  hloubka parsování
  volitelné pole
  počet recenzí v SERP
  důrazně doporučujeme nastavovat hloubku parsování v násobcích dvaceti, protože naše systémy zpracovávají dvacet recenzí za sebou
  výchozí hodnota: 20
  maximální hodnota: 1000
  
  Váš účet bude účtován za každý SERP obsahující až 20 výsledků;
  nastavení hloubky nad 20 může vést k dodatečným poplatkům, pokud vyhledávač vrátí více než 20 výsledků;
  náklady lze vypočítat na stránce Ceny.
- keyword
  Typ: string
  
  klíčové slovo
  povinné pole, pokud nezadáte cid nebo place_id
  zadané klíčové slovo by mělo označovat název místní provozovny;
  do pole keyword můžete zadat až 700 znaků;
  všechny řetězce %## budou dekódovány (znak „+“ bude dekódován jako mezera)
  pokud potřebujete v keyword použít znak „%“, zadejte jej jako „%25“;
  
  pokud toto pole obsahuje parametry jako „allinanchor:“, „allintext:“, „allintitle:“, „allinurl:“, „define:“, „filetype:“, „id:“, „inanchor:“, „info:“, „intext:“, „intitle:“, „inurl:“, „link:“, „related:“, „site:“, poplatek za úlohu bude vynásoben 5
  Poznámka: dotazy obsahující parametr „cache:“ nejsou podporovány a vrátí chybu validace
  
  více o pravidlech a omezeních polí keyword a keywords v rozhraních DataForSEO najdete v tomto článku nápovědy
  
  Poznámka: pokud toto pole použijete, bude vám za úlohy týkající se Google Reviews API účtována trojnásobná standardní sazba
- language_code
  Typ: string
  
  kód jazyka vyhledávače
  povinné pole, pokud nezadáte language_name
  pokud toto pole použijete, nemusíte zadávat language_name
  seznam dostupných jazyků s jejich language_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/business_data/google/languages
  příklad:
  en
- language_name
  Typ: string
  
  úplný název jazyka vyhledávače
  povinné pole, pokud nezadáte language_code
  pokud toto pole použijete, nemusíte zadávat language_code
  seznam dostupných jazyků s language_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/business_data/google/languages
  příklad:
  English
- location_code
  Typ: integer
  
  kód lokality vyhledávače
  povinné pole, pokud nezadáte location_name nebo location_coordinate
  pokud toto pole použijete, nemusíte zadávat location_name ani location_coordinate
  seznam dostupných lokalit s location_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/business_data/google/locations
  příklad:
  2840
- location_coordinate
  Typ: string
  
  GPS souřadnice lokality
  povinné pole, pokud nezadáte location_name nebo location_code
  pokud toto pole použijete, nemusíte zadávat location_name ani location_code
  parametr location_coordinate je nutné zadat ve formátu "latitude,longitude,radius"
  maximální počet desetinných míst pro "latitude" a "longitude": 7
  minimální hodnota "radius": 199.9
  příklad:
  53.476225,-2.243572,200
- location_name
  Typ: string
  
  úplný název lokality vyhledávače
  povinné pole, pokud nezadáte location_code nebo location_coordinate
  pokud toto pole použijete, nemusíte zadávat location_code ani location_coordinate
  seznam dostupných lokalit s location_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/business_data/google/locations
  příklad:
  London,England,United Kingdom
- pingback_url
  Typ: string | null
  
  URL oznámení o dokončené úloze
  volitelné pole
  po dokončení úlohy vás upozorníme požadavkem GET odeslaným na zadanou URL
  řetězec ‘$id’ můžete použít jako proměnnou $id a ‘$tag’ jako proměnnou $tag kódovanou v URL. Před odesláním požadavku nastavíme potřebné hodnoty
  příklad:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Poznámka: speciální znaky v pingback_url budou kódovány v URL;
  mj. znak # bude zakódován jako %23
  
  další informace najdete v Centru nápovědy
- place_id
  Typ: string
  
  identifikátor obchodního subjektu v Google Maps
  povinné pole, pokud nezadáte keyword nebo cid
  příklad:
  GhIJQWDl0CIeQUARxks3icF8U8A
  více o identifikátoru v tomto článku nápovědy
  
  Poznámka: pokud toto pole použijete, bude vám za úlohy týkající se Google Reviews API účtována dvojnásobná standardní sazba
- postback_url
  Typ: string | null
  
  URL pro odesílání výsledků úlohy
  volitelné pole
  po dokončení úlohy odešleme požadavek POST s výsledky komprimovanými ve formátu gzip na zadanou postback_url
  řetězec ‘$id’ můžete použít jako proměnnou $id a ‘$tag’ jako proměnnou $tag kódovanou v URL. Před odesláním požadavku nastavíme potřebné hodnoty.
  příklad:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Poznámka: speciální znaky v postback_url budou kódovány v URL;
  mj. znak # bude zakódován jako %23
  
  další informace najdete v Centru nápovědy
- priority
  Typ: integer | null
  
  priorita úlohy
  volitelné pole
  může nabývat následujících hodnot:
  1 – normální priorita provedení (nastaveno ve výchozím nastavení)
  2 – vysoká priorita provedení. Za úlohy s vysokou prioritou provedení bude účtován příplatek.
  Náklady lze vypočítat na stránce Ceny.
- tag
  Typ: string | null
  
  uživatelem definovaný identifikátor úlohy
  volitelné pole
  limit znaků je 255
  tento parametr můžete použít k identifikaci úlohy a jejímu spárování s výsledkem
  zadanou hodnotu tag najdete v objektu data odpovědi

Odpovědi

200
Typ: object | null · Response36Afe1097B20_BusinessDataGoogleExtendedReviewsTaskPostResponseInfo
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_BusinessDataGoogleExtendedReviewsTaskPostTaskInfo
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: object | null

pole výsledků
v tomto případě bude hodnota null

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

post/v1/beta/dataforseo/business_data/google/extended_reviews/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/extended_reviews/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_name": "London,England,United Kingdom",
    "language_name": "english",
    "cid": "17626775537598922320"
  }
]'

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": null
    }
  ]
}

Úspěšná operace

Vytváření úloh rozšířených recenzí Google (Business Data)

OvěřováníRequired

DataForSEO

Vytváření úloh rozšířených recenzí Google (Business Data)

Referenční ceny