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

Živý Google News SERP HTML

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

Živý Google News SERP HTML

​

Synchronně vrací výsledky zpráv pro klíčové slovo v Google. Surový zdrojový kód stránky místo parsovaných výsledků. 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.

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

      hloubka parsování

      volitelné pole

      počet výsledků v SERP

      výchozí hodnota: 10

      maximální hodnota: 200


      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ů;

      Pokud je zadaná hloubka vyšší než počet výsledků v odpovědi, rozdíl vám bude automaticky vrácen na zůstatek účtu

      Náklady lze vypočítat na stránce Ceny.

    • keyword
      Typ: string

      klíčové slovo

      povinné pole

      můžete zadat až 700 znaků v poli keyword

      všechny výskyty %## budou dekódovány (znak '+' bude dekódován jako mezera)

      pokud potřebujete použít znak "%" v poli keyword, zadejte jej jako "%25";

      pokud potřebujete použít znak „+” v poli keyword, zadejte jej jako „%2B”;

      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 ověření


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

    • 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 lokalit vyhledávače s jejich language_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/{{low_se_name}}/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ů vyhledávače s jejich language_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/{{low_se_name}}/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 nebo location_coordinate

      seznam dostupných lokalit vyhledávačů s jejich location_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/{{low_se_name}}/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 nebo 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 pro "radius": 199.9 (mm)

      maximální hodnota pro "radius": 199999 (mm)

      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 nebo location_coordinate

      seznam dostupných lokalit vyhledávače s jejich location_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations

      příklad:

      London,England,United Kingdom

    • max_crawl_pages
      Typ: integer | null

      limit procházení stránek

      volitelné pole

      počet stránek výsledků hledání k procházení

      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

      mějte na paměti, že toto API poskytuje výsledky pouze pro desktop

      vyberte z následujících hodnot: windows, macos

      výchozí hodnota: windows

    • se_domain
      Typ: string | null

      doména vyhledávače

      volitelné pole

      relevantní doménu vyhledávače vybíráme automaticky podle zadané lokality a jazyka

      v tomto poli však můžete nastavit vlastní doménu vyhledávače

      příklad:

      google.co.uk, google.com.au, google.de, atd.

    • search_param
      Typ: string | null

      další parametry vyhledávacího dotazu

      volitelné pole

      seznam dostupných parametrů a další podrobnosti najdete zde

    • tag
      Typ: string | null

      identifikátor úlohy definovaný uživatelem

      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í. Upozorňujeme, že tato metoda je pro naše API nejnáročnější na zpracování a vyžaduje zadání přesného jazyka a lokality v URL. Ve většině případů tuto metodu nedoporučujeme.

      příklad:

      https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS

Odpovědi
  • 200
    Typ: object | null · Response36Afe1097B20_SerpGoogleNewsLiveHtmlResponseInfo
    • 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_SerpGoogleNewsLiveHtmlTaskInfo
        • 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ů

          • 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

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

            prvky výsledků vyhledávání nalezené v SERP

            • date
              Typ: string | null

              datum a čas skenování stránky HTML
              ve formátu UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              příklad:
              2019-11-15 12:57:46 +00:00

            • html
              Typ: string | null

              stránka HTML

            • page
              Typ: integer | null

              pořadové číslo vrácené stránky HTML

          • 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 %## (znak plus '+' bude dekódován jako mezera)

          • language_code
            Typ: string | null

            kód jazyka v poli POST

          • location_code
            Typ: integer | null

            kód lokality v poli POST

          • se_domain
            Typ: string | null

            doména vyhledávače v poli POST

          • 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
Request Example for post/v1/beta/dataforseo/serp/google/news/live/html
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/news/live/html \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein"
  }
]'

{
  "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,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "page": null,
              "date": null,
              "html": null
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

Live Google News SERP HTML