v0.2.0-beta

OpenAPI 3.1.0

Konkurence v SERP

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/dataforseo_labs/google/serp_competitors/live

Konkurence v SERP

Domény, které se s vámi umisťují na sadu keywords, a kolik jich sdílejí. Vrací se_type, seed_keywords, total_count, items_count a items. Zabaleno do obálky DataForSEO: data v tasks[0].result, výsledek v tasks[0].status_code – odmítnutý požadavek stále vrací HTTP 200. ⚠️ Jde o konkurenty ve vyhledávání, určené sdílenými pozicemi. Ekvivalent v grafu odkazů je post_dataforseo_backlinks_competitors_live a oba seznamy se často rozcházejí – což je samo o sobě informativní.

Cenová reference

Účtování: nahlášené náklady na odpověď.
Referenční odhad požadavku: USD 0.0192.
Referenční multiplikátor zákazníka: 1.0. Neaplikujte jej znovu na zúčtovanou částku zákazníka.

Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či 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)[]
- 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, match, not_match, ilike, not_ilike, like, not_like
  operátor % můžete použít s like a not_like, stejně jako s ilike a not_ilike, pro shodu s libovolným řetězcem o nule nebo více znacích
  příklad:
  ["median_position","in",[1,10]]
  
  [["median_position","in",[1,10]],"and",["domain","not_like","%wikipedia.org%"]]
  
  [["domain","not_like","%wikipedia.org%"], "and", [["relevant_serp_items",">",0],"or",["median_position","in",[1,10]]]]
  další informace o filtrech naleznete v Dataforseo Labs - Filters nebo v tomto průvodci centra nápovědy
  
  Prázdný objekt
- include_subdomains
  Typ: boolean | null
  
  určuje, zda budou subdomény zahrnuty do vyhledávání
  volitelné pole
  pokud je nastaveno na false, subdomény budou ignorovány
  výchozí hodnota: true
- item_types
  Typ: array string[] | null
  
  typ výsledků vyhledávání
  určuje typ výsledků vyhledávání zahrnutých v odpovědi
  volitelné pole
  
  možné hodnoty:
  ["organic", "paid", "featured_snippet", "local_pack"]
  výchozí hodnota:
  ["organic", "paid"]
- keywords
  Typ: array string[]
  
  pole klíčových slov
  povinné pole
  výsledky budou založeny na klíčových slovech, která zadáte v tomto poli
  kódování UTF-8;
  klíčová slova budou převedena na malá písmena;
  můžete zadat maximálně 200 klíčových slov
  
  další informace o pravidlech a omezeních polí keyword a keywords v rozhraních API DataForSEO najdete v tomto článku Centra nápovědy
- language_code
  Typ: string | null
  
  jedinečný identifikátor jazyka
  povinné pole, pokud nezadáte language_name
  Poznámka: je nutné zadat buď language_name, nebo language_code
  seznam dostupných jazyků s jejich parametry language_code získáte samostatným požadavkem na
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  příklad:
  en
- language_name
  Typ: string
  
  úplný název jazyka
  povinné pole, pokud nezadáte language_code
  Poznámka: je nutné zadat buď language_name, nebo language_code
  seznam dostupných jazyků s jejich parametry language_name získáte samostatným požadavkem na
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  příklad:
  English
- limit
  Typ: integer | null
  
  maximální počet vrácených domén
  volitelné pole
  výchozí hodnota: 100
  maximální hodnota: 1000
- location_code
  Typ: integer
  
  jedinečný identifikátor lokality
  povinné pole, pokud nezadáte location_name
  Poznámka: je nutné zadat buď location_name, nebo location_code
  seznam dostupných lokalit s jejich parametry location_code získáte samostatným požadavkem na
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  příklad:
  2840
- location_name
  Typ: string
  
  úplný název lokality
  povinné pole, pokud nezadáte location_code
  Poznámka: je nutné zadat buď location_name, nebo location_code
  seznam dostupných lokalit s jejich parametry location_name získáte samostatným požadavkem na
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  příklad:
  United Kingdom
- 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í domény
- 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ě
  jako oddělovač se používá čárka
  příklad:
  ["avg_position,asc"]
  výchozí pravidlo:
  ["rating,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:
  ["avg_position,asc","etv,desc"]
- 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

Odpovědi

200
Typ: object | null · Response36Afe1097B20_DataforseoLabsGoogleSerpCompetitorsLiveResponseInfo
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_DataforseoLabsGoogleSerpCompetitorsLiveTaskInfo
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 zjištěné konkurenty v SERP a související data

avg_position
Typ: number | null Formát: float

průměrná pozice domény pro zadaná klíčová slova
aritmetický průměr hodnot v poli keywords_positions

domain
Typ: string | null

název domény zjištěného konkurenta v SERP

etv
Typ: number | null

odhadovaný objem návštěvnosti
představuje odhadovanou měsíční návštěvnost, kterou zadaná klíčová slova přivádějí na web
počítá se jako součet součinů hodnot objemu vyhledávání zadaných klíčových slov a hodnot CTR (míry prokliku) na určitých pozicích v SERP
více o tom, jak se metrika počítá, najdete v tomto článku nápovědy

keywords_count
Typ: integer | null Formát: int64

počet zadaných klíčových slov, pro která má doména pozice v SERP

keywords_positions
Typ: object | null

pozice klíčových slov
pozice v SERP, které související doména zaujímá pro zadaná klíčová slova

propertyName
Typ: array (integer | null)[] | null
median_position
Typ: number | null

medián pozice domény pro zadaná klíčová slova
medián hodnot v poli keywords_positions

rating
Typ: number | null

rozdíl mezi nejvyšší možnou a skutečnou pozicí klíčových slov
představuje relativní míru viditelnosti domény v SERP pro zadaná klíčová slova
počítá se jako sum(100-keywords_positions)

relevant_serp_items
Typ: integer | null

počet prvků SERP relevantních pro doménu
představuje počet výsledků vyhledávání v SERP relevantních pro doménu u zadaných klíčových slov

se_type
Typ: string | null

typ vyhledávače

visibility
Typ: number | null

míra viditelnosti v SERP
představuje míru viditelnosti webu na základě pozic zadaných klíčových slov v SERP
Klíčovým slovům na pozicích v rozsahu 1 až 10 se přiřazuje index viditelnosti postupně od 1 do 0,1
Klíčová slova na pozicích v rozsahu 11 až 20 mají pevný index viditelnosti 0,05
klíčová slova na pozicích od 20 do 100 mají index viditelnosti roven 0

items_count
Typ: integer | null Formát: int64

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

language_code
Typ: string | null

kód jazyka v poli POST
pokud nejsou k dispozici žádná data, hodnota je null

location_code
Typ: integer | null

kód lokality v poli POST
pokud nejsou k dispozici žádná data, hodnota je null

se_type
Typ: string | null

typ vyhledávače

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

klíčová slova zadaná v požadavku
klíčové slovo se vrací s dekódovanými výskyty %## (znak „+” bude dekódován jako mezera)

total_count
Typ: integer | null Formát: int64

celkový počet výsledků v naší databázi relevantních pro váš požadavek

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/dataforseo_labs/google/serp_competitors/live

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/serp_competitors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "phone"
    ],
    "language_name": "English",
    "location_code": 2840,
    "item_types": [
      "organic"
    ],
    "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": [
        {
          "se_type": null,
          "seed_keywords": [
            null
          ],
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "domain": null,
              "avg_position": null,
              "median_position": null,
              "rating": null,
              "etv": null,
              "keywords_count": null,
              "visibility": null,
              "relevant_serp_items": null,
              "keywords_positions": null
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

Konkurence v SERP

OvěřováníRequired

DataForSEO

Konkurence v SERP

Cenová reference