Felo API PlatformFelo API Platform
Všechny endpointy DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Živé výsledky vyhledávání nabídek aplikací Google

Server:https://openapi.felo.ai
Klientské knihovny

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.

Tělo
application/json
  • Typ: array (object | null)[]
    • categories
      Typ: array string[] | null

      kategorie aplikací
      volitelné pole
      zadané kategorie se používají k vyhledávání nabídek aplikací;
      úplný seznam dostupných kategorií nabídek aplikací získáte na tomto odkazu
      můžete zadat až 10 kategorií

    • description
      Typ: 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ů

    • 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
      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:
      ["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_filters

      Prázdný objekt
    • limit
      Typ: integer | null

      maximální počet vrácených aplikací
      volitelné pole
      výchozí hodnota: 100
      maximální hodnota: 1000

    • 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 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 toho offset_token.

    • offset_token
      Typ: string | null

      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é hodnoty offset_token z pole odpovědi získáte následné výsledky původní úlohy;
      hodnoty offset_token jsou jedinečné pro každou následnou úlohu
      Poznámka: pokud je v požadavku zadán offset_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

    • 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ě
      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"]

    • 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

    • title
      Typ: 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ů

Odpovědi
  • 200
    Typ: object | null · Response36Afe1097B20_AppDataGoogleAppListingsSearchLiveResponseInfo
    • 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_AppDataGoogleAppListingsSearchLiveTaskInfo
        • 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ů

          • count
            Typ: integer | null Formát: int64

            počet položek v poli výsledků

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

            pole aplikací a souvisejících dat

            • app_id
              Typ: string | null

              ID vrácené aplikace

            • check_url
              Typ: string | null

              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

            • item
              Typ: object | null · Response36Afe1097B20_GooglePlayInfoOrganic

              podrobné informace o aplikaci

              • app_id
                Typ: string | null

                ID aplikace

              • description
                Typ: string | null

                popis aplikace

              • developer
                Typ: string | null

                název vývojáře aplikace

              • developer_address
                Typ: string | null

                fyzická adresa vývojáře

              • developer_email
                Typ: string | null

                e-mailová adresa vývojáře

              • developer_id
                Typ: string | null

                ID vývojáře aplikace

              • developer_url
                Typ: string | null

                URL stránky vývojáře v Google Play

              • developer_website
                Typ: string | null

                oficiální web vývojáře

              • genres
                Typ: array (string | null)[] | null

                žánry aplikace
                obsahuje příslušné kategorie aplikace

              • icon
                Typ: string | null

                URL ikony aplikace

              • images
                Typ: array (string | null)[] | null

                obrázky aplikace
                obsahuje URL obrázků zveřejněných na stránce aplikace v Google Play

              • installs
                Typ: string | null

                počet instalací aplikace
                přibližný počet instalací zobrazený na stránce aplikace

              • installs_count
                Typ: integer | null Formát: int64

                počet instalací aplikace
                přesný počet instalací aplikace

              • is_free
                Typ: boolean | null

                určuje, zda je aplikace zdarma

              • last_update_date
                Typ: string | null

                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

              • main_category
                Typ: string | null

                hlavní kategorie aplikace

              • minimum_os_version
                Typ: string | null

                minimální verze operačního systému potřebná k instalaci aplikace

              • more_apps_by_developer
                Typ: array (object | null)[] | null

                podobné aplikace
                informace o aplikacích vytvořených stejným vývojářem

                • app_id
                  Typ: string | null

                  ID aplikace

                • title
                  Typ: string | null

                  název aplikace

                • url
                  Typ: string | null

                  URL stránky aplikace na Google Play

              • position
                Typ: string | null

                zarovnání prvku v SERP
                může nabývat následujících hodnot: left

              • price
                Typ: object | null · Response36Afe1097B20_PriceInfo

                cena aplikace

                • currency
                  Typ: string | null

                  měna uvedené ceny kód ISO měny použité na cenu

                • current
                  Typ: number | null Formát: double

                  aktuální cena udává aktuální cenu produktu nebo služby uvedené ve výsledku

                • displayed_price
                  Typ: string | null

                  řetězec ceny ve výsledku surový řetězec ceny tak, jak je uveden ve výsledku

                • is_price_range
                  Typ: boolean | null

                  cena je uvedena jako rozsah udává, zda je cena uvedena jako rozsah

                • max_value
                  Typ: number | null Formát: double

                  maximální cena maximální cena produktu nebo služby uvedená ve výsledku

                • regular
                  Typ: number | null Formát: double

                  běžná cena udává běžnou cenu produktu nebo služby bez uplatněných slev

              • rank_absolute
                Typ: integer | null

                absolutní pořadí mezi všemi uvedenými aplikacemi
                absolutní pozice mezi všemi aplikacemi v seznamu

              • rank_group
                Typ: integer | null

                pozice ve skupině prvků se shodnými hodnotami type
                pozice prvků s odlišnými hodnotami type se v rank_group vynechávají

              • rating
                Typ: object | null · Response36Afe1097B20_RatingInfo

                průměrné hodnocení aplikace

                • rating_max
                  Typ: integer | null

                  maximální hodnota pro rating_type

                • rating_type
                  Typ: string | null

                  typ hodnocení zde najdete následující prvky: Max5, Percents, CustomMax

                • value
                  Typ: number | null Formát: double

                  hodnota hodnocení

                • votes_count
                  Typ: integer | null Formát: int64

                  množství zpětné vazby

              • released_date
                Typ: string | null

                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

              • reviews_count
                Typ: integer | null Formát: int64

                celkový počet recenzí aplikace

              • similar_apps
                Typ: array (object | null)[] | null

                podobné aplikace
                zobrazuje aplikace podobné dané aplikaci v požadavku POST

                • app_id
                  Typ: string | null

                  ID aplikace

                • title
                  Typ: string | null

                  název aplikace

                • url
                  Typ: string | null

                  URL stránky aplikace na Google Play

              • size
                Typ: string | null

                velikost aplikace

              • tags
                Typ: array (string | null)[] | null

                značky aplikace
                obsahuje příslušné značky aplikace

              • title
                Typ: string | null

                název aplikace

              • type
                Typ: string | null

                typ prvku

              • update_notes
                Typ: string | null

                poznámky k aktualizaci
                obsahuje nejnovější poznámky k aktualizaci od vývojáře

              • url
                Typ: string | null

                URL stránky aplikace v Google Play

              • version
                Typ: string | null

                aktuální verze aplikace

              • videos
                Typ: array (string | null)[] | null

                videa aplikace
                obsahuje URL videa zveřejněného na stránce aplikace v Google Play

            • language_code
              Typ: string | null

              kód jazyka v poli POST

            • location_code
              Typ: integer | null

              kód lokality v poli POST

            • se_domain
              Typ: string | null

              doména vyhledávače v poli POST

            • time_update
              Typ: string | null

              datum a čas poslední aktualizace dat SERP
              ve formátu ISO 8601: „YYYY-MM-DDThh:mm:ss.sssssssZ”
              příklad:
              2023-05-23 10:16:19 +00:00

          • offset
            Typ: integer | null

            posun v poli výsledků vrácených aplikací

          • offset_token
            Typ: string | null

            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

          • total_count
            Typ: integer | null Formát: int64

            celkový počet relevantních výsledků 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
Request Example for post/v1/beta/dataforseo/app_data/google/app_listings/search/live
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]"
            }
          ]
        }
      ]
    }
  ]
}
Live Google App Listings Search Results

Potřebujete pomoc?