Configurer les tâches Google App List
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Configurer les tâches Google App List
Met en file d'attente l'une des collections sélectionnées de Google Play — gratuites, plus grosses recettes, tendances —, 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_google_app_list_fetch. C'est la vue classement ; pour une recherche par mot-clé, utilisez post_dataforseo_app_google_app_searches_submit.
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.
- Type: array (object | null)[]
- ageType: string | null
_rating filtrer les résultats par classification par âge
champ facultatif
vous pouvez utiliser ce champ pour filtrer les résultats par classification par âge ;
types de filtrage possibles :ages_up_to_5— renvoie les applications approuvées pour les enfants jusqu'à 5 ans ;ages_6_8— renvoie les applications approuvées pour les enfants de 6 à 8 ans ;ages_9_12— renvoie les applications approuvées pour les enfants de 9 à 12 ans ;
par défaut, l'API renvoie les applications pour tous les âges ;
Remarque : ce filtre ne fonctionne qu'avec le paramètre"category": "family" - appType: string | null
_category catégorie d'application sur Google Play
champ facultatif
vous pouvez filtrer les résultats par catégorie d'application ;
exemple :family;
vous pouvez obtenir la liste complète des catégories disponibles en effectuant une requête distincte vershttps://api.dataforseo.com/v3/app_data/google/categories
Remarque :app_categoryne peut pas être utilisé si le paramètreapp_collectionest défini surfeatured - appType: string
_collection collection d'applications
champ obligatoire
collection d'applications sur Google Play à partir de laquelle les applications seront collectées ;
vous pouvez spécifier les valeurs suivantes :featured,topselling_paid,topselling_free,topselling_new_free,topselling_new_paid,topgrossing,movers_shakers
Remarque : sifeaturedest sélectionné, le paramètreapp_categoryne peut pas être utilisé - depthType: integer | null
profondeur d'analyse
champ facultatif
nombre d'applications à renvoyer dans la réponse de l'API ;
nous recommandons vivement de définir la profondeur d'analyse par multiples de 100, car notre système traite 100 résultats d'affilée ;
valeur par défaut :100;
valeur maximale :200;
Votre compte sera facturé pour chaque SERP contenant jusqu'à 100 résultats ;
Définir une profondeur supérieure à 100 peut entraîner des frais supplémentaires si le moteur de recherche renvoie plus de 100 résultats ;
Le coût peut être calculé sur la page Pricing. - languageType: string
_code code de langue du moteur de recherche
champ obligatoire silanguage_namen'est pas spécifié
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlanguage_name
vous pouvez obtenir la liste des langues disponibles avec leurlanguage_codeen effectuant une requête distincte vershttps://api.dataforseo.com/v3/app_data/google/languages
exemple :en - languageType: string
_name nom complet de la langue du moteur de recherche
champ obligatoire silanguage_coden'est pas spécifié
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlanguage_code
vous pouvez obtenir la liste des langues disponibles aveclanguage_nameen effectuant une requête distincte vershttps://api.dataforseo.com/v3/app_data/google/languages
exemple :English - locationType: integer
_code code de localisation du moteur de recherche
champ obligatoire si vous ne spécifiez paslocation_name
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlocation_name
vous pouvez obtenir la liste des localisations disponibles du moteur de recherche avec leurlocation_codeen effectuant une requête distincte vershttps://api.dataforseo.com/v3/app_data/google/locations
exemple :9061121 - locationType: string
_name nom complet de la localisation du moteur de recherche
champ obligatoire si vous ne spécifiez paslocation_code
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlocation_code
vous pouvez obtenir la liste des localisations disponibles du moteur de recherche avec leurlocation_nameen effectuant une requête distincte vershttps://api.dataforseo.com/v3/app_data/google/locations
exemple :West Los Angeles,California,United States - pingbackType: string | null
_url 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$idet ‘$tag’ comme variable$tagencodée dans l'URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.
exemple :http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Remarque : les caractères spéciaux danspingback_urlseront encodés dans l'URL ;
notamment, le caractère#sera encodé en%23 - postbackType: string
_data type de données de postback_url
champ obligatoire si vous spécifiezpostback_url
correspond au type de données qui sera envoyé à votre serveur
valeurs possibles :advanced,html - postbackType: string | null
_url 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 formatgzipvers lepostback_urlque vous avez spécifié
vous pouvez utiliser la chaîne ‘$id’ comme variable$idet ‘$tag’ comme variable$tagencodée dans l'URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.
exemple :http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Remarque : les caractères spéciaux danspostback_urlseront encodés dans l'URL ;
notamment, le caractère#sera encodé en%23 - priorityType: integer | null
- tagType: string | null
identifiant de tâche défini par l'utilisateur
champ facultatif
la limite est de 255 caractères
vous pouvez utiliser ce paramètre pour identifier la tâche et l'associer au résultat
vous trouverez la valeurtagspécifiée dans l'objetdatade la réponse
- Type: object | null · Response36Afe1097B20_AppDataGoogleAppListTaskPostResponseInfo200
- Type: number | null Format: doublecost
coût total des tâches, USD
- Type: integer | nullstatus
_code code d'état général vous pouvez trouver la liste complète des codes de réponse ici
- Type: string | nullstatus
_message message d'information général vous pouvez trouver la liste complète des messages d'information généraux ici
- Type: array (object | null)[] | nulltasks
tableau de tâches
- Type: object | null · Response36Afe1097B20_AppDataGoogleAppListTaskPostTaskInfo
- costType: number | null Format: double
coût total des tâches, USD
- dataType: object | null
contient les mêmes paramètres que ceux spécifiés dans la requête POST
- propertyType: object | null
Name
- idType: string | null
identifiant de la tâche identifiant unique de la tâche dans notre système au format UUID
- pathType: array (string | null)[] | null
chemin de l'URL
- resultType: object | null
tableau de résultats
dans ce cas, la valeur seranull - resultType: integer | null Format: int64
_count nombre d'éléments dans le tableau de résultats
- statusType: integer | null
_code 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
- statusType: string | null
_message message d'information de la tâche vous pouvez trouver la liste complète des messages d'information généraux ici
- timeType: string | null
temps d'exécution, en secondes
- Type: integer | null Format: int64tasks
_count le nombre de tâches dans le tableau de tâches
- Type: integer | null Format: int64tasks
_error le nombre de tâches dans le tableau de tâches renvoyées avec une erreur
- Type: string | nulltime
temps d'exécution total, en secondes
- Type: string | nullversion
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
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
}
]
}