Felo API PlatformFelo API Platform
Všechny endpointy DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Vytváření úloh recenzí Tripadvisor (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

Vytváření úloh recenzí Tripadvisor (Business Data)

​

Zařadí do fronty recenze Tripadvisor pro jeden objekt a vrátí id úlohy. 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. Načtěte pomocí get_dataforseo_business_tripadvisor_reviews_fetch; ekvivalent pro Trustpilot je post_dataforseo_business_trustpilot_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)[]
    • 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 deseti, protože naše systémy zpracovávají deset recenzí za sebou;
      výchozí hodnota: 10;
      maximální hodnota: 4490
      Váš účet bude účtován za každý SERP obsahující až 10 výsledků;
      nastavení hloubky nad 10 může vést k dodatečným poplatkům, pokud vyhledávač vrátí více než 10 výsledků;
      náklady lze vypočítat na stránce Ceny.

    • keyword
      Typ: string

      klíčové slovo
      povinné pole, pokud nezadáte url_path
      zadané klíčové slovo by mělo označovat název existujícího podniku nebo významného místa na Tripadvisoru;
      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“

    • language_code
      Typ: string | null

      kód jazyka vyhledávače
      volitelné pole
      pokud toto pole použijete, bude vám účtován poplatek za jeden požadavek navíc
      seznam dostupných jazyků s language_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/business_data/tripadvisor/languages
      příklad:
      en
      Za nastavení parametru jazyka v tomto endpointu bude účtován příplatek.
      Náklady lze vypočítat na stránce Ceny.

    • language_name
      Typ: string | null

      úplný název jazyka vyhledávače
      volitelné pole
      pokud toto pole použijete, bude vám účtován poplatek za jeden požadavek navíc
      seznam dostupných jazyků s language_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/business_data/tripadvisor/languages
      příklad:
      English
      Za nastavení parametru jazyka v tomto endpointu bude účtován příplatek.
      Náklady lze vypočítat na stránce Ceny.

    • location_code
      Typ: integer

      kód lokality vyhledávače
      povinné pole, pokud nezadáte location_name nebo url_path
      seznam dostupných lokalit s location_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/business_data/tripadvisor/locations
      příklad:
      1003854

    • location_name
      Typ: string

      úplný název lokality vyhledávače
      povinné pole, pokud nezadáte location_code nebo url_path
      seznam dostupných lokalit s location_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/business_data/tripadvisor/locations
      příklad:
      London,England,United Kingdom

    • months
      Typ: array string[] | null

      filtr podle měsíců, kdy cestovatel uskutečnil návštěvu
      volitelné pole
      možné hodnoty: january, february, march, april, may, april, june, july, august, september, october, november, december
      můžete zadat několik hodnot najednou

    • 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

    • 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.

    • ratings
      Typ: array string[] | null

      hodnocení místa cestovateli na Tripadvisoru
      volitelné pole
      hodnocení založené na písemných recenzích cestovatele po návštěvě místa.
      možné hodnoty: excellent, very_good, average, poor, terrible
      můžete zadat několik hodnot najednou

    • sort_by
      Typ: string | null

      parametry řazení výsledků
      volitelné pole
      pomocí tohoto pole můžete výsledky řadit;
      možné typy řazení:
      most_recent
      detailed_reviews

    • 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

    • translate_reviews
      Typ: boolean | null

      překlad recenzí podle cesty URL
      volitelné pole
      při nastavení na true budou vrácené recenze přeloženy do jazyka odpovídajícího zadané url_path;
      například pokud url_path obsahuje tripadvisor.it a translate_reviews je true, recenze budou přeloženy do italštiny;
      výchozí hodnota: true
      více o tom, jak se recenze překládají, najdete v tomto článku nápovědy

    • url_path
      Typ: string

      cesta URL obchodního subjektu
      povinné pole, pokud nezadáte keyword
      cesta URL na stránku obchodního subjektu na Tripadvisoru;
      příklady:
      Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html
      https://www.tripadvisor.com/Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html

    • visit_type
      Typ: array string[] | null

      filtr podle typu cestovatelů, kteří zanechali recenzi
      volitelné pole
      možné hodnoty: families, couples, solo, business, friends
      můžete zadat několik hodnot najednou

Odpovědi
  • 200
    Typ: object | null · Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskPostResponseInfo
    • 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_BusinessDataTripadvisorReviewsTaskPostTaskInfo
        • 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
Request Example for post/v1/beta/dataforseo/business_data/tripadvisor/reviews/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/tripadvisor/reviews/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "url_path": "Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html",
    "location_code": 1003854,
    "pingback_url": "https://your-server.com/pingback.php?id=$id&tag=$tag",
    "tag": "some_string_123"
  }
]'

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

Setting Business Data Tripadvisor Reviews Tasks