v0.2.0-beta

OpenAPI 3.1.0

Průnik domén

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

Průnik domén

Domény odkazující na několik cílů najednou. ⚠️ targets je zde objekt klíčovaný pozicí – {"1": "a.com", "2": "b.com"} – nikoli pole, které přijímají hromadné endpointy. exclude_targets vyřazuje weby z porovnání. Každý řádek nese domain_intersection a summary pro každý cíl. Pomáhá najít ty, kdo odkazují na vaše konkurenty, ale ne na vás. Ekvivalent na úrovni stránek je post_dataforseo_backlinks_page_intersection_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.

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š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 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
- 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í domény, 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.internal_links_count",">","1"]
 
 [["2.referring_pages",">","2"], "and", ["1.backlinks",">","10"]]
 
 [["1.first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["2.target","like","%dataforseo.com%"],"or",["1.referring_domains",">","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 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 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
- 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é domény
 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 výsledků
 volitelné pole
 výchozí hodnota: 100
 maximální hodnota: 1000
- offset
 Typ: integer | null
 
 posun v poli vrácených výsledků
 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:
 ["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
- 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_BacklinksDomainIntersectionLiveResponseInfo
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_BacklinksDomainIntersectionLiveTaskInfo
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 domény, které odkazují na všechny targets z pole POST

domain_intersection
Typ: object | null

obsahuje data o doméná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 doménám, subdoménám nebo stránkám zadaným v objektu targets

propertyName
Typ: object | null · Response36Afe1097B20_BacklinksDomainIntersection
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 target
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ů

broken_pages
Typ: integer | null

počet nefunkčních stránek

first_seen
Typ: string | null

datum a čas, kdy náš crawler poprvé našel zpětný odkaz z tohoto target
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 tohoto target
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:
2019-11-15 12:57:46 +00:00

rank
Typ: integer | null

rank přiřazený k target z pole POST
udává rank, který odkazující doména (target výše) předává vašemu cíli z pole POST;
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

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 odpovídající cíl

referring_ips
Typ: integer | null Formát: int64

počet odkazujících IP adres

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

Integer numbers.

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

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

Integer numbers.

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

propertyName
Typ: integer | null

Integer numbers.

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

Integer numbers.

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

Integer numbers.

referring_main_domains
Typ: integer | null Formát: int64

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 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í

target
Typ: string | null

doména, která odkazuje na odpovídající cíl z pole POST

type
Typ: string | null

typ prvku

summary
Typ: object | null · Response36Afe1097B20_IntersectionSummaryInfo

obsahuje souhrn průniků domén

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

cílové domény, subdomény nebo webové stránky v poli POST

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

celkový počet výsledků relevantních k vašemu 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/domain_intersection/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": {
      "1": "moz.com",
      "2": "ahrefs.com"
    },
    "include_subdomains": false,
    "exclude_targets": [
      "semrush.com"
    ],
    "limit": 5,
    "order_by": [
      "1.backlinks,desc"
    ],
    "exclude_internal_backlinks": 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": [
            {
              "domain_intersection": null,
              "summary": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

Průnik domén

OvěřováníRequired

DataForSEO

Průnik domén

Referenční ceny