v0.2.0-beta

OpenAPI 3.1.0

Průnik stránek

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/page_intersection/live

Průnik stránek

Stránky odkazující na několik cílových URL najednou, nikoli domény. ⚠️ targets je objekt klíčovaný pozicí a přijímá plné URL, nikoli holé domény. Každý řádek nese page_intersection a summary pro každý cíl. Ekvivalent na úrovni domén je post_dataforseo_backlinks_domain_intersection_live, po kterém je vhodné sáhnout nejdříve.

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.

Tělo

application/json

Typ: array (object | null)[]
- backlinks_status_type
 Typ: string | null
 
 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šich targets;
 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
- exclude_internal_backlinks
 Typ: boolean | null
 
 určuje, zda budou z výsledků vyloučeny interní zpětné odkazy ze subdomén na target
 volitelné pole
 pokud nastavíte true, výsledky nebudou obsahovat data o interních zpětných odkazech ze subdomén stejné domény jako target
 pokud nastavíte false, interní odkazy budou do výsledku zahrnuty
 výchozí hodnota: true
- exclude_targets
 Typ: array string[] | null
 
 domény, subdomény nebo webové stránky, které chcete vyloučit
 volitelné pole
 můžete zadat až 10 domén, subdomén nebo webových stránek
 pokud toto pole použijete, výsledky budou obsahovat odkazující stránky, které odkazují na targets, ale neodkazují na exclude_targets
 příklad:
 "exclude_targets": [ "bbc.com", "https://www.apple.com/iphone/*", "https://dataforseo.com/apis/*"]
- filters
 Typ: 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átor and, 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 s like a not_like pro shodu s libovolným řetězcem o nule nebo více znacích
 příklad:
 ["1.rank",">","80"]
 
 [["2.page_from_rank",">","55"], "and", ["1.original","=","true"]]
 
 [["1.first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["1.acnhor","like","%seo%"],"or",["1.text_pre","not_like","%seo%"]]]
 
 Úplný seznam možných filtrů je k dispozici zde.
 
 Prázdný objekt
- include_indirect_links
 Typ: boolean | null
 
 určuje, zda budou do výsledků zahrnuty nepřímé odkazy na targets
 volitelné pole
 pokud nastavíte true, výsledky budou obsahovat data o nepřímých odkazech směřujících na stránku, která buď přesměrovává na cíl, nebo odkazuje na kanonickou stránku
 pokud nastavíte false, nepřímé odkazy budou ignorovány
 výchozí hodnota: true
- include_subdomains
 Typ: boolean | null
 
 určuje, zda budou subdomény targets zahrnuty do vyhledávání
 volitelné pole
 pokud nastavíte false, subdomény budou ignorovány
 výchozí hodnota: true
- internal_list_limit
 Typ: integer | null
 
 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:
 attributes
 domain_from_platform_type
 
 výchozí hodnota: 10
 maximální hodnota: 1000
- intersection_mode
 Typ: string | null
 
 určuje, zda se mají zpětné odkazy protínat
 volitelné pole
 toto pole použijte k protnutí nebo sloučení výsledků pro zadané URL
 možné hodnoty: all, partial
 all — výsledky vycházejí ze všech zpětných odkazů;
 partial — výsledky vycházejí pouze z protínajících se zpětných odkazů;
 výchozí hodnota: all
- limit
 Typ: integer | null
 
 maximální počet vrácených zpětných odkazů
 volitelné pole
 
 výchozí hodnota: 100
 maximální hodnota: 1000
- offset
 Typ: integer | null
 
 posun v poli výsledků vrácených zpětných odkazů
 volitelné pole
 
 výchozí hodnota: 0
 pokud zadáte hodnotu 10, 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
- order_by
 Typ: array string[] | null
 
 pravidla řazení výsledků
 volitelné pole
 k řazení výsledků můžete použít stejné hodnoty jako v poli filters
 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"]
- 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
- targets
 Typ: object | null
 
 domény, subdomény nebo webové stránky, pro které se mají načíst odkazy
 povinné pole
 můžete zadat až 20 domén, subdomén nebo webových stránek
 doménu nebo subdoménu je nutné zadat bez https:// a www.
 stránku je nutné zadat jako absolutní URL (včetně http:// nebo https://)
 příklad:
 "targets": { "1": "http://planet.postgresql.org/", "2": "http://gborg.postgresql.org/" }
 
 propertyName
 Typ: string | null

Odpovědi

200
Typ: object | null · Response36Afe1097B20_BacklinksPageIntersectionLiveResponseInfo
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_BacklinksPageIntersectionLiveTaskInfo
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ů

items
Typ: array (object | null)[] | null

obsahuje relevantní data o zpětných odkazech a odkazujících doménách

page_intersection
Typ: object | null

obsahuje data o stránkách, které odkazují na odpovídající cíle zadané v poli POST
data jsou poskytována v samostatných objektech odpovídajících stránkám zadaným v objektu targets

propertyName
Typ: array (object | null)[] | null
alt
Typ: string | null

alternativní text obrázku
toto pole bude null, pokud type zpětného odkazu není obrázek

anchor
Typ: string | null

text kotvy zpětného odkazu

attributes
Typ: array (string | null)[] | null

atributy odkazujících odkazů
příklad:
nofollow

backlink_spam_score
Typ: integer | null

skóre spamu zpětného odkazu
více o tom, jak se metrika počítá, najdete na této stránce nápovědy

dofollow
Typ: boolean | null

udává, zda je zpětný odkaz dofollow
pokud je false, je zpětný odkaz nofollow

domain_from
Typ: string | null

doména odkazující na cílovou doménu nebo webovou stránku

domain_from_country
Typ: string | null

kód země ISO odkazující domény

domain_from_ip
Typ: string | null

IP adresa odkazující domény

domain_from_is_ip
Typ: boolean | null

udává, zda je doména IP
pokud je true, doména funguje jako IP adresa a nemá doménové jméno

domain_from_platform_type
Typ: array (string | null)[] | null

typy platforem odkazující domény

možné hodnoty: cms, blogs, ecommerce, message-boards, wikis, news, organization

domain_from_rank
Typ: integer | null

rank odkazující domény
udává rank domény v době, kdy náš crawler naposledy viděl zpětný odkaz;
domain_from_rank se počítá metodou hodnocení uzlů v propojené databázi – principem použitým v původním algoritmu Google PageRank
více o metrice a jejím výpočtu najdete v tomto článku nápovědy

domain_to
Typ: string | null

doména, na kterou zpětný odkaz ukazuje

first_seen
Typ: string | null

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

group_count
Typ: integer | null Formát: int64

udává celkový počet zpětných odkazů z této domény
například pokud je mode nastaven na one_per_domain, pole udává celkový počet zpětných odkazů přicházejících z této domény

indirect_link_path
Typ: array (object | null)[] | null

cesta nepřímého odkazu
udává URL nebo posloupnost URL vedoucích na url_to

status_code
Typ: integer | null

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ů

type
Typ: string | null

typ prvku

url
Typ: string | null

URL nepřímého odkazu

is_broken
Typ: boolean | null

udává, zda je zpětný odkaz nefunkční
pokud je true, zpětný odkaz ukazuje na stránku odpovídající kódem stavu 4xx nebo 5xx

is_indirect_link
Typ: boolean | null

udává, zda je zpětný odkaz nepřímým odkazem
pokud je true, zpětný odkaz je nepřímý odkaz ukazující na stránku, která buď přesměrovává na url_to, nebo ukazuje na kanonickou stránku

is_lost
Typ: boolean | null

udává, zda byl zpětný odkaz odstraněn
pokud je true, byl odstraněn zpětný odkaz nebo celá stránka

is_new
Typ: boolean | null

udává, zda je zpětný odkaz nový
pokud je true, zpětný odkaz byl na stránce nalezen při poslední návštěvě našeho crawleru

item_type
Typ: string | null

typ odkazu
možné hodnoty:
anchor, image, link, meta, canonical, alternate, redirect

last_seen
Typ: string | null

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

links_count
Typ: integer | null Formát: int64

počet identických zpětných odkazů nalezených na odkazující stránce

original
Typ: boolean | null

udává, zda byl zpětný odkaz na odkazující stránce přítomen, když ji náš crawler poprvé navštívil

page_from_encoding
Typ: string | null

kódování znaků odkazující stránky
příklad:
utf-8

page_from_external_links
Typ: integer | null

počet externích odkazů nalezených na odkazující stránce

page_from_internal_links
Typ: integer | null

počet interních odkazů nalezených na odkazující stránce

page_from_language
Typ: string | null

jazyk odkazující stránky
ve formátu ISO 639-1
příklad:
en

page_from_rank
Typ: integer | null

rank odkazující stránky
page_from_rank se počítá metodou hodnocení uzlů v propojené databázi – principem použitým v původním algoritmu Google PageRank
více o metrice a jejím výpočtu najdete v tomto článku nápovědy

page_from_size
Typ: integer | null

velikost odkazující stránky v bajtech
příklad:
63357

page_from_status_code
Typ: integer | null

kód stavu HTTP vrácený odkazující stránkou
příklad:
200

page_from_title
Typ: string | null

název odkazující stránky

prev_seen
Typ: string | null

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

rank
Typ: integer | null

rank zpětného odkazu
rank se počítá metodou hodnocení uzlů v propojené databázi – principem použitým v původním algoritmu Google PageRank
více o metrice a jejím výpočtu najdete v tomto článku nápovědy

semantic_location
Typ: string | null

udává sémantický prvek v HTML, ve kterém byl zpětný odkaz nalezen
úplný seznam sémantických prvků najdete zde
příklady:
article, section, summary

text_post
Typ: string | null

úryvek po textu kotvy

text_pre
Typ: string | null

textový úryvek před textem kotvy

tld_from
Typ: string | null

doména nejvyšší úrovně odkazující URL

type
Typ: string | null

typ prvku

url_from
Typ: string | null

URL stránky, na které byl zpětný odkaz nalezen

url_from_https
Typ: boolean | null

udává, zda je odkazující URL zabezpečená protokolem HTTPS
pokud je true, odkazující URL je zabezpečená protokolem HTTPS

url_to
Typ: string | null

URL, na kterou zpětný odkaz ukazuje

url_to_https
Typ: boolean | null

udává, zda je URL, na kterou zpětný odkaz ukazuje, zabezpečená protokolem HTTPS
pokud je true, URL je zabezpečená protokolem HTTPS

url_to_redirect_target
Typ: string | null

cílová URL přesměrování
cílová stránka, na kterou přesměrování ukazuje

url_to_spam_score
Typ: integer | null

skóre spamu odkazované stránky
pokud je hodnota null, náš crawler ještě nenavštívil webovou stránku, na kterou odkaz vede
více o tom, jak se metrika počítá, najdete na této stránce nápovědy

url_to_status_code
Typ: integer | null

kód stavu odkazované stránky
pokud je hodnota null, náš crawler ještě nenavštívil webovou stránku, na kterou odkaz vede
příklad:
200

summary
Typ: object | null · Response36Afe1097B20_IntersectionSummaryInfo

obsahuje souhrn průniků stránek

intersections_count
Typ: integer | null Formát: int64

celkový počet průniků

items_count
Typ: integer | null Formát: int64

počet výsledků vrácených v poli items

targets
Typ: object | null

targets z pole POST

propertyName
Typ: string | null
total_count
Typ: integer | null Formát: int64

celkový počet výsledků relevantních k požadavku

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/page_intersection/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/page_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": {
      "1": "football.com",
      "2": "fifa.com"
    },
    "exclude_targets": [
      "skysports.com"
    ],
    "limit": 5,
    "order_by": [
      "1.rank,desc"
    ],
    "filters": [
      [
        "2.domain_from_rank",
        ">",
        400
      ],
      "and",
      [
        "1.dofollow",
        "=",
        true
      ]
    ]
  }
]'

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": [
        {
          "targets": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "page_intersection": null,
              "summary": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

Průnik stránek

OvěřováníRequired

DataForSEO

Průnik stránek

Referenční ceny