DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Historie zpětných odkazů
Profil zpětných odkazů jednoho target v každém datu rozsahu, s date_from, date_to a jednou položkou na bod. Pouze pro aktuální profil použijte post_dataforseo_backlinks_summary_live. Lehčí časová řada post_dataforseo_backlinks_timeseries_summary_live uvádí méně metryk na bod. 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.0271.
- 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.
- Typ: array (object | null)[]
- dateTyp: string | null
_from počáteční datum časového rozsahu
volitelné pole
minimální hodnota2019-01-01
pokud toto pole nezadáte, použije se ve výchozím nastavení minimální hodnota
formát data:"yyyy-mm-dd"
příklad:"2019-01-15" - dateTyp: string | null
_to 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:"2019-01-15" - rankTyp: string | null
_scale určuje škálu používanou pro výpočet a zobrazení hodnot
rank,domain_from_rankapage_from_rank
volitelné poletento 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–100one_thousand— hodnoty rank se zobrazují na škále 0–1000výchozí hodnota:
one_thousandvíce o fungování tohoto parametru a výpočtu metrik hodnocení najdete v tomto článku nápovědy
- tagTyp: 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 hodnotutagnajdete v objektudataodpovědi - targetTyp: string
doména
povinné pole
doménu je nutné zadat bezhttps://awww.
- Typ: object | null · Response36Afe1097B20_BacklinksHistoryLiveResponseInfo200
- Typ: number | null Formát: doublecost
celkové náklady na úlohy, USD
- Typ: integer | nullstatus
_code obecný kód stavu úplný seznam kódů odpovědí najdete zde
- Typ: string | nullstatus
_message obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde
- Typ: array (object | null)[] | nulltasks
pole úloh
- Typ: object | null · Response36Afe1097B20_BacklinksHistoryLiveTaskInfo
- costTyp: number | null Formát: double
celkové náklady na úlohy, USD
- dataTyp: object | null
obsahuje stejné parametry, které jste zadali v požadavku POST
- propertyTyp: object | null
Name
- idTyp: string | null
identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID
- pathTyp: array (string | null)[] | null
cesta URL
- resultTyp: array (object | null)[] | null
pole výsledků
- dateTyp: string | null
_from počáteční datum časového rozsahu
ve formátu UTC: „yyyy-mm-dd“
příklad:2019-01-01 - dateTyp: string | null
_to koncové datum časového rozsahu
ve formátu UTC:"yyyy-mm-dd"
příklad:"2019-01-15" - itemsTyp: array (object | null)[] | null
obsahuje historická data o zpětných odkazech pro zadanou doménu
data jsou poskytována měsíc po měsíci;
metriky jsou agregovány podle zpětných odkazů, které zadaná doména měla první den každého daného měsíce- backlinksTyp: integer | null Formát: int64
počet zpětných odkazů
- brokenTyp: integer | null Formát: int64
_backlinks počet nefunkčních zpětných odkazů
počet nefunkčních zpětných odkazů odkazujících natarget - brokenTyp: integer | null
_pages počet nefunkčních stránek
počet stránek, které přijímají zpětné odkazy, ale odpovídají kódy stavu 4xx nebo 5xx - crawledTyp: integer | null
_pages počet procházených stránek pro
target - dateTyp: 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 - externalTyp: integer | null Formát: int64
_links _count počet externích odkazů na stránce
počítá se jako součet externích odkazů na stránkách zadanéhotarget - infoTyp: object | null · Response36Afe1097B20_TargetInfo
informace o
target- cmsTyp: string | null
systém pro správu obsahu
- countryTyp: string | null
kód země, do které podle určení patří doména
target - ipTyp: string | null
_address IP adresa
target - isTyp: boolean | null
_ip označuje, zda je
targetIP
pokud jetrue, doména, subdoména nebo webová stránka funguje jako IP adresa a nemá název domény - platformTyp: array (string | null)[] | null
_type typ platformy
- serverTyp: string | null
server
- targetTyp: integer | null
_spam _score
- internalTyp: integer | null Formát: int64
_links _count počet interních odkazů
počítá se jako součet interních odkazů na stránkách zadanéhotarget - lostTyp: integer | null Formát: int64
_backlinks počet ztracených zpětných odkazů pro
target
data jsou poskytována na základě srovnání s předchozím obdobím
Poznámka: tato data jsou k dispozici od května 2021;
pokud rozsah dat zadaný v požadavku POST předchází květnu 2021, bude pole rovno0 - lostTyp: integer | null Formát: int64
_referring _domains počet ztracených odkazujících domén pro
target
data jsou poskytována na základě srovnání s předchozím obdobím
Poznámka: tato data jsou k dispozici od května 2021;
pokud rozsah dat zadaný v požadavku POST předchází květnu 2021, bude pole rovno0 - newTyp: integer | null Formát: int64
_backlinks počet nových zpětných odkazů pro
target
data jsou poskytována na základě srovnání s předchozím obdobím
Poznámka: tato data jsou k dispozici od května 2021;
pokud rozsah dat zadaný v požadavku POST předchází květnu 2021, bude pole rovno0 - newTyp: integer | null Formát: int64
_referring _domains počet nových odkazujících domén pro
target
data jsou poskytována na základě srovnání s předchozím obdobím
Poznámka: tato data jsou k dispozici od května 2021;
pokud rozsah dat zadaný v požadavku POST předchází květnu 2021, bude pole rovno0 - rankTyp: integer | null
- referringTyp: integer | null Formát: int64
_domains počet odkazujících domén
odkazující domény zahrnují subdomény, které se pro tuto metriku počítají jako samostatné domény - referringTyp: integer | null Formát: int64
_domains _nofollow počet domén ukazujících alespoň jeden odkaz nofollow na
target - referringTyp: integer | null Formát: int64
_ips počet odkazujících IP adres
počet IP adres odkazujících na tuto stránku - referringTyp: object | null
_links _attributes atributy odkazujících odkazů
udává atributy odkazujících odkazů a počet odkazů pro každý atribut- propertyTyp: integer | null Formát: int64
Name Signed 64-bit integers (long type).
- referringTyp: object | null
_links _countries kódy zemí ISO odkazujících odkazů
udává kódy zemí ISO domén, v nichž se odkazující odkazy nacházejí, a počet odkazů pro každou zemi- propertyTyp: integer | null Formát: int64
Name Signed 64-bit integers (long type).
- referringTyp: object | null
_links _platform _types typy odkazujících platforem
udává typy odkazujících platforem a počet odkazů pro každou platformumožné hodnoty:
cms,blogs,ecommerce,message-boards,wikis,news,organization- propertyTyp: integer | null Formát: int64
Name Signed 64-bit integers (long type).
- referringTyp: object | null
_links _semantic _locations - propertyTyp: integer | null Formát: int64
Name Signed 64-bit integers (long type).
- referringTyp: object | null
_links _tld domény nejvyšší úrovně odkazujících odkazů
obsahuje domény nejvyšší úrovně a počet odkazujících odkazů pro každou z nich- propertyTyp: integer | null Formát: int64
Name Signed 64-bit integers (long type).
- referringTyp: object | null
_links _types typy odkazujících odkazů
udává typy odkazujících odkazů a počet odkazů pro každý typ
možné hodnoty:anchor,image,link,meta,canonical,alternate,redirect- propertyTyp: integer | null Formát: int64
Name Signed 64-bit integers (long type).
- referringTyp: integer | null Formát: int64
_main _domains počet odkazujících hlavních domén
- referringTyp: integer | null Formát: int64
_main _domains _nofollow počet hlavních domén ukazujících alespoň jeden odkaz nofollow na
target - referringTyp: integer | null Formát: int64
_pages počet stránek odkazujících na
target - referringTyp: integer | null Formát: int64
_pages _nofollow počet odkazujících stránek, které na
targetukazují alespoň jeden odkaz nofollow - referringTyp: integer | null Formát: int64
_subnets počet odkazujících podsítí
- typeTyp: string | null
typ prvku
- itemsTyp: integer | null Formát: int64
_count počet výsledků vrácených v poli
items - targetTyp: string | null
targetz pole POST
- resultTyp: integer | null Formát: int64
_count počet prvků v poli result
- statusTyp: integer | null
_code 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
- statusTyp: string | null
_message informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde
- timeTyp: string | null
doba provedení, sekundy
- Typ: integer | null Formát: int64tasks
_count počet úloh v poli tasks
- Typ: integer | null Formát: int64tasks
_error počet úloh v poli tasks vrácených s chybou
- Typ: string | nulltime
celková doba provádění, sekundy
- Typ: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/history/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "cnn.com",
"date_from": "2020-01-01",
"date_to": "2021-01-01"
}
]'
{
"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,
"items_count": null,
"items": [
{
"type": null,
"date": null,
"rank": null,
"backlinks": null,
"new_backlinks": null,
"lost_backlinks": null,
"new_referring_domains": null,
"lost_referring_domains": null,
"crawled_pages": null,
"info": "[Max Depth Exceeded]",
"internal_links_count": null,
"external_links_count": null,
"broken_backlinks": null,
"broken_pages": null,
"referring_domains": null,
"referring_domains_nofollow": null,
"referring_main_domains": null,
"referring_main_domains_nofollow": null,
"referring_ips": null,
"referring_subnets": null,
"referring_pages": null,
"referring_pages_nofollow": null,
"referring_links_tld": null,
"referring_links_types": null,
"referring_links_attributes": null,
"referring_links_platform_types": null,
"referring_links_semantic_locations": null,
"referring_links_countries": null
}
]
}
]
}
]
}