v0.2.0-beta

OpenAPI 3.1.0

Odkazující sítě

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

Odkazující sítě

Sloučí odkazující domény do sítí, které za nimi stojí – jeden řádek na network_address s referring_domains a dále rank, backlinks, first_seen, lost_date, backlinks_spam_score, broken_backlinks a broken_pages. network_address_type volí IP adresu nebo podsíť. Na této úrovni jsou vidět odkazové schémy: mnoho domén v jedné podsíti je jeden provozovatel, nikoli mnoho doporučení. Nesloučené zobrazení je post_dataforseo_backlinks_referring_domains_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 vašeho target;
  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 jsou zpětné odkazy ze subdomén target vyloučeny
  volitelné pole
  pokud nastavíte false, zpětné odkazy ze subdomén target budou vynechány a v odpovědi nedostanete stejnou doménu;
  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:
  ["referring_pages",">","1"]
  
  [["referring_pages",">","2"], "and", ["backlinks",">","10"]]
  
  [["first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["network_address","like","194.1.%"],"or",["referring_ips",">","10"]]]
  
  Ú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 target
  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 target, 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 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 sítí
  volitelné pole
  výchozí hodnota: 100
  maximální hodnota: 1000
- network_address_type
  Typ: string | null
  
  určuje typ sítě, pro který se mají načíst data
  volitelné pole
  možné hodnoty: ip, subnet
  výchozí hodnota: ip
- offset
  Typ: integer | null
  
  posun v poli výsledků vrácených sítí
  volitelné pole
  výchozí hodnota: 0
  pokud zadáte hodnotu 10, prvních deset domén 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:
  ["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"]
- 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, subdoména nebo webová stránka, pro kterou se mají načíst odkazující sítě
  povinné pole
  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://)

Odpovědi

200
Typ: object | null · Response36Afe1097B20_BacklinksReferringNetworksLiveResponseInfo
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_BacklinksReferringNetworksLiveTaskInfo
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

backlinks
Typ: integer | null Formát: int64

udává počet zpětných odkazů odkazujících na target

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ů odkazujících na doménu

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 ztracen poslední zpětný odkaz z této domény
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

network_address
Typ: string | null

adresa odkazující podsítě nebo IP

rank
Typ: integer | null

rank sítě
objem ranku, který odkazující síť předává na target
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
odkazující domény zahrnují subdomény, které se pro tuto metriku počítají jako samostatné domény

referring_domains_nofollow
Typ: integer | null Formát: int64

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

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

atributy odkazujících odkazů
udává atributy odkazujících odkazů a počet odkazů pro každý atribut

propertyName
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

referring_links_countries
Typ: object | null

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

propertyName
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

referring_links_platform_types
Typ: object | null

typy odkazujících platforem
udává typy odkazujících platforem a počet odkazů pro každou platformu

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

propertyName
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

referring_links_semantic_locations
Typ: object | null

sémantická umístění odkazujících odkazů
udává sémantické prvky v HTML, v nichž se odkazující odkazy nacházejí, a počet odkazů pro každé sémantické umístění

úplný seznam sémantických prvků najdete zde
příklady:
article, section, summary

propertyName
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

referring_links_tld
Typ: object | null

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

propertyName
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

referring_links_types
Typ: object | null

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

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

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

referring_pages
Typ: integer | null Formát: int64

udává počet stránek odkazujících na zadaný target

referring_pages_nofollow
Typ: integer | null Formát: int64

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

referring_subnets
Typ: integer | null Formát: int64

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

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

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/referring_networks/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "backlinko.com",
    "network_address_type": "subnet",
    "limit": 5,
    "order_by": [
      "rank,desc"
    ],
    "exclude_internal_backlinks": true,
    "backlinks_filters": [
      "dofollow",
      "=",
      true
    ],
    "filters": [
      "backlinks",
      ">",
      100
    ]
  }
]'

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,
              "network_address": null,
              "rank": null,
              "backlinks": null,
              "first_seen": null,
              "lost_date": 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
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

Odkazující sítě

OvěřováníRequired

DataForSEO

Odkazující sítě

Referenční ceny