DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Kotvy
Texty odkazů (kotvy) mířící na jeden target, jeden řádek pro každou odlišnou kotvu s anchor, rank, backlinks, first_seen, lost_date, backlinks_spam_score, broken_backlinks a broken_pages. Ukazuje, jak web o dané stránce mluví – přeoptimalizované kotvy se projeví právě zde. Zobrazení na úrovni odkazů je post_dataforseo_backlinks_backlinks_live; na úrovni domény post_dataforseo_backlinks_referring_domains_live.
Referenční ceny
- Účtování: vykázaná cena odpovědi.
- Referenční odhad ceny požadavku: USD 0.033.
- 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 jsou zpětné odkazy ze subdomén
targetvyloučeny
volitelné pole
pokud nastavítefalse, zpětné odkazy ze subdoméntargetbudou vynechány a v odpovědi nedostanete stejnou doménu;
výchozí hodnota:true - filtersTyp: array (object | null)[] | null
pole parametrů filtrování výsledků
volitelné pole
můžete přidat několik filtrů najednou (maximálně 8)
mezi podmínkami je nutné nastavit logický operátorand,or
podporované operátory:regex,not_regex,=,<>,in,not_in,like,not_like,ilike,not_ilike,match,not_match
operátor%můžete použít slikeanot_likepro shodu s libovolným řetězcem o nule nebo více znacích
příklad:["referring_links_types.anchors",">","1"][["broken_pages",">","2"],
"and",
["backlinks",">","10"]][["first_seen",">","2017-10-23 11:31:45 +00:00"],
"and",
[["anchor","like","%seo%"],"or",["referring_domains",">","10"]]]Úplný seznam možných filtrů je k dispozici zde.
Prázdný objekt - 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 - limitTyp: integer | null
maximální počet vrácených kotev
volitelné pole
výchozí hodnota:100
maximální hodnota:1000 - offsetTyp: integer | null
posun v poli výsledků vrácených kotev
volitelné pole
výchozí hodnota:0
pokud zadáte hodnotu10, prvních deset kotev v poli výsledků bude vynecháno a data budou vrácena pro následující kotvy - orderTyp: array string[] | null
_by pravidla řazení výsledků
volitelné pole
k řazení výsledků můžete použít stejné hodnoty jako v polifilters
možné typy řazení:asc— výsledky budou seřazeny vzestupnědesc— výsledky budou seřazeny sestupně
typ řazení se nastavuje čárkou
příklad:["backlinks,desc"]
pamatujte, že v jednom požadavku lze nastavit nejvýše tři pravidla řazení
několik pravidel řazení je nutné oddělit čárkou
příklad:["backlinks,desc","rank,asc"] - 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 kotvy
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_BacklinksAnchorsLiveResponseInfo200
- 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_BacklinksAnchorsLiveTaskInfo
- 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ů
- itemsTyp: array (object | null)[] | null
pole položek
- anchorTyp: string | null
kotva zpětného odkazu
- 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, na které ukazují zpětné odkazy a které odpovídají kódy stavu 4xx nebo 5xx - firstTyp: string | null
_seen datum a čas, kdy náš crawler poprvé našel zpětný odkaz s touto kotvou
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00“
příklad:2019-11-15 12:57:46 +00:00 - lostTyp: string | null
_date datum a čas, kdy byl ztracen poslední zpětný odkaz s touto kotvou
udává datum a čas, kdy náš crawler navštívil stránku a ta odpověděla kódem stavu 4xx nebo 5xx, nebo kdy byl odstraněn poslední zpětný odkaz
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00“
příklad:2017-01-24 13:20:59 +00:00 - rankTyp: integer | null
- referringTyp: integer | null Formát: int64
_domains udává počet odkazujících domén
- 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 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
targets touto kotvou - referringTyp: integer | null Formát: int64
_pages _nofollow počet odkazujících stránek, které na
targetukazují alespoň jeden odkaz nofollow s touto kotvou - 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 položek v poli výsledků
- targetTyp: string | null
cíl v poli POST
- totalTyp: integer | null Formát: int64
_count celkový počet relevantních položek v databázi
- 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/anchors/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "forbes.com",
"limit": 4,
"order_by": [
"backlinks,desc"
],
"filters": [
"anchor",
"like",
"%news%"
]
}
]'
{
"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,
"total_count": null,
"items_count": null,
"items": [
{
"type": null,
"anchor": null,
"rank": null,
"backlinks": null,
"first_seen": null,
"lost_date": null,
"backlinks_spam_score": 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
}
]
}
]
}
]
}