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

Vytváření úloh organického SERP Naver

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 organického SERP Naver

​

Zařadí výsledky v pořadí pro klíčové slovo v Naver do fronty 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á varianta odpovídá okamžitě a u jediného dotazu je jednodušší; do fronty zařaďte, když by dávka přesáhla trvání 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. 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.

Tělo
application/json
  • Typ: array (object | null)[]
    • depth
      Typ: integer | null

      hloubka analýzy
      volitelné pole
      počet výsledků v SERP
      výchozí hodnota: 15
      maximální hodnota: 700
      Váš účet bude účtován za každý SERP obsahující až 15 výsledků;
      nastavení hloubky nad 15 může vést k dodatečným poplatkům pokud vyhledávač vrátí více než 15 výsledků;
      Náklady lze vypočítat na stránce Ceny.

    • device
      Typ: string | null

      typ zařízení
      volitelné pole
      vracet výsledky pro určitý typ zařízení
      možné hodnoty:desktop, mobile
      výchozí hodnota: desktop

    • keyword
      Typ: string

      klíčové slovo
      povinné pole
      v poli keyword můžete zadat až 700 znaků
      všechny %## budou dekódovány (znak ‘+’ bude dekódován jako mezera)
      pokud potřebujete v keyword použít znak „%“, zadejte jej jako „%25“;
      pokud potřebujete v keyword použít znak „+“, zadejte jej jako „%2B“

      další informace o pravidlech a omezeních polí keyword a keywords v rozhraních API DataForSEO najdete v článku Centra nápovědy

    • max_crawl_pages
      Typ: integer | null

      limit procházení stránek
      volitelné pole
      počet stránek výsledků vyhledávání k procházení
      výchozí hodnota: 1
      maximální hodnota: 100
      Poznámka: parametry max_crawl_pages a depth se vzájemně doplňují;
      další informace najdete v našem Centru nápovědy

    • os
      Typ: string | null

      operační systém zařízení
      volitelné pole
      pokud v poli device zadáte desktop, vyberte z následujících hodnot: windows, macos
      výchozí hodnota: windows
      pokud v poli device zadáte mobile, vyberte z následujících hodnot: android, ios
      výchozí hodnota: android

    • 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_data
      Typ: string

      datový typ postback_url
      povinné pole, pokud zadáte postback_url
      odpovídá funkci, kterou jste použili k nastavení úlohy
      možné hodnoty:
      regular, advanced, html

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

    • se_domain
      Typ: string | null

      doména vyhledávače
      volitelné pole
      relevantní doménu vyhledávače vybíráme automaticky
      v tomto poli však můžete nastavit vlastní doménu vyhledávače
      příklad:
      search.naver.com

    • search_param
      Typ: string | null

      další parametry vyhledávacího dotazu
      volitelné pole
      seznam dostupných parametrů a další podrobnosti najdete zde

    • stop_crawl_on_match
      Typ: array (object | null)[] | null

      pole cílových hodnot pro zastavení procházení volitelné pole pokud je zadáno, odpověď bude obsahovat výsledky SERP až do zadané hodnoty match_value včetně; v tomto poli můžete zadat až 10 cílových hodnot příklad: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] další informace o tomto parametru najdete v našem Centru nápovědy — https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Váš účet bude účtován za každý SERP procházený přes zadané cíle

      • match_type
        Typ: string | null

        typ shody cíle povinné pole, pokud je zadáno stop_crawl_on_match; typ shody pro match_value možné hodnoty: domain, with_subdomains, wildcard

      • match_value
        Typ: string | null

        cílová doména nebo hodnota se zástupným znakem povinné pole, pokud je zadáno stop_crawl_on_match; zadejte cílovou doménu nebo hodnotu se zástupným znakem; Poznámka: název domény je nutné zadat bez protokolu požadavku; příklad: dataforseo.com

    • 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

    • url
      Typ: string | null

      přímá URL vyhledávacího dotazu
      volitelné pole
      můžete zadat přímou URL a my ji rozebereme do potřebných polí
      ve většině případů tuto metodu nedoporučujeme;
      příklad:
      https://search.naver.com/search.naver?where=nexearch&sm=top_hty&fbm=1&ie=utf8&query=iphone

Odpovědi
  • 200
    Typ: object | null · Response36Afe1097B20_SerpNaverOrganicTaskPostResponseInfo
    • 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_SerpNaverOrganicTaskPostTaskInfo
        • 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/serp/naver/organic/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/naver/organic/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "albert einstein",
    "device": "desktop",
    "tag": "some_string_123",
    "postback_url": "https://your-server.com/postbackscript.php",
    "postback_data": "regular"
  }
]'

{
  "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 Naver Organic SERP Tasks