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

Nastavení úloh seznamu aplikací Google

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

Nastavení úloh seznamu aplikací Google

​

Zařadí jednu z vlastních kurátorovaných kolekcí Google Play – nejlepší zdarma, nejvíce vydělávající, populární – vybranou pomocí app_collection, a vrátí id úlohy. depth omezuje, jak hluboko do žebříčku číst. Asynchronně: odeslání vrátí id úlohy v tasks[0].id a nástroj pro načtení vrátí výsledek, jakmile je připraven. Načtěte pomocí get_dataforseo_app_google_app_list_fetch. Toto je zobrazení žebříčku; pro vyhledávání podle klíčového slova použijte post_dataforseo_app_google_app_searches_submit.

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)[]
    • age_rating
      Typ: string | null

      filtrování výsledků podle věkového hodnocení
      volitelné pole
      pomocí tohoto pole můžete filtrovat výsledky podle věkového hodnocení;
      možné typy filtrování:
      ages_up_to_5 — vrací aplikace schválené pro děti do 5 let;
      ages_6_8 — vrací aplikace schválené pro děti od 6 do 8 let;
      ages_9_12 — vrací aplikace schválené pro děti od 9 do 12 let;
      ve výchozím nastavení API vrací aplikace pro všechny věkové kategorie;
      Poznámka: tento filtr funguje pouze ve spojení s parametrem "category": "family"

    • app_category
      Typ: string | null

      kategorie aplikace v Google Play
      volitelné pole
      výsledky můžete filtrovat podle kategorie aplikace;
      příklad:
      family;
      úplný seznam dostupných kategorií můžete získat samostatným požadavkem na https://api.dataforseo.com/v3/app_data/google/categories
      Poznámka: parametr app_category nelze použít, pokud je parametr app_collection nastaven na featured

    • app_collection
      Typ: string

      kolekce aplikací
      povinné pole
      kolekce v Google Play, ze které budou aplikace shromažďovány;
      můžete zadat následující hodnoty:
      featured, topselling_paid, topselling_free, topselling_new_free, topselling_new_paid, topgrossing, movers_shakers
      Poznámka: pokud je vybráno featured, nelze parametr app_category použít

    • depth
      Typ: integer | null

      hloubka parsování
      volitelné pole
      počet aplikací vrácených v odpovědi API;
      důrazně doporučujeme nastavovat hloubku parsování v násobcích 100, protože náš systém zpracovává 100 výsledků za sebou;
      výchozí hodnota: 100;
      maximální hodnota: 200;
      Váš účet bude účtován za každý SERP obsahující až 100 výsledků;
      nastavení hloubky nad 100 může vést k dodatečným poplatkům, pokud vyhledávač vrátí více než 100 výsledků;
      Náklady lze vypočítat na stránce Ceny.

    • language_code
      Typ: string

      kód jazyka vyhledávače
      povinné pole, pokud není zadáno language_name
      pokud toto pole použijete, nemusíte zadávat language_name
      seznam dostupných jazyků s jejich language_code můžete získat samostatným požadavkem na https://api.dataforseo.com/v3/app_data/google/languages
      příklad:
      en

    • language_name
      Typ: string

      úplný název jazyka vyhledávače
      povinné pole, pokud není zadáno language_code
      pokud toto pole použijete, nemusíte zadávat language_code
      seznam dostupných jazyků s jejich language_name můžete získat samostatným požadavkem na https://api.dataforseo.com/v3/app_data/google/languages
      příklad:
      English

    • location_code
      Typ: integer

      kód lokality vyhledávače
      povinné pole, pokud nezadáte location_name
      pokud toto pole použijete, nemusíte zadávat location_name
      seznam dostupných lokalit vyhledávače s jejich location_code můžete získat samostatným požadavkem na https://api.dataforseo.com/v3/app_data/google/locations
      příklad:
      9061121

    • location_name
      Typ: string

      úplný název lokality vyhledávače
      povinné pole, pokud nezadáte location_code
      pokud toto pole použijete, nemusíte zadávat location_code
      seznam dostupných lokalit vyhledávače s jejich location_name můžete získat samostatným požadavkem na https://api.dataforseo.com/v3/app_data/google/locations
      příklad:
      West Los Angeles,California,United States

    • pingback_url
      Typ: string | null

      URL oznámení o dokončení úlohy
      volitelné pole
      po dokončení úlohy vás budeme informovat požadavkem GET odeslaným na vámi zadanou URL
      řetězec „$id” můžete použít jako proměnnou $id a „$tag” jako proměnnou $tag kódovanou v URL. Před odesláním požadavku nastavíme potřebné hodnoty.
      příklad:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      Poznámka: speciální znaky v pingback_url budou kódovány v URL;
      mj. znak # bude zakódován jako %23

    • postback_data
      Typ: string

      datový typ postback_url
      povinné pole, pokud zadáte postback_url
      odpovídá datovému typu, který bude odeslán na váš server
      možné hodnoty:
      advanced, html

    • postback_url
      Typ: string | null

      URL pro odesílání výsledků úlohy
      volitelné pole
      po dokončení úlohy odešleme požadavek POST s výsledky komprimovanými ve formátu gzip na vámi zadanou postback_url
      řetězec „$id” můžete použít jako proměnnou $id a „$tag” jako proměnnou $tag kódovanou v URL. Před odesláním požadavku nastavíme potřebné hodnoty.
      příklad:
      http://your-server.com/postbackscript?id=$id
      http://your-server.com/postbackscript?id=$id&tag=$tag
      Poznámka: speciální znaky v postback_url budou kódovány v URL;
      mj. znak # bude zakódován jako %23

    • priority
      Typ: integer | null

      priorita úlohy
      volitelné pole
      může nabývat následujících hodnot:
      1 – normální priorita provedení (nastaveno ve výchozím nastavení)
      2 – vysoká priorita provedení. Za úlohy s vysokou prioritou provedení se účtuje příplatek.
      Náklady lze vypočítat na stránce Ceny.

    • 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_AppDataGoogleAppListTaskPostResponseInfo
    • 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_AppDataGoogleAppListTaskPostTaskInfo
        • 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: object | null

          pole výsledků
          v tomto případě bude hodnota null

        • 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_list/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/app_data/google/app_list/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "app_collection": "topselling_free",
    "location_code": 2840,
    "language_code": "en",
    "depth": 100
  }
]'

{
  "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": null
    }
  ]
}

Úspěšná operace

Setting Google App List Tasks