DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Zpětné odkazy
Jednotlivé příchozí odkazy na jeden target, jeden řádek na odkaz. Vrací total_count, items_count, items a search_after_token pro stránkování – používejte jej místo offset po prvních několika stránkách. mode a custom_mode řídí seskupování, backlinks_status_type volí živé, ztracené nebo všechny. Pro počty místo řádků použijte post_dataforseo_backlinks_summary_live; pro seskupené odkazující 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.06.
- 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: 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 - customTyp: object | null
_mode typ seskupení podrobných výsledků
volitelné pole
tento objekt použijte k získání určitého počtu zpětných odkazů nafield
pokud použijetecustom_mode, budemodeignorováno
příklad:"custom_mode": {"field": "domain", "value": 100}- propertyTyp: object | null
Name
- 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 - 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:=,<>,in,not_in,like,not_like,ilike,not_ilike,regex,not_regex,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:["rank",">","80"][["page_from_rank",">","55"],
"and",
["dofollow","=",true]][["first_seen",">","2017-10-23 11:31:45 +00:00"],
"and",
[["anchor","like","%seo%"],"or",["text_pre","like","%seo%"]]]Prázdný objekt - 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 - limitTyp: integer | null
maximální počet vrácených zpětných odkazů
volitelné polevýchozí hodnota:
100
maximální hodnota:1000 - modeTyp: string | null
typ seskupení výsledků
volitelné pole
možné typy seskupení:as_is— vrací všechny zpětné odkazyone_per_domain— vrací jeden zpětný odkaz na doménuone_per_anchor— vrací jeden zpětný odkaz na kotvuvýchozí hodnota:
as_is - offsetTyp: integer | null
posun v poli výsledků vrácených zpětných odkazů
volitelné polevýchozí hodnota:
0
pokud zadáte hodnotu10, prvních deset zpětných odkazů v poli výsledků bude vynecháno a data budou vrácena pro následující zpětné odkazy;
Poznámka: maximální hodnota je20,000; pokud chcete přeskočit více výsledků, použijtesearch_after_token - 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:["rank,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:["domain_from_rank,desc","page_from_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
- searchTyp: string | null
_after _token token pro následné požadavky
volitelné pole
vrací se v identickém poli odpovědi na každý požadavek;
tento parametr použijte, abyste se vyhnuli časovým limitům při pokusu o získání více než20,000výsledků v jednom požadavku;
zadáním jedinečné hodnotysearch_after_tokenz pole odpovědi získáte následné výsledky počáteční úlohy;
hodnotysearch_after_tokenjsou jedinečné pro každou následnou úlohu;
Poznámka: pokud je v požadavku zadánsearch_after_token, všechny ostatní parametry musí být shodné s předchozím požadavkem - 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 zpětné odkazy
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_BacklinksBacklinksLiveResponseInfo200
- 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_BacklinksBacklinksLiveTaskInfo
- 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ů
- customTyp: object | null
_mode vlastní režim zadaný v poli POST
- propertyTyp: object | null
Name
- itemsTyp: array (object | null)[] | null
obsahuje relevantní data o zpětných odkazech a odkazujících doménách
- altTyp: string | null
alternativní text obrázku
toto pole budenull, pokudtypezpětného odkazu není obrázek - anchorTyp: string | null
text kotvy zpětného odkazu
- attributesTyp: array (string | null)[] | null
atributy odkazujících odkazů
příklad:nofollow - backlinkTyp: integer | null
_spam _score - dofollowTyp: boolean | null
udává, zda je zpětný odkaz dofollow
pokud jefalse, je zpětný odkaz nofollow - domainTyp: string | null
_from doména odkazující na cílovou doménu nebo webovou stránku
- domainTyp: string | null
_from _country kód země ISO odkazující domény
- domainTyp: string | null
_from _ip IP adresa odkazující domény
- domainTyp: boolean | null
_from _is _ip udává, zda je doména IP
pokud jetrue, doména funguje jako IP adresa a nemá doménové jméno - domainTyp: array (string | null)[] | null
_from _platform _type typy platforem odkazující domény
možné hodnoty:
cms,blogs,ecommerce,message-boards,wikis,news,organization - domainTyp: integer | null
_from _rank - domainTyp: string | null
_to doména, na kterou zpětný odkaz ukazuje
- firstTyp: string | null
_seen datum a čas, kdy náš crawler poprvé našel 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 - groupTyp: integer | null Formát: int64
_count udává celkový počet zpětných odkazů z této domény
například pokud jemodenastaven naone_per_domain, pole udává celkový počet zpětných odkazů přicházejících z této domény - imageTyp: string | null
_url URL obrázku
URL vedoucí k obrázku na původním zdroji nebo v úložišti DataForSEO (pokud původní zdroj není dostupný) - indirectTyp: array (object | null)[] | null
_link _path cesta nepřímého odkazu
udává URL nebo posloupnost URL vedoucích naurl_to- statusTyp: integer | null
_code obecný stavový kód
úplný seznam kódů odpovědí najdete zde
Poznámka: důrazně doporučujeme navrhnout potřebný systém pro zpracování souvisejících výjimek a chybových stavů - typeTyp: string | null
typ prvku
- urlTyp: string | null
URL nepřímého odkazu
- isTyp: boolean | null
_broken udává, zda je zpětný odkaz nefunkční
pokud jetrue, zpětný odkaz ukazuje na stránku odpovídající kódem stavu 4xx nebo 5xx - isTyp: boolean | null
_indirect _link udává, zda je zpětný odkaz nepřímým odkazem
pokud jetrue, zpětný odkaz je nepřímý odkaz ukazující na stránku, která buď přesměrovává naurl_to, nebo ukazuje na kanonickou stránku - isTyp: boolean | null
_lost udává, zda byl zpětný odkaz odstraněn
pokud jetrue, byl odstraněn zpětný odkaz nebo celá stránka - isTyp: boolean | null
_new udává, zda je zpětný odkaz nový
pokud jetrue, zpětný odkaz byl na stránce nalezen při poslední návštěvě našeho crawleru - itemTyp: string | null
_type typ odkazu
možné hodnoty:anchor,image,meta,canonical,alternate,redirect - lastTyp: string | null
_seen nejnovější datum návštěvy našeho crawleru u zpětného odkazu
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00“
příklad:2019-11-15 12:57:46 +00:00 - linksTyp: integer | null Formát: int64
_count počet identických zpětných odkazů nalezených na odkazující stránce
- originalTyp: boolean | null
udává, zda byl zpětný odkaz na odkazující stránce přítomen, když ji náš crawler poprvé navštívil
- pageTyp: string | null
_from _encoding kódování znaků odkazující stránky
příklad:utf-8 - pageTyp: integer | null
_from _external _links počet externích odkazů nalezených na odkazující stránce
- pageTyp: integer | null
_from _internal _links počet interních odkazů nalezených na odkazující stránce
- pageTyp: string | null
_from _language jazyk odkazující stránky
ve formátu ISO 639-1
příklad:en - pageTyp: integer | null
_from _rank - pageTyp: integer | null
_from _size velikost odkazující stránky v bajtech
příklad:63357 - pageTyp: integer | null
_from _status _code kód stavu HTTP vrácený odkazující stránkou
příklad:200 - pageTyp: string | null
_from _title název odkazující stránky
- prevTyp: string | null
_seen datum předcházející nejnovější návštěvě zpětného odkazu naším crawlerem
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
- rankedTyp: object | null · Response36Afe1097B20_RankedKeywordsInfo
_keywords _info - pageTyp: integer | null Formát: int64
_from _keywords _count _top _10 Signed 64-bit integers (long type).
- pageTyp: integer | null Formát: int64
_from _keywords _count _top _100 Signed 64-bit integers (long type).
- pageTyp: integer | null Formát: int64
_from _keywords _count _top _3 Signed 64-bit integers (long type).
- semanticTyp: string | null
_location - textTyp: string | null
_post úryvek po textu kotvy
- textTyp: string | null
_pre úryvek před textem kotvy
- tldTyp: string | null
_from doména nejvyšší úrovně odkazující URL
- typeTyp: string | null
typ prvku
- urlTyp: string | null
_from URL stránky, na které byl zpětný odkaz nalezen
- urlTyp: boolean | null
_from _https udává, zda je odkazující URL zabezpečená protokolem HTTPS
pokud jetrue, odkazující URL je zabezpečená protokolem HTTPS - urlTyp: string | null
_to URL, na kterou zpětný odkaz ukazuje
- urlTyp: boolean | null
_to _https udává, zda je URL, na kterou zpětný odkaz ukazuje, zabezpečená protokolem HTTPS
pokud jetrue, URL je zabezpečená protokolem HTTPS - urlTyp: string | null
_to _redirect _target cílová URL přesměrování
cílová stránka, na kterou přesměrování ukazuje - urlTyp: integer | null
_to _spam _score - urlTyp: integer | null
_to _status _code kód stavu odkazované stránky
pokud je hodnotanull, náš crawler ještě nenavštívil webovou stránku, na kterou odkaz vede
příklad:200
- itemsTyp: integer | null Formát: int64
_count počet výsledků vrácených v poli
items - modeTyp: string | null
režim zadaný v poli POST
- searchTyp: string | null
_after _token token pro následné požadavky
zadáním jedinečnéhosearch_after_tokenpři nastavení nového úkolu získáte následné výsledky původního úkolu;
hodnotysearch_after_tokenjsou jedinečné pro každý následný úkol - targetTyp: string | null
cílová doména v poli POST
- totalTyp: integer | null Formát: int64
_count celkový počet výsledků relevantních k požadavku
- 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/backlinks/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "forbes.com",
"mode": "as_is",
"filters": [
"dofollow",
"=",
true
],
"limit": 5
}
]'
{
"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,
"mode": null,
"custom_mode": null,
"total_count": null,
"items_count": null,
"items": [
{
"type": null,
"domain_from": null,
"url_from": null,
"url_from_https": null,
"domain_to": null,
"url_to": null,
"url_to_https": null,
"tld_from": null,
"is_new": null,
"is_lost": null,
"backlink_spam_score": null,
"rank": null,
"page_from_rank": null,
"domain_from_rank": null,
"domain_from_platform_type": [
"[Max Depth Exceeded]"
],
"domain_from_is_ip": null,
"domain_from_ip": null,
"domain_from_country": null,
"page_from_external_links": null,
"page_from_internal_links": null,
"page_from_size": null,
"page_from_encoding": null,
"page_from_language": null,
"page_from_title": null,
"page_from_status_code": null,
"first_seen": null,
"prev_seen": null,
"last_seen": null,
"item_type": null,
"attributes": [
"[Max Depth Exceeded]"
],
"dofollow": null,
"original": null,
"alt": null,
"image_url": null,
"anchor": null,
"text_pre": null,
"text_post": null,
"semantic_location": null,
"links_count": null,
"group_count": null,
"is_broken": null,
"url_to_status_code": null,
"url_to_spam_score": null,
"url_to_redirect_target": null,
"ranked_keywords_info": "[Max Depth Exceeded]",
"is_indirect_link": null,
"indirect_link_path": [
"[Max Depth Exceeded]"
]
}
],
"search_after_token": null
}
]
}
]
}