v0.2.0-beta

OpenAPI 3.1.0

Souhrn časové řady 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

post/v1/beta/dataforseo/backlinks/timeseries_summary/live

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

Základní metryky zpětných odkazů jednoho target v čase, seskupené podle group_range (den, týden, měsíc). Vrací date_from, date_to, group_range a jednu položku na období. Pro přírůstky a úbytky místo součtů použijte post_dataforseo_backlinks_timeseries_new_lost_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.0273.
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 souhrnná data;
  
  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
- rank_scale
  Typ: string | null
  
  určuje škálu používanou pro výpočet a zobrazení hodnot rank, domain_from_rank a page_from_rank
  volitelné pole
  
  tento parametr můžete použít k volbě, zda se hodnoty rank zobrazují na škále 0–100, nebo 0–1000
  
  možné hodnoty:
  one_hundred — hodnoty rank se zobrazují na škále 0–100
  one_thousand — hodnoty rank se zobrazují na škále 0–1000
  
  výchozí hodnota: one_thousand
  
  více o fungování tohoto parametru a výpočtu metrik hodnocení najdete v tomto článku nápovědy
- 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_BacklinksTimeseriesSummaryLiveResponseInfo
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_BacklinksTimeseriesSummaryLiveTaskInfo
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í souhrnná data

backlinks
Typ: integer | null Formát: int64

počet zpětných odkazů k danému date

backlinks_nofollow
Typ: integer | null Formát: int64

počet zpětných odkazů nofollow k danému date

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

rank
Typ: integer | null

rank target k danému date
více o metrice a jejím výpočtu najdete v tomto článku nápovědy

referring_domains
Typ: integer | null Formát: int64

počet odkazujících domén k danému date
odkazující domény zahrnují subdomény, které se pro tuto metriku počítají jako samostatné domény

referring_domains_nofollow
Typ: integer | null Formát: int64

počet domén ukazujících alespoň jeden odkaz nofollow na target k danému date

referring_ips
Typ: integer | null Formát: int64

počet odkazujících IP adres k danému date
počet IP adres odkazujících na tuto stránku

referring_main_domains
Typ: integer | null Formát: int64

počet odkazujících hlavních domén k danému date

referring_main_domains_nofollow
Typ: integer | null Formát: int64

počet hlavních domén ukazujících alespoň jeden odkaz nofollow na target k danému date

referring_pages
Typ: integer | null Formát: int64

počet stránek odkazujících na target k danému date

referring_pages_nofollow
Typ: integer | null Formát: int64

počet odkazujících stránek, které na target ukazují alespoň jeden odkaz nofollow k danému date

referring_subnets
Typ: integer | null Formát: int64

počet odkazujících podsítí k danému date

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

post/v1/beta/dataforseo/backlinks/timeseries_summary/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/timeseries_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"
  }
]'

Zobrazit schéma

{
  "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,
              "rank": null,
              "backlinks": null,
              "backlinks_nofollow": null,
              "referring_pages": null,
              "referring_pages_nofollow": null,
              "referring_domains": null,
              "referring_domains_nofollow": null,
              "referring_main_domains": null,
              "referring_main_domains_nofollow": null,
              "referring_ips": null,
              "referring_subnets": null
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

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

OvěřováníRequired

DataForSEO

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

Referenční ceny