Živé výsledky vyhledávání nabídek aplikací Google
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Živé výsledky vyhledávání nabídek aplikací Google
Synchronně prohledává vlastní index nabídek Google Play společnosti DataForSEO – bez úlohy k odeslání. Shoduje se podle categories, title nebo description, zužuje pomocí filters a order_by, stránkuje pomocí limit, offset a offset_token. Vrací total_count, count, offset, offset_token a items, přičemž každý nese app_id, se_domain, location_code, language_code, check_url, time_update a vnořený item. Zabalené v obálce DataForSEO: data v tasks[0].result, výsledek v tasks[0].status_code – odmítnutý požadavek stále vrací HTTP 200. Názvy kategorií pocházejí z get_dataforseo_app_google_app_listings_categories.
Cenová reference
- Účtování: nahlášené náklady na odpověď.
- Referenční odhad požadavku: USD 0.012.
- 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.
- Typ: array (object | null)[]
- categoriesTyp: array string[] | null
- descriptionTyp: string | null
klíčové slovo v popisu aplikace
volitelné pole
klíčová slova, která se vyskytují v popisu aplikace;
může obsahovat až 200 znaků - filtersTyp: 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átorand,or
podporované operátory:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like
operátor%můžete použít slikeanot_likepro shodu s libovolným řetězcem o nule nebo více znacích
příklad:["item.rating.value",">",3]seznam dostupných filtrů můžete získat samostatným požadavkem na
https://api.dataforseo.com/v3/app_data/google/app_listings/available_filtersPrázdný objekt - limitTyp: integer | null
maximální počet vrácených aplikací
volitelné pole
výchozí hodnota:100
maximální hodnota:1000 - offsetTyp: integer | null
posun v poli výsledků vrácených aplikací
volitelné pole
výchozí hodnota:0
pokud zadáte hodnotu10, prvních deset entit v poli výsledků bude vynecháno a data budou vrácena pro následující entity
Poznámka: doporučujeme tento parametr používat pouze při načítání až 10 000 výsledků
pro načtení více než 10 000 výsledků použijte místo tohooffset_token. - offsetTyp: string | null
_token token pro následné požadavky
volitelné pole
uvádí se ve stejném poli odpovědi na každý požadavek;
tento parametr použijte, abyste se vyhnuli časovým limitům při snaze získat více než 100 000 výsledků v jednom požadavku;
zadáním jedinečné hodnotyoffset_tokenz pole odpovědi získáte následné výsledky původní úlohy;
hodnotyoffset_tokenjsou jedinečné pro každou následnou úlohu
Poznámka: pokud je v požadavku zadánoffset_token, všechny ostatní parametry musí být shodné s předchozím požadavkem
další informace o tomto parametru najdete v našem centru nápovědy - orderTyp: array string[] | null
_by pravidla řazení výsledků
volitelné pole
k řazení výsledků můžete použít stejné hodnoty jako v polifilters
možné typy řazení:asc— výsledky budou seřazeny vzestupnědesc— výsledky budou seřazeny sestupně
parametr řazení se nastavuje čárkou
příklad:["item.installs_count,asc"]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:["item.rating.value,desc","item.installs_count,asc"] - tagTyp: 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 hodnotutagnajdete v objektudataodpovědi - titleTyp: string | null
klíčové slovo v názvu aplikace
volitelné pole
klíčová slova, která se vyskytují v názvu aplikace;
může obsahovat až 200 znaků
- Typ: object | null · Response36Afe1097B20_AppDataGoogleAppListingsSearchLiveResponseInfo200
- Typ: number | null Formát: doublecost
celkové náklady na úlohy, USD
- Typ: integer | nullstatus
_code obecný kód stavu úplný seznam kódů odpovědí najdete zde
- Typ: string | nullstatus
_message obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde
- Typ: array (object | null)[] | nulltasks
pole úloh
- Typ: object | null · Response36Afe1097B20_AppDataGoogleAppListingsSearchLiveTaskInfo
- costTyp: number | null Formát: double
celkové náklady na úlohy, USD
- dataTyp: object | null
obsahuje stejné parametry, které jste zadali v požadavku POST
- propertyTyp: object | null
Name
- idTyp: string | null
identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID
- pathTyp: array (string | null)[] | null
cesta URL
- resultTyp: array (object | null)[] | null
pole výsledků
- countTyp: integer | null Formát: int64
počet položek v poli výsledků
- itemsTyp: array (object | null)[] | null
pole aplikací a souvisejících dat
- appTyp: string | null
_id ID vrácené aplikace
- checkTyp: string | null
_url přímá adresa URL na výsledky vyhledávače
můžete ji použít k ověření, že jsme poskytli přesné výsledky - itemTyp: object | null · Response36Afe1097B20_GooglePlayInfoOrganic
podrobné informace o aplikaci
- appTyp: string | null
_id ID aplikace
- descriptionTyp: string | null
popis aplikace
- developerTyp: string | null
název vývojáře aplikace
- developerTyp: string | null
_address fyzická adresa vývojáře
- developerTyp: string | null
_email e-mailová adresa vývojáře
- developerTyp: string | null
_id ID vývojáře aplikace
- developerTyp: string | null
_url URL stránky vývojáře v Google Play
- developerTyp: string | null
_website oficiální web vývojáře
- genresTyp: array (string | null)[] | null
žánry aplikace
obsahuje příslušné kategorie aplikace - iconTyp: string | null
URL ikony aplikace
- imagesTyp: array (string | null)[] | null
obrázky aplikace
obsahuje URL obrázků zveřejněných na stránce aplikace v Google Play - installsTyp: string | null
počet instalací aplikace
přibližný počet instalací zobrazený na stránce aplikace - installsTyp: integer | null Formát: int64
_count počet instalací aplikace
přesný počet instalací aplikace - isTyp: boolean | null
_free určuje, zda je aplikace zdarma
- lastTyp: string | null
_update _date datum a čas poslední aktualizace aplikace
ve formátu UTC: “yyyy-mm-dd hh-mm-ss +00:00”;
příklad:2019-11-15 12:57:46 +00:00 - mainTyp: string | null
_category hlavní kategorie aplikace
- minimumTyp: string | null
_os _version minimální verze operačního systému potřebná k instalaci aplikace
- moreTyp: array (object | null)[] | null
_apps _by _developer podobné aplikace
informace o aplikacích vytvořených stejným vývojářem- appTyp: string | null
_id ID aplikace
- titleTyp: string | null
název aplikace
- urlTyp: string | null
URL stránky aplikace na Google Play
- positionTyp: string | null
zarovnání prvku v SERP
může nabývat následujících hodnot:left - priceTyp: object | null · Response36Afe1097B20_PriceInfo
cena aplikace
- currencyTyp: string | null
měna uvedené ceny kód ISO měny použité na cenu
- currentTyp: number | null Formát: double
aktuální cena udává aktuální cenu produktu nebo služby uvedené ve výsledku
- displayedTyp: string | null
_price řetězec ceny ve výsledku surový řetězec ceny tak, jak je uveden ve výsledku
- isTyp: boolean | null
_price _range cena je uvedena jako rozsah udává, zda je cena uvedena jako rozsah
- maxTyp: number | null Formát: double
_value maximální cena maximální cena produktu nebo služby uvedená ve výsledku
- regularTyp: number | null Formát: double
běžná cena udává běžnou cenu produktu nebo služby bez uplatněných slev
- rankTyp: integer | null
_absolute absolutní pořadí mezi všemi uvedenými aplikacemi
absolutní pozice mezi všemi aplikacemi v seznamu - rankTyp: integer | null
_group pozice ve skupině prvků se shodnými hodnotami
type
pozice prvků s odlišnými hodnotamitypese vrank_groupvynechávají - ratingTyp: object | null · Response36Afe1097B20_RatingInfo
průměrné hodnocení aplikace
- ratingTyp: integer | null
_max maximální hodnota pro rating_type
- ratingTyp: string | null
_type typ hodnocení zde najdete následující prvky: Max5, Percents, CustomMax
- valueTyp: number | null Formát: double
hodnota hodnocení
- votesTyp: integer | null Formát: int64
_count množství zpětné vazby
- releasedTyp: string | null
_date datum a čas vydání aplikace
ve formátu UTC: “yyyy-mm-dd hh-mm-ss +00:00”;
příklad:2019-11-15 12:57:46 +00:00 - reviewsTyp: integer | null Formát: int64
_count celkový počet recenzí aplikace
- similarTyp: array (object | null)[] | null
_apps podobné aplikace
zobrazuje aplikace podobné dané aplikaci v požadavku POST- appTyp: string | null
_id ID aplikace
- titleTyp: string | null
název aplikace
- urlTyp: string | null
URL stránky aplikace na Google Play
- sizeTyp: string | null
velikost aplikace
- tagsTyp: array (string | null)[] | null
značky aplikace
obsahuje příslušné značky aplikace - titleTyp: string | null
název aplikace
- typeTyp: string | null
typ prvku
- updateTyp: string | null
_notes poznámky k aktualizaci
obsahuje nejnovější poznámky k aktualizaci od vývojáře - urlTyp: string | null
URL stránky aplikace v Google Play
- versionTyp: string | null
aktuální verze aplikace
- videosTyp: array (string | null)[] | null
videa aplikace
obsahuje URL videa zveřejněného na stránce aplikace v Google Play
- languageTyp: string | null
_code kód jazyka v poli POST
- locationTyp: integer | null
_code kód lokality v poli POST
- seTyp: string | null
_domain doména vyhledávače v poli POST
- timeTyp: string | null
_update
- offsetTyp: integer | null
posun v poli výsledků vrácených aplikací
- offsetTyp: string | null
_token token pro následující požadavky
tento parametr můžete použít v požadavku POST, abyste se vyhnuli časovým limitům při pokusu o získání více než 100 000 výsledků v jednom požadavku - totalTyp: integer | null Formát: int64
_count celkový počet relevantních výsledků v databázi
- resultTyp: integer | null Formát: int64
_count počet prvků v poli result
- statusTyp: integer | null
_code 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
- statusTyp: string | null
_message informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde
- timeTyp: string | null
doba provedení, sekundy
- Typ: integer | null Formát: int64tasks
_count počet úloh v poli tasks
- Typ: integer | null Formát: int64tasks
_error počet úloh v poli tasks vrácených s chybou
- Typ: string | nulltime
celková doba provádění, sekundy
- Typ: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/app_data/google/app_listings/search/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"title": "vpn",
"description": "vpn",
"categories": [
"Tools"
],
"order_by": [
"item.installs_count,asc"
],
"filters": [
[
"item.rating.value",
">",
4.5
]
],
"limit": 10
}
]'
{
"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,
"count": null,
"offset": null,
"offset_token": null,
"items": [
{
"app_id": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"time_update": null,
"item": "[Max Depth Exceeded]"
}
]
}
]
}
]
}