v0.2.0-beta

OpenAPI 3.1.0

Konkurenti aplikací Google Play naživo

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

Konkurenti aplikací Google Play naživo

Aplikace Google Play, které konkurují dané aplikaci o společná klíčová slova. Stránkování pomocí limit, offset a offset_token; po prvních stránkách používejte token. 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. Dvojčetem pro Apple je post_dataforseo_labs_apple_app_competitors_live. Klíčová slova za tímto průnikem najdete pomocí post_dataforseo_labs_google_app_intersection_live.

Referenční ceny

Účtování: vykázaná cena odpovědi.
Referenční odhad ceny požadavku: USD 0.1356.
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)[]
- app_id
  Typ: string
  
  ID aplikace
  povinné pole
  ID mobilní aplikace v Google Play;
  ID najdete v adrese URL každé aplikace uvedené v Google Play;
  příklad:
  v adrese URL https://play.google.com/store/apps/details?id=org.telegram.messenger
  je ID org.telegram.messenger
- 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 filtrů)
  mezi podmínkami je nutné nastavit logický operátor and, or
  podporované operátory:
  <, <=, >, >=, =, <>, in, not_in
  příklad:
  ["intersections",">",500]
  
  [["competitor_metrics.google_play_search_organic.pos_1","<>",10],"and",["avg_position",">=","10"]]
  
  [[["intersections",">=",50],"and",["competitor_metrics.google_play_search_organic.pos_1","in",[1,5]]], "or", ["sum_position",">=","10000"]]
  
  další informace o filtrech najdete v Dataforseo Labs - Filters nebo v tomto průvodci Centra nápovědy
  
  Prázdný objekt
- language_code
  Typ: string | null
  
  kód jazyka
  povinné pole, pokud nezadáte language_name
  Poznámka: je nutné zadat buď language_name, nebo language_code
  seznam dostupných jazyků a jejich language_code získáte odesláním samostatného požadavku na
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Poznámka: tento endpoint aktuálně podporuje pouze anglický jazyk
  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ů a jejich language_name získáte odesláním samostatného požadavku na
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Poznámka: tento endpoint aktuálně podporuje pouze anglický jazyk;
  příklad:
  English
- limit
  Typ: integer | null
  
  maximální počet vrácených aplikací
  volitelné pole
  výchozí hodnota: 100
  maximální hodnota: 1000
- location_code
  Typ: integer
  
  kód lokality
  povinné pole, pokud nezadáte location_name
  Poznámka: je nutné zadat buď location_name, nebo location_code
  seznam dostupných lokalit a jejich location_code získáte odesláním samostatného požadavku na
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Poznámka: tento endpoint aktuálně podporuje pouze lokalitu USA;
  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 a jejich location_name získáte odesláním samostatného požadavku na
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Poznámka: tento endpoint aktuálně podporuje pouze lokalitu USA;
  příklad:
  United States
- offset
  Typ: integer | null
  
  posun v poli výsledků vrácených aplikací
  volitelné pole
  výchozí hodnota: 0
  pokud zadáte hodnotu 10, prvních deset aplikací v poli výsledků bude vynecháno a data budou poskytnuta pro následující klíčová slova
- 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:
  ["intersections,asc"]
  Poznámka: 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","sum_position,asc"]
  
  výchozí pravidlo:
  ["intersections,desc"]
  Poznámka: pokud pole item_types obsahuje typy položek odlišné od organic, budou výsledky seřazeny podle prvního typu položky v poli
- 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_DataforseoLabsGoogleAppCompetitorsLiveResponseInfo
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_DataforseoLabsGoogleAppCompetitorsLiveTaskInfo
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ů

app_id
Typ: string | null

id aplikace v poli POST

items
Typ: array (object | null)[] | null

obsahuje data týkající se app_id a konkurenčních aplikací

app_id
Typ: string | null

id aplikace v poli POST

avg_position
Typ: number | null Formát: float

průměrná pozice aplikace v SERP Google Play
Poznámka: průměrná pozice se počítá pouze pro protínající se klíčová slova;
hodnota pro danou aplikaci se může lišit v kombinaci s různými cílovými aplikacemi

competitor_metrics
Typ: object | null

metriky pro protínající se klíčová slova
rankingová data týkající se klíčových slov, která zadaná konkurenční aplikace sdílí s aplikací v požadavku POST;
poznámka: v tomto poli jsou rankingová data poskytována pro app_id vráceného konkurenta

propertyName
Typ: object · Response36Afe1097B20_AppMetricsInfo
count
Typ: integer | null Formát: int64

celkový počet organických SERP Amazon, které produkt obsahují

pos_1
Typ: integer | null

počet organických SERP, kde se produkt umisťuje na #1

pos_11_100
Typ: integer | null

počet organických SERP, kde se produkt umisťuje na #11-100

pos_2_3
Typ: integer | null

počet organických SERP, kde se produkt umisťuje na #2-3

pos_4_10
Typ: integer | null

počet organických SERP, kde se produkt umisťuje na #4-10

search_volume
Typ: integer | null Formát: int64

celkový objem vyhledávání klíčových slov, na kterých se produkt v organickém SERP umisťuje

full_metrics
Typ: object | null

metriky pro všechna klíčová slova aplikace
úplný přehled rankingových dat týkajících se všech klíčových slov, na která se zadaný app_id umisťuje

propertyName
Typ: object · Response36Afe1097B20_AppMetricsInfo
count
Typ: integer | null Formát: int64

celkový počet organických SERP Amazon, které produkt obsahují

pos_1
Typ: integer | null

počet organických SERP, kde se produkt umisťuje na #1

pos_11_100
Typ: integer | null

počet organických SERP, kde se produkt umisťuje na #11-100

pos_2_3
Typ: integer | null

počet organických SERP, kde se produkt umisťuje na #2-3

pos_4_10
Typ: integer | null

počet organických SERP, kde se produkt umisťuje na #4-10

search_volume
Typ: integer | null Formát: int64

celkový objem vyhledávání klíčových slov, na kterých se produkt v organickém SERP umisťuje

intersections
Typ: integer | null

počet protínajících se klíčových slov

se_type
Typ: string | null

typ vyhledávače

sum_position
Typ: integer | null

součet všech pozic aplikace v SERP Google Play
Poznámka: součet pozic se počítá pouze pro protínající se klíčová slova;
hodnota pro danou aplikaci se může lišit v kombinaci s různými cílovými aplikacemi

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

location_code
Typ: integer | null

kód lokality v poli POST

se_type
Typ: string | null

typ vyhledávače

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

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/app_competitors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "app_id": "org.telegram.messenger",
    "language_name": "English",
    "location_code": 2840,
    "limit": 10
  }
]'

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,
          "app_id": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "app_id": null,
              "avg_position": null,
              "sum_position": null,
              "intersections": null,
              "competitor_metrics": null,
              "full_metrics": null
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

Konkurenti aplikací Google Play naživo

OvěřováníRequired

DataForSEO

Konkurenti aplikací Google Play naživo

Referenční ceny