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

Historický přehled pořadí

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

Historický přehled pořadí

​

Přehled pořadí domény, jak stál v každém bodě dostupné historie. Tento endpoint nepřijímá parametr limitu, ale účtuje se za volání, nikoli za položku, takže odešlete celý seznam najednou. 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. Nejprve zkontrolujte get_dataforseo_labs_google_available_history – uvádí existující data a požadavek na datum mimo ně vrací nic, nikoli chybu. Aktuálním snímkem je post_dataforseo_labs_google_domain_rank_overview_live.

Referenční ceny

  • Účtování: vykázaná cena odpovědi.
  • Referenční odhad ceny požadavku: USD 0.1356.
  • 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)[]
    • correlate
      Typ: boolean | null

      korelovat data s dříve získanými datovými sadami
      volitelné pole
      výchozí hodnota: true
      pokud tento parametr použijete, náš systém zkoreluje data, která nyní získáte, s dříve získanými datovými sadami
      tento parametr má zmírnit nesrovnalosti, které mohou vzniknout změnami v naší databázi
      doporučujeme vždy nastavit correlate na true

    • date_from
      Typ: string | null

      počáteční datum časového rozsahu
      volitelné pole
      pokud toto pole nezadáte, data budou poskytnuta za předchozích 6 měsíců
      minimální možná hodnota: 2020-10-01
      formát data: "yyyy-mm-dd"

    • date_to
      Typ: string | null

      koncové datum časového rozsahu
      volitelné pole
      pokud toto pole nezadáte, ve výchozím nastavení se použije dnešní datum
      formát data: "yyyy-mm-dd"
      příklad:
      "2021-04-01"

    • ignore_synonyms
      Typ: boolean | null

      ignorovat velmi podobná klíčová slova
      volitelné pole
      pokud je nastaveno na true, vrátí se pouze data založená na hlavních klíčových slovech a data pro všechna velmi podobná klíčová slova budou vyloučena;
      výchozí hodnota: false

    • include_clickstream_data
      Typ: boolean | null

      zahrnout nebo vyloučit data z metrik založených na clickstreamu ve výsledku
      volitelné pole
      pokud je parametr nastaven na true, obdržíte pole clickstream_etv, clickstream_gender_distribution a clickstream_age_distribution s daty clickstreamu v odpovědi;
      výchozí hodnota: false;

      Poznámka: historická data clickstreamu jsou dostupná od 2024/05 (května 2024);
      při zapnutí tohoto parametru bude požadavek účtován dvojnásobnou cenou;
      další informace o tom, jak se metriky založené na clickstreamu počítají, najdete v tomto článku Centra nápovědy

    • language_code
      Typ: string | null

      kód jazyka
      povinné pole, pokud nezadáte language_name
      Poznámka: je nutné zadat buď language_name, nebo language_code
      seznam dostupných lokalit a jejich language_code získáte odesláním samostatného požadavku na
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      příklad:
      en

    • language_name
      Typ: string

      úplný název jazyka
      povinné pole, pokud nezadáte language_code
      Poznámka: je nutné zadat buď language_name, nebo language_code
      seznam dostupných lokalit a jejich language_name získáte odesláním samostatného požadavku na
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      příklad:
      English

    • location_code
      Typ: integer

      kód lokality
      povinné pole, pokud nezadáte location_name
      Poznámka: je nutné zadat buď location_name, nebo location_code
      seznam dostupných lokalit a jejich location_code získáte odesláním samostatného požadavku na
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      příklad:
      2840

    • location_name
      Typ: string

      úplný název lokality
      povinné pole, pokud nezadáte location_code
      Poznámka: je nutné zadat buď location_name, nebo location_code
      seznam dostupných lokalit a jejich location_name získáte odesláním samostatného požadavku na
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      příklad:
      United Kingdom

    • 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

    • target
      Typ: string

      doména
      povinné pole
      název domény cílového webu
      doménu je nutné zadat bez https:// a www.

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

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

            obsahuje historická rankingová data a data o návštěvnosti

            • metrics
              Typ: object | null

              rankingová data týkající se zadané domény

              • propertyName
                Typ: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
                • clickstream_age_distribution
                  Typ: object | null

                  rozložení metrik založených na clickstreamu podle věku
                  pro získání výsledků tohoto pole musí být parametr include_clickstream_data nastaven na true
                  více o tom, jak se metrika počítá, najdete v tomto článku nápovědy

                  • propertyName
                    Typ: integer | null Formát: int64

                    Signed 64-bit integers (long type).

                • clickstream_etv
                  Typ: number | null Formát: double

                  odhadovaný objem návštěvnosti na základě dat clickstreamu
                  počítá se jako součin hodnot míry prokliku a objemu vyhledávání z clickstreamu všech klíčových slov, na která se doména umisťuje
                  pro získání výsledků tohoto pole musí být parametr include_clickstream_data nastaven na true
                  více o tom, jak se metrika počítá, najdete v tomto článku nápovědy

                • clickstream_gender_distribution
                  Typ: object | null

                  rozložení odhadovaných metrik založených na clickstreamu podle pohlaví
                  pro získání výsledků tohoto pole musí být parametr include_clickstream_data nastaven na true
                  více o tom, jak se metrika počítá, najdete v tomto článku nápovědy

                  • propertyName
                    Typ: integer | null Formát: int64

                    Signed 64-bit integers (long type).

                • count
                  Typ: integer | null Formát: int64

                  celkový počet organických SERP obsahujících doménu nebo subdoménu

                • estimated_paid_traffic_cost
                  Typ: number | null

                  odhadované náklady na převod organické návštěvnosti na placenou
                  představuje odhadované měsíční náklady (USD) na reklamu pro všechna klíčová slova v kategorii, na která se doména nebo subdoména umisťuje
                  metrika se počítá jako součin hodnot organického etv a placeného cpc a udává náklady na přivedení odhadovaného objemu měsíční organické návštěvnosti prostřednictvím reklamy PPC ve Vyhledávání Google
                  více o tom, jak se metrika počítá, najdete v tomto článku nápovědy

                • etv
                  Typ: number | null

                  odhadovaný objem návštěvnosti
                  odhadovaná organická měsíční návštěvnost domény nebo subdomény
                  počítá se jako součin hodnot CTR (míry prokliku) a objemu vyhledávání všech klíčových slov v kategorii, na která se doména nebo subdoména umisťuje
                  více o tom, jak se metrika počítá, najdete v tomto článku nápovědy

                • is_down
                  Typ: integer | null

                  rank klesl
                  udává, kolik rankingových prvků uvedeného cíle kleslo

                • is_lost
                  Typ: integer | null

                  ztracené rankingové prvky
                  udává, kolik rankingových prvků uvedeného cíle bylo dříve zobrazeno v SERP, ale při poslední kontrole nebyly nalezeny

                • is_new
                  Typ: integer | null

                  počet nových rankingových prvků
                  udává, kolik nových rankingových prvků bylo nalezeno pro uvedený cíl

                • is_up
                  Typ: integer | null

                  rank stoupl
                  udává, kolik rankingových prvků uvedeného cíle stouplo

                • pos_1
                  Typ: integer | null

                  počet organických SERP, kde se doména nebo subdoména umisťuje na #1

                • pos_11_20
                  Typ: integer | null

                  počet organických SERP, kde se doména nebo subdoména umisťuje na #11-20

                • pos_2_3
                  Typ: integer | null

                  počet organických SERP, kde se doména nebo subdoména umisťuje na #2-3

                • pos_21_30
                  Typ: integer | null

                  počet organických SERP, kde se doména nebo subdoména umisťuje na #21-30

                • pos_31_40
                  Typ: integer | null

                  počet organických SERP, kde se doména nebo subdoména umisťuje na #31-40

                • pos_4_10
                  Typ: integer | null

                  počet organických SERP, kde se doména nebo subdoména umisťuje na #4-10

                • pos_41_50
                  Typ: integer | null

                  počet organických SERP, kde se doména nebo subdoména umisťuje na #41-50

                • pos_51_60
                  Typ: integer | null

                  počet organických SERP, kde se doména nebo subdoména umisťuje na #51-60

                • pos_61_70
                  Typ: integer | null

                  počet organických SERP, kde se doména nebo subdoména umisťuje na #61-70

                • pos_71_80
                  Typ: integer | null

                  počet organických SERP, kde se doména nebo subdoména umisťuje na #71-80

                • pos_81_90
                  Typ: integer | null

                  počet organických SERP, kde se doména nebo subdoména umisťuje na #81-90

                • pos_91_100
                  Typ: integer | null

                  počet organických SERP, kde se doména nebo subdoména umisťuje na #91-100

            • month
              Typ: integer | null

              měsíc, za který jsou data poskytována

            • se_type
              Typ: string | null

              typ vyhledávače

            • year
              Typ: integer | null

              rok, za který jsou data poskytována

          • items_count
            Typ: integer | null Formát: int64

            počet výsledků vrácených v poli items

          • language_code
            Typ: string | null

            kód jazyka v poli POST

          • location_code
            Typ: integer | null

            kód lokality v poli POST

          • se_type
            Typ: string | null

            typ vyhledávače

          • target
            Typ: string | null

            cílová doména v poli POST

          • total_count
            Typ: integer | null Formát: int64

            celkový počet výsledků v naší databázi relevantních pro váš požadavek

        • 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/dataforseo_labs/google/historical_rank_overview/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/historical_rank_overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "location_code": 2840,
    "language_code": "en",
    "date_from": "2021-01-01",
    "date_to": "2021-03-29"
  }
]'

{
  "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": [
        {
          "se_type": null,
          "target": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "year": null,
              "month": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

Historical Rank Overview