v0.2.0-beta

OpenAPI 3.1.0

Configurer les tâches Apple App List

Felo API Support

MIT

Serveur

https://openapi.felo.ai

Bibliothèques clientes

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Opérations

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

Configurer les tâches Apple App List

Met en file d'attente l'une des collections sélectionnées de l'App Store, choisie avec app_collection, et renvoie un id de tâche. depth limite la profondeur de lecture du classement. Asynchrone : la soumission renvoie un id de tâche dans tasks[0].id et l'outil de récupération renvoie le résultat une fois prêt. Récupérez avec get_dataforseo_app_apple_app_list_fetch. Aucune variante HTML n'existe côté Apple.

Référence tarifaire

Mesure : coût de réponse déclaré.
Estimation de référence par requête : USD 0.012.
Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à un montant client déjà réglé.

Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.

Corps

application/json

Type: array (object | null)[]
- app_category
  Type: string | null
  
  catégorie d'application sur l'App Store champ facultatif vous pouvez filtrer les résultats par catégorie d'application ; exemple : lifestyle ; vous pouvez consulter la liste complète des catégories disponibles ici ou en effectuant une requête distincte vers https://api.dataforseo.com/v3/app_data/apple/categories
- app_collection
  Type: string
  
  collection d'applications champ obligatoire collection d'applications sur l'App Store à partir de laquelle les applications seront collectées ; vous pouvez spécifier les valeurs suivantes : top_free_ios, top_paid_ios, top_grossing_ios, new_ios, new_free_ios, new_paid_ios
- depth
  Type: integer | null
  
  profondeur d'analyse champ facultatif nombre d'applications à renvoyer depuis le SERP de l'App Store ; valeur par défaut : 100 valeur maximale : 100 Votre compte sera facturé pour chaque SERP contenant jusqu'à 100 résultats ; Le coût peut être calculé sur la page Pricing.
- language_code
  Type: string | null
  
  code de langue du moteur de recherche champ obligatoire si vous ne spécifiez pas language_name si vous utilisez ce champ, vous n'avez pas besoin de spécifier language_name vous pouvez obtenir la liste des langues disponibles avec leur language_code en effectuant une requête distincte vers https://api.dataforseo.com/v3/app_data/apple/languages exemple : en
- language_name
  Type: string | null
  
  nom complet de la langue du moteur de recherche champ obligatoire si vous ne spécifiez pas language_code si vous utilisez ce champ, vous n'avez pas besoin de spécifier language_code vous pouvez obtenir la liste des langues disponibles avec language_name en effectuant une requête distincte vers https://api.dataforseo.com/v3/app_data/apple/languages exemple : English
- location_code
  Type: integer | null
  
  code de localisation du moteur de recherche champ obligatoire si vous ne spécifiez pas location_name si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_name vous pouvez obtenir la liste des localisations disponibles du moteur de recherche avec leur location_code en effectuant une requête distincte vers https://api.dataforseo.com/v3/app_data/apple/locations exemple : 9061121
- location_name
  Type: string | null
  
  nom complet de la localisation du moteur de recherche champ obligatoire si vous ne spécifiez pas location_code si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_code vous pouvez obtenir la liste des localisations disponibles du moteur de recherche avec leur location_name en effectuant une requête distincte vers https://api.dataforseo.com/v3/app_data/apple/locations exemple : West Los Angeles,California,United States
- pingback_url
  Type: string | null
  
  URL de notification d'une tâche terminée champ facultatif lorsqu'une tâche est terminée, nous vous en informons par une requête GET envoyée à l'URL que vous avez spécifiée vous pouvez utiliser la chaîne ‘$id’ comme variable $id et ‘$tag’ comme variable $tag encodée dans l'URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête. exemple : http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag Remarque : les caractères spéciaux dans pingback_url seront encodés dans l'URL ; notamment, le caractère # sera encodé en %23 en savoir plus sur notre centre d'aide
- postback_data
  Type: string | null
  
  type de données de postback_url champ obligatoire si vous spécifiez postback_url correspond au type de données qui sera envoyé à votre serveur valeurs possibles : advanced
- postback_url
  Type: string | null
  
  URL d'envoi des résultats de la tâche champ facultatif une fois la tâche terminée, nous envoyons une requête POST avec ses résultats compressés au format gzip vers le postback_url que vous avez spécifié vous pouvez utiliser la chaîne ‘$id’ comme variable $id et ‘$tag’ comme variable $tag encodée dans l'URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête. exemple : http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag Remarque : les caractères spéciaux dans postback_url seront encodés dans l'URL ; notamment, le caractère # sera encodé en %23 en savoir plus sur notre centre d'aide
- priority
  Type: integer | null
  
  priorité de la tâche champ facultatif peut prendre les valeurs suivantes : 1 – priorité d'exécution normale (définie par défaut) 2 – priorité d'exécution élevée Vous serez facturé un supplément pour les tâches à priorité d'exécution élevée. Le coût peut être calculé sur la page Pricing.
- tag
  Type: string | null
  
  identifiant de tâche défini par l'utilisateur champ facultatif la limite de caractères est 255 vous pouvez utiliser ce paramètre pour identifier la tâche et la faire correspondre au résultat vous trouverez la valeur tag spécifiée dans l'objet data de la réponse

Réponses

200
Type: object | null · Response36Afe1097B20_AppDataAppleAppListTaskPostResponseInfo
cost
Type: number | null Format: double

coût total des tâches, USD

status_code
Type: integer | null

code d'état général vous pouvez trouver la liste complète des codes de réponse ici

status_message
Type: string | null

message d'information général vous pouvez trouver la liste complète des messages d'information généraux ici

tasks
Type: array (object | null)[] | null

tableau de tâches

Type: object | null · Response36Afe1097B20_AppDataAppleAppListTaskPostTaskInfo
cost
Type: number | null Format: double

coût total des tâches, USD

data
Type: object | null

contient les mêmes paramètres que ceux spécifiés dans la requête POST

propertyName
Type: object | null
id
Type: string | null

identifiant de la tâche identifiant unique de la tâche dans notre système au format UUID

path
Type: array (string | null)[] | null

chemin de l'URL

result
Type: object | null

tableau de résultats dans ce cas, la valeur sera null

result_count
Type: integer | null Format: int64

nombre d'éléments dans le tableau de résultats

status_code
Type: integer | null

code d'état de la tâche généré par DataForSEO ; peut être compris dans la plage suivante : 10000-60000 vous pouvez trouver la liste complète des codes de réponse ici

status_message
Type: string | null

message d'information de la tâche vous pouvez trouver la liste complète des messages d'information généraux ici

time
Type: string | null

temps d'exécution, en secondes

tasks_count
Type: integer | null Format: int64

le nombre de tâches dans le tableau de tâches

tasks_error
Type: integer | null Format: int64

le nombre de tâches dans le tableau de tâches renvoyées avec une erreur

time
Type: string | null

temps d'exécution total, en secondes

version
Type: string | null

la version actuelle de l'API
application/json
400

La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.
401

Une clé API Felo valide est requise.
402

La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.
403

Le compte n'est pas autorisé à effectuer cette opération.
429

Une limite de requêtes ou de dépenses a été atteinte.
502

Le service n'a pas pu terminer la requête.
503

L'API ou le service de facturation est temporairement indisponible.
504

Le service a expiré lors du traitement de la requête.
default

Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur

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"
  }
]'

Afficher le 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
    }
  ]
}

Opération réussie

Configurer les tâches Apple App List

AuthentificationRequired

DataForSEO

Configurer les tâches Apple App List

Référence tarifaire