DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Souhrn zpětných odkazů
Celý profil zpětných odkazů jednoho target v jediném volání: first_seen, lost_date, rank, backlinks, backlinks_spam_score, crawled_pages, internal_links_count a blok info, vedle toho počty odkazujících domén a kotev. Toto je centrum rodiny – začněte zde a pak se ponořte do příslušné části: post_dataforseo_backlinks_backlinks_live pro jednotlivé odkazy, post_dataforseo_backlinks_referring_domains_live pro to, kdo odkazuje, post_dataforseo_backlinks_anchors_live pro použitý text. 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.024.
- 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)[]
- backlinksTyp: array (object | null)[] | null
_filters filtrujte zpětné odkazy vašeho
target
volitelné pole
pomocí tohoto pole můžete filtrovat počáteční zpětné odkazy, které budou zahrnuty do datové sady pro agregované metriky vašehotarget
zpětné odkazy můžete filtrovat podle všech polí dostupných v odpovědi tohoto endpointu
pomocí tohoto parametru můžete do odpovědi zahrnout pouze zpětné odkazy dofollow a vytvořit flexibilní datovou sadu zpětných odkazů pro výpočet metrik
příklad:"backlinks_filters": ["dofollow", "=", true]Prázdný objekt - backlinksTyp: string | null
_status _type určuje, které zpětné odkazy vrátit a započítat
volitelné pole
pomocí tohoto pole můžete vybrat, které zpětné odkazy budou vráceny a použity pro agregované metriky vašehotarget;
možné hodnoty:all— budou vráceny a započítány všechny zpětné odkazy;live— budou vráceny a započítány zpětné odkazy nalezené při poslední kontrole;lost— budou vráceny a započítány ztracené zpětné odkazy;výchozí hodnota:
live - excludeTyp: boolean | null
_internal _backlinks určuje, zda budou z výsledků vyloučeny interní zpětné odkazy ze subdomén na
target
volitelné pole
pokud nastavítetrue, výsledky nebudou obsahovat data o interních zpětných odkazech ze subdomén stejné domény jakotarget
pokud nastavítefalse, interní odkazy budou do výsledků zahrnuty
výchozí hodnota:true - includeTyp: boolean | null
_indirect _links určuje, zda budou do výsledků zahrnuty nepřímé odkazy na
target
volitelné pole
pokud nastavítetrue, výsledky budou obsahovat data o nepřímých odkazech směřujících na stránku, která buď přesměrovává na target, nebo odkazuje na kanonickou stránku
pokud nastavítefalse, nepřímé odkazy budou ignorovány
výchozí hodnota:true - includeTyp: boolean | null
_subdomains určuje, zda budou subdomény
targetzahrnuty do vyhledávání
volitelné pole
pokud nastavítefalse, subdomény budou ignorovány
výchozí hodnota:true - internalTyp: integer | null
_list _limit maximální počet prvků ve vnitřních polích
volitelné pole
toto pole můžete použít k omezení počtu prvků v následujících polích:referring_links_tldreferring_links_typesreferring_links_attributesreferring_links_platform_typesreferring_links_semantic_locationsvýchozí hodnota:
10
maximální hodnota:1000 - 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, subdoména nebo webová stránka, pro kterou se mají načíst data
povinné pole
doménu nebo subdoménu je nutné zadat bezhttps://awww.
stránku je nutné zadat jako absolutní URL (včetněhttp://nebohttps://)
- Typ: object | null · Response36Afe1097B20_BacklinksSummaryLiveResponseInfo200
- 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_BacklinksSummaryLiveTaskInfo
- 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ů
- backlinksTyp: integer | null Formát: int64
udává počet zpětných odkazů
- backlinksTyp: integer | null Formát: int64
_spam _score - 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 natarget, které odpovídají kódy stavu 4xx nebo 5xxmějte na paměti, že počet nefunkčních stránek zahrnuje stránky na
targetobjevené sledováním externích odkazů, ale může zahrnovat i stránky objevené sledováním mapy stránek cíle - crawledTyp: integer | null
_pages počet procházených stránek pro
target - 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 - firstTyp: string | null
_seen datum a čas, kdy náš crawler poprvé našel zpětný odkaz pro
target
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00“
příklad:2019-11-15 12:57:46 +00:00 - 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: string | null
_date datum a čas, kdy byl zpětný odkaz ztracen
udává datum a čas, kdy náš crawler navštívil cíl a ten odpověděl kódem stavu 4xx nebo 5xx, nebo kdy byl odstraněn jeho poslední zpětný odkaz
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00“
příklad:2019-11-15 12:57:46 +00:00 - rankTyp: integer | null
- referringTyp: integer | null Formát: int64
_domains udává 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
příklady hodnot:nofollow,noopener,noreferrer,external,ugc,sponsored- 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 udává 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 udává počet stránek odkazujících na cíl
- 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í
- targetTyp: string | null
targetv poli 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/summary/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "explodingtopics.com",
"internal_list_limit": 10,
"include_subdomains": true,
"backlinks_filters": [
"dofollow",
"=",
true
],
"backlinks_status_type": "all"
}
]'
{
"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,
"first_seen": null,
"lost_date": null,
"rank": null,
"backlinks": null,
"backlinks_spam_score": null,
"crawled_pages": null,
"info": {
"server": null,
"cms": null,
"platform_type": [
"[Max Depth Exceeded]"
],
"ip_address": null,
"country": null,
"is_ip": null,
"target_spam_score": null
},
"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
}
]
}
]
}