v0.2.0-beta

OpenAPI 3.1.0

Konkurenti

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

Konkurenti

Weby sdílející odkazující domény s jedním target, seřazené podle toho, kolik jich sdílejí. Každý řádek obsahuje target, rank a intersections – počet společných odkazujících domén. main_domain, exclude_large_domains a exclude_internal_backlinks určují, co se počítá. Jde o konkurenty v grafu odkazů, nikoli ve vyhledávání; pro ty druhé použijte post_dataforseo_labs_google_serp_competitors_live. Skutečné sdílené domény ukáže post_dataforseo_backlinks_domain_intersection_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)[]
- 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
- exclude_large_domains
  Typ: boolean | null
  
  určuje, zda se velká doména objeví ve výsledcích
  volitelné pole
  pokud nastavíte true, výsledky z velké domény (google.com, amazon.com atd.) budou vynechány;
  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:
  ["rank",">","100"]
  
  [["target","like","%forbes%"], "and", [["rank",">","100"],"or",["intersections",">","5"]]]
  
  Úplný seznam možných filtrů je k dispozici zde.
  
  Prázdný objekt
- limit
  Typ: integer | null
  
  maximální počet vrácených domén
  volitelné pole
  výchozí hodnota: 100
  maximální hodnota: 1000
- main_domain
  Typ: boolean | null
  
  určuje, zda bude do vyhledávání zahrnuta pouze hlavní doména target
  volitelné pole
  pokud nastavíte true, do vyhledávání bude zahrnuta pouze hlavní doména;
  výchozí hodnota: true
- offset
  Typ: integer | null
  
  posun v poli výsledků vrácených domén
  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:
  ["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:
  ["intersections,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 konkurenční domény
  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_BacklinksCompetitorsLiveResponseInfo
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_BacklinksCompetitorsLiveTaskInfo
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

intersections
Typ: integer | null

udává počet průniků zpětných odkazů s target zadaným v poli POST

rank
Typ: integer | null

rank domény
rank domény mezi všemi doménami v databázi
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

target
Typ: string | null

doména konkurence

type
Typ: string | null

typ prvku

items_count
Typ: integer | null Formát: int64

počet položek v poli items

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

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

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": [
        {
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "target": null,
              "rank": null,
              "intersections": null
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

Konkurenti

OvěřováníRequired

DataForSEO

Konkurenti

Referenční ceny