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

Souhrn časové řady nových a ztracených zpětných odkazů

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

Souhrn časové řady nových a ztracených zpětných odkazů

​

Nové a ztracené zpětné odkazy a odkazující domény pro jeden target za jednotlivá období, seskupené podle group_range. Jde o derivaci post_dataforseo_backlinks_timeseries_summary_live: tamten dává úroveň, tento změnu. Plochý součet skrývající silnou obměnu se projeví jen zde. Stejné hodnoty pro mnoho cílů najednou vrací post_dataforseo_backlinks_bulk_new_lost_backlinks_live. Tento endpoint nepřijímá parametr limitu, takže jedinou pákou je volat jej méně často.

Referenční ceny

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

      počáteční datum časového rozsahu
      volitelné pole
      toto pole určuje datum, které se použije jako prahová hodnota pro nové a ztracené zpětné odkazy a odkazující domény;
      zpětné odkazy a odkazující domény, které se v našem indexu objevily po zadaném datu, budou považovány za nové;
      zpětné odkazy a odkazující domény, které po zadaném datu nebyly nalezeny, ale dříve existovaly, budou považovány za ztracené;

      minimální hodnota: 2019-01-30
      maximální hodnota nesmí překročit datum zadané v date_to
      formát data: "yyyy-mm-dd"
      příklad:
      "2021-01-01"

    • date_to
      Typ: string | null

      koncové datum časového rozsahu
      volitelné pole
      pokud toto pole nezadáte, použije se ve výchozím nastavení dnešní datum
      minimální hodnota nesmí předcházet datu zadanému v date_from
      maximální hodnota: dnešní datum
      formát data: "yyyy-mm-dd"
      příklad:
      "2021-01-15"

    • group_range
      Typ: string | null

      časový rozsah, který se použije k seskupení výsledků
      volitelné pole
      výchozí hodnota: month
      možné hodnoty: day, week, month, year

      poznámka: pro day vrátíme položky odpovídající všem datům mezi date_from a date_to včetně;
      pro week/month/year vrátíme položky odpovídající celým týdnům/měsícům/rokům, přičemž každá položka bude označovat poslední den týdne/měsíce/roku

      například pokud zadáte:
      "group_range": "month",
      "date_from": "2022-03-23",
      "date_to": "2022-05-13"
      vrátíme položky spadající mezi 2022-03-01 a 2022-05-31, konkrétně tři položky odpovídající následujícím datům: 2022-03-31, 2022-04-30, 2022-05-31

      pokud pro určitý day/week/month/year nejsou data, vrátíme 0

    • include_subdomains
      Typ: boolean | null

      určuje, zda budou subdomény target zahrnuty do vyhledávání
      volitelné pole
      pokud nastavíte false, subdomény budou ignorovány
      výchozí hodnota: true

    • 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, pro kterou se mají načíst data
      povinné pole
      doménu je nutné zadat bez https:// a www.
      příklad:
      "forbes.com"

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

          • date_from
            Typ: string | null

            počáteční datum časového rozsahu
            ve formátu UTC: „yyyy-mm-dd“
            příklad:
            2019-01-01

          • date_to
            Typ: string | null

            koncové datum časového rozsahu
            ve formátu UTC: "yyyy-mm-dd"
            příklad:
            "2019-01-15"

          • group_range
            Typ: string | null

            group_range z pole POST

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

            obsahuje relevantní data o zpětných odkazech a odkazujících doménách

            • date
              Typ: string | null

              datum a čas, kdy byla data pro cíl uložena
              ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00“
              příklad:
              2019-11-15 12:57:46 +00:00

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

              počet ztracených zpětných odkazů
              počet ztracených zpětných odkazů pro target

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

              počet ztracených odkazujících domén
              počet ztracených odkazujících domén pro target

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

              počet ztracených odkazujících hlavních domén
              počet ztracených odkazujících hlavních domén pro target

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

              počet nových zpětných odkazů
              počet nových zpětných odkazů odkazujících na target

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

              počet nových odkazujících domén
              počet nových odkazujících domén odkazujících na target

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

              počet nových odkazujících hlavních domén
              počet nových odkazujících hlavních domén odkazujících na target

            • type
              Typ: string | null

              typ prvku

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

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

          • target
            Typ: string | null

            target z pole POST

        • 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/backlinks/timeseries_new_lost_summary/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/timeseries_new_lost_summary/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "date_from": "2021-12-01",
    "date_to": "2022-02-01",
    "group_range": "month"
  }
]'

{
  "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": [
        {
          "target": null,
          "date_from": null,
          "date_to": null,
          "group_range": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "date": null,
              "new_backlinks": null,
              "lost_backlinks": null,
              "new_referring_domains": null,
              "lost_referring_domains": null,
              "new_referring_main_domains": null,
              "lost_referring_main_domains": null
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

New & Lost Backlinks Timeseries Summary