v0.2.0-beta

OpenAPI 3.1.0

Nastavení úloh seznamu aplikací Apple

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/app_data/apple/app_list/task_post

Nastavení úloh seznamu aplikací Apple

Zařadí jednu z kurátorovaných kolekcí App Store, 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_apple_app_list_fetch. V části Apple neexistuje varianta HTML.

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)[]
- app_category
  Typ: string | null
  
  Kategorie aplikace v App Store. Volitelné pole. Výsledky můžete filtrovat podle kategorie aplikace; příklad: lifestyle; úplný seznam dostupných kategorií si můžete prohlédnout zde nebo jej získat samostatným požadavkem na https://api.dataforseo.com/v3/app_data/apple/categories.
- app_collection
  Typ: string
  
  Kolekce aplikací. Povinné pole. Kolekce v App Store, ze které budou aplikace shromažďovány; můžete zadat následující hodnoty: top_free_ios, top_paid_ios, top_grossing_ios, new_ios, new_free_ios, new_paid_ios.
- depth
  Typ: integer | null
  
  Hloubka parsování. Volitelné pole. Počet aplikací vrácených ze SERP App Store; výchozí hodnota: 100; maximální hodnota: 100. Váš účet bude účtován za každý SERP obsahující až 100 výsledků. Náklady lze vypočítat na stránce Ceny.
- language_code
  Typ: string | null
  
  Kód jazyka vyhledávače. Povinné pole, pokud nezadáte 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/apple/languages. Příklad: en.
- language_name
  Typ: string | null
  
  Úplný název jazyka vyhledávače. Povinné pole, pokud nezadáte 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/apple/languages. Příklad: English.
- location_code
  Typ: integer | null
  
  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/apple/locations. Příklad: 9061121.
- location_name
  Typ: string | null
  
  Ú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/apple/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. Více informací najdete v naší nápovědě.
- postback_data
  Typ: string | null
  
  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.
- 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. Více informací najdete v naší nápovědě.
- 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. Pomocí tohoto parametru můžete úlohu identifikovat a spárovat ji s výsledkem. Zadanou hodnotu tag najdete v objektu data odpovědi.

Odpovědi

200
Typ: object | null · Response36Afe1097B20_AppDataAppleAppListTaskPostResponseInfo
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_AppDataAppleAppListTaskPostTaskInfo
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

post/v1/beta/dataforseo/app_data/apple/app_list/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/app_data/apple/app_list/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "app_collection": "top_free_ios",
    "location_code": 2840,
    "language_code": "en",
    "app_category": "games"
  }
]'

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

Úspěšná operace

Nastavení úloh seznamu aplikací Apple

OvěřováníRequired

DataForSEO

Nastavení úloh seznamu aplikací Apple

Cenová reference