v0.2.0-beta

OpenAPI 3.1.0

Stránky domény

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

Stránky domény

Stránky jednoho target, na které vedou příchozí odkazy, s pohledem crawleru na každou z nich: main_domain, domain, tld, page, ip, first_visited, prev_visited a fetch_time. Pomáhá zjistit, které stránky skutečně získávají odkazy. Pro počty zpětných odkazů na stránku místo metadat o procházení použijte post_dataforseo_backlinks_domain_pages_summary_live.

Referenční ceny

Účtování: vykázaná cena odpovědi.
Referenční odhad ceny požadavku: USD 0.0276.
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_filters
  Typ: array (object | null)[] | null
  
  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šeho target
  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
- 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;
  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ýsledků zahrnuty
  výchozí hodnota: true
- 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:
  ["meta.internal_links_count",">","1"]
  
  [["meta.external_links_count",">","2"], "and", ["backlinks",">","10"]]
  
  [["first_visited",">","2017-10-23 11:31:45 +00:00"], "and", [["title","like","%seo%"],"or",["referring_domains",">","10"]]]
  
  Úplný seznam možných filtrů je k dispozici zde.
  
  Prázdný objekt
- include_subdomains
  Typ: boolean | null
  
  určuje, zda budou subdomény target 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:
  referring_links_tld
  referring_links_types
  referring_links_attributes
  referring_links_platform_types
  referring_links_semantic_locations
  
  výchozí hodnota: 10
  maximální hodnota: 1000
- limit
  Typ: integer | null
  
  maximální počet vrácených stránek
  volitelné pole
  výchozí hodnota: 100
  maximální hodnota: 1000
- offset
  Typ: integer | null
  
  posun v poli výsledků vrácených stránek
  volitelné pole
  výchozí hodnota: 0
  pokud zadáte hodnotu 10, prvních deset stránek v poli výsledků bude vynecháno a data budou vrácena pro následující stránky
- 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:
  ["page_summary.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:
  ["page_summary.backlinks,desc","page_summary.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
- target
  Typ: string
  
  doména nebo subdoména
  povinné pole
  doménu nebo subdoménu je nutné zadat bez https:// a www.
  příklad:
  forbes.com

Odpovědi

200
Typ: object | null · Response36Afe1097B20_BacklinksDomainPagesLiveResponseInfo
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_BacklinksDomainPagesLiveTaskInfo
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

pole položek

content_encoding
Typ: string | null

typ kódování

domain
Typ: string | null

doména
doména, na které byla stránka nalezena

encoded_size
Typ: integer | null

velikost stránky po kódování
udává velikost zakódované stránky v bajtech

fetch_time
Typ: string | null

nejnovější datum a čas, kdy náš crawler navštívil stránku
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00“
příklad:
2017-01-24 13:20:59 +00:00

first_visited
Typ: string | null

datum a čas první návštěvy stránky
datum a čas, kdy náš crawler tuto stránku navštívil poprvé
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00“
příklad:
2017-01-24 13:20:59 +00:00

ip
Typ: string | null

adresa internetového protokolu

location
Typ: string | null

hlavička Location
udává adresu URL, na kterou se má stránka přesměrovat, pokud existuje

main_domain
Typ: string | null

hlavní doména webu
hlavní doména webu nezahrnuje subdomény

media_type
Typ: string | null

typy médií používaných k zobrazení stránky

meta
Typ: object | null · Response36Afe1097B20_BacklinksPageMeta

metadata stránky

canonical
Typ: string | null

kanonická stránka

charset
Typ: string | null

kódování znaků
příklady:
utf-8

external_links_count
Typ: integer | null Formát: int64

počet externích odkazů na stránce

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

tag h1
obsah tagů h1

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

tag h2
obsah tagů h2

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

tag h3
obsah tagů h3

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

obsah tagů alt

images_count
Typ: integer | null Formát: int64

počet obrázků na stránce

internal_links_count
Typ: integer | null Formát: int64

počet interních odkazů na stránce

language
Typ: string | null

jazyk obsahu stránky
příklad:
en

page_spam_score
Typ: integer | null

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

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

typ platformy

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

podrobnosti CMS

social_media_tags
Typ: object | null
propertyName
Typ: string | null
technologies
Typ: object | null

technologie webu

propertyName
Typ: string | null
title
Typ: string | null

název stránky

words_count
Typ: integer | null Formát: int64

počet slov na stránce

page
Typ: string | null

URL stránky
relevantní URL stránky

page_summary
Typ: object | null · Response36Afe1097B20_PageSummary

obsahuje data o zpětných odkazech pro tuto stránku

backlinks
Typ: integer | null Formát: int64

udává počet zpětných odkazů

backlinks_spam_score
Typ: integer | null Formát: int64

průměrné skóre spamu zpětných odkazů odkazujících na stránku
více o tom, jak se metrika počítá, najdete na této stránce nápovědy

broken_backlinks
Typ: integer | null Formát: int64

počet nefunkčních zpětných odkazů
počet nefunkčních zpětných odkazů směřujících na page

broken_pages
Typ: integer | null

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

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

lost_date
Typ: string | null

datum a čas, kdy byl pro tuto stránku ztracen poslední zpětný odkaz
udává datum a čas, kdy náš crawler navštívil stránku a ta odpověděla stavovým kódem 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

rank
Typ: integer | null

rank stránky
rank page
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

referring_domains
Typ: integer | null Formát: int64

udává počet odkazujících domén

referring_domains_nofollow
Typ: integer | null Formát: int64

počet domén ukazujících alespoň jeden odkaz nofollow na page

referring_ips
Typ: integer | null Formát: int64

počet odkazujících IP adres
počet IP adres odkazujících na tuto stránku

referring_links_attributes
Typ: object | null
propertyName
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

referring_links_countries
Typ: object | null
propertyName
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

referring_links_platform_types
Typ: object | null
propertyName
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

referring_links_semantic_locations
Typ: object | null
propertyName
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

referring_links_tld
Typ: object | null
propertyName
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

referring_links_types
Typ: object | null
propertyName
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

referring_main_domains
Typ: integer | null Formát: int64

udává počet odkazujících hlavních domén

referring_main_domains_nofollow
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

referring_pages
Typ: integer | null Formát: int64

udává počet stránek směřujících na page

referring_pages_nofollow
Typ: integer | null Formát: int64

počet odkazujících stránek, které na page ukazují alespoň jeden odkaz nofollow

referring_subnets
Typ: integer | null Formát: int64

počet odkazujících podsítí

prev_visited
Typ: string | null

datum předcházející nejnovější návštěvě stránky naším crawlerem
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00“
příklad:
2017-01-24 13:20:59 +00:00

server
Typ: string | null

verze serveru

size
Typ: integer | null

udává velikost stránky v bajtech

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ů

tld
Typ: string | null

doména nejvyšší úrovně
doména nejvyšší úrovně v kořenové zóně DNS

type
Typ: string | null

typ prvku

items_count
Typ: integer | null Formát: int64

počet položek v poli items

target
Typ: string | null

target v poli POST

total_count
Typ: integer | null Formát: int64

celkový počet relevantních položek v databázi

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

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_pages/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "limit": 5,
    "filters": [
      [
        "page_summary.backlinks",
        ">",
        5
      ],
      "and",
      [
        "page",
        "like",
        "%sites%"
      ]
    ]
  }
]'

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": [
        {
          "target": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "main_domain": null,
              "domain": null,
              "tld": null,
              "page": null,
              "ip": null,
              "first_visited": null,
              "prev_visited": null,
              "fetch_time": null,
              "status_code": null,
              "location": null,
              "size": null,
              "encoded_size": null,
              "content_encoding": null,
              "media_type": null,
              "server": null,
              "meta": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "social_media_tags": "[Max Depth Exceeded]"
              },
              "page_summary": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "referring_main_domains_nofollow": "[Max Depth Exceeded]",
                "referring_links_tld": "[Max Depth Exceeded]",
                "referring_links_types": "[Max Depth Exceeded]",
                "referring_links_attributes": "[Max Depth Exceeded]",
                "referring_links_platform_types": "[Max Depth Exceeded]",
                "referring_links_semantic_locations": "[Max Depth Exceeded]",
                "referring_links_countries": "[Max Depth Exceeded]"
              }
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

Stránky domény

OvěřováníRequired

DataForSEO

Stránky domény

Referenční ceny