v0.2.0-beta

OpenAPI 3.1.0

Concurrents d'apps Google Play en direct

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/dataforseo_labs/google/app_competitors/live

Concurrents d'apps Google Play en direct

Apps Google Play en concurrence avec une app donnée sur des mots-clés partagés. Paginez avec limit, offset et offset_token ; utilisez le jeton au-delà des premières pages. Enveloppé dans l'enveloppe DataForSEO : les données dans tasks[0].result, l'issue dans tasks[0].status_code — une requête rejetée renvoie tout de même HTTP 200. L'équivalent Apple est post_dataforseo_labs_apple_app_competitors_live. Pour les mots-clés derrière le recouvrement, utilisez post_dataforseo_labs_google_app_intersection_live.

Référence tarifaire

Facturation : coût de réponse déclaré.
Estimation de référence par requête : USD 0.1356.
Multiplicateur de référence client : 1.0. Ne pas l'appliquer une seconde fois à 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_id
  Type: string
  
  id de l'application
  champ obligatoire
  ID de l'application mobile sur Google Play ;
  vous pouvez trouver l'ID dans l'URL de chaque application listée sur Google Play ;
  exemple :
  dans l'URL https://play.google.com/store/apps/details?id=org.telegram.messenger
  l'id est org.telegram.messenger
- filters
  Type: array (object | null)[] | null
  
  tableau de paramètres de filtrage des résultats
  champ facultatif
  vous pouvez ajouter plusieurs filtres à la fois (8 filtres maximum)
  vous devez définir un opérateur logique and, or entre les conditions
  les opérateurs suivants sont pris en charge :
  <, <=, >, >=, =, <>, in, not_in
  exemple :
  ["intersections",">",500]
  
  [["competitor_metrics.google_play_search_organic.pos_1","<>",10],"and",["avg_position",">=","10"]]
  
  [[["intersections",">=",50],"and",["competitor_metrics.google_play_search_organic.pos_1","in",[1,5]]], "or", ["sum_position",">=","10000"]]
  
  pour plus d'informations sur les filtres, consultez Dataforseo Labs - Filters ou ce guide du centre d'aide
  
  Objet vide
- language_code
  Type: string | null
  
  code de langue
  champ obligatoire si vous n'indiquez pas language_name
  Remarque : il est obligatoire de spécifier language_name ou language_code
  vous pouvez obtenir la liste des langues disponibles avec leur language_code en effectuant une requête distincte vers
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages ;
  Remarque : ce point de terminaison ne prend actuellement en charge que la langue anglaise
  exemple :
  en
- language_name
  Type: string
  
  nom complet de la langue
  champ obligatoire si vous n'indiquez pas language_code
  Remarque : il est obligatoire de spécifier language_name ou language_code
  vous pouvez obtenir la liste des langues disponibles avec leur language_name en effectuant une requête distincte vers
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages ;
  Remarque : ce point de terminaison ne prend actuellement en charge que la langue anglaise ;
  exemple :
  English
- limit
  Type: integer | null
  
  le nombre maximal d'applications renvoyées
  champ facultatif
  valeur par défaut : 100
  valeur maximale : 1000
- location_code
  Type: integer
  
  code d'emplacement
  champ obligatoire si vous n'indiquez pas location_name
  Remarque : il est obligatoire de spécifier location_name ou location_code
  vous pouvez obtenir la liste des emplacements disponibles avec leur location_code en effectuant une requête distincte vers
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages ;
  Remarque : ce point de terminaison ne prend actuellement en charge que l'emplacement des États-Unis ;
  exemple :
  2840
- location_name
  Type: string
  
  nom complet de l'emplacement
  champ obligatoire si vous n'indiquez pas location_code
  Remarque : il est obligatoire de spécifier location_name ou location_code
  vous pouvez obtenir la liste des emplacements disponibles avec leur location_name en effectuant une requête distincte vers
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages ;
  Remarque : ce point de terminaison ne prend actuellement en charge que l'emplacement des États-Unis ;
  exemple :
  United States
- offset
  Type: integer | null
  
  décalage dans le tableau de résultats des applications renvoyées
  champ facultatif
  valeur par défaut : 0
  si vous indiquez la valeur 10, les dix premières applications du tableau de résultats seront omises et les données seront fournies pour les mots-clés suivants
- order_by
  Type: array string[] | null
  
  règles de tri des résultats
  champ facultatif
  vous pouvez utiliser les mêmes valeurs que dans le tableau filters pour trier les résultats ;
  types de tri possibles :
  asc - les résultats seront triés par ordre croissant ;
  desc - les résultats seront triés par ordre décroissant ;
  vous devez utiliser une virgule pour indiquer un type de tri ;
  exemple :
  ["intersections,asc"]
  Remarque : vous pouvez définir au maximum trois règles de tri dans une seule requête ;
  vous devez utiliser une virgule pour séparer plusieurs règles de tri ;
  exemple :
  ["intersections,desc","sum_position,asc"]
  
  règle par défaut :
  ["intersections,desc"]
  Remarque : si le tableau item_types contient des types d'élément autres que organic, les résultats seront triés selon le premier type d'élément du tableau
- tag
  Type: 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 valeur tag spécifiée dans l'objet data de la réponse

Réponses

200
Type: object | null · Response36Afe1097B20_DataforseoLabsGoogleAppCompetitorsLiveResponseInfo
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_DataforseoLabsGoogleAppCompetitorsLiveTaskInfo
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: array (object | null)[] | null

tableau de résultats

app_id
Type: string | null

id de l'app dans un tableau POST

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

contient les données associées à l'app_id et aux applications concurrentes

app_id
Type: string | null

id de l'app dans un tableau POST

avg_position
Type: number | null Format: float

position moyenne de l'application dans la SERP Google Play
Remarque : la position moyenne est calculée uniquement pour les mots-clés en intersection ;
la valeur d'une application donnée peut différer lorsqu'elle est combinée à des applications cibles différentes

competitor_metrics
Type: object | null

métriques des mots-clés en intersection
données de classement relatives aux mots-clés que l'application concurrente fournie partage avec l'application dans une requête POST ;
remarque : dans ce tableau, les données de classement sont fournies pour l'app_id du concurrent renvoyé

propertyName
Type: object · Response36Afe1097B20_AppMetricsInfo
count
Type: integer | null Format: int64

nombre total de SERP organiques Amazon contenant le produit

pos_1
Type: integer | null

nombre de SERP organiques où le produit occupe la position #1

pos_11_100
Type: integer | null

nombre de SERP organiques où le produit occupe les positions #11-100

pos_2_3
Type: integer | null

nombre de SERP organiques où le produit occupe les positions #2-3

pos_4_10
Type: integer | null

nombre de SERP organiques où le produit occupe les positions #4-10

search_volume
Type: integer | null Format: int64

volume de recherche total des mots-clés de classement du produit dans la SERP organique

full_metrics
Type: object | null

métriques de tous les mots-clés de l'application
aperçu complet des données de classement relatives à tous les mots-clés pour lesquels l'app_id fourni est classé

propertyName
Type: object · Response36Afe1097B20_AppMetricsInfo
count
Type: integer | null Format: int64

nombre total de SERP organiques Amazon contenant le produit

pos_1
Type: integer | null

nombre de SERP organiques où le produit occupe la position #1

pos_11_100
Type: integer | null

nombre de SERP organiques où le produit occupe les positions #11-100

pos_2_3
Type: integer | null

nombre de SERP organiques où le produit occupe les positions #2-3

pos_4_10
Type: integer | null

nombre de SERP organiques où le produit occupe les positions #4-10

search_volume
Type: integer | null Format: int64

volume de recherche total des mots-clés de classement du produit dans la SERP organique

intersections
Type: integer | null

nombre de mots-clés en intersection

se_type
Type: string | null

type de moteur de recherche

sum_position
Type: integer | null

somme de toutes les positions de l'application dans la SERP Google Play
Remarque : la position de la somme est calculée uniquement pour les mots-clés en intersection ;
la valeur d'une application donnée peut différer lorsqu'elle est combinée à des applications cibles différentes

items_count
Type: integer | null Format: int64

le nombre de résultats renvoyés dans le tableau items

language_code
Type: string | null

code de langue dans un tableau POST

location_code
Type: integer | null

code de localisation dans un tableau POST

se_type
Type: string | null

type de moteur de recherche

total_count
Type: integer | null Format: int64

quantité totale de résultats de notre base de données correspondant à votre requête

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/dataforseo_labs/google/app_competitors/live

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/app_competitors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "app_id": "org.telegram.messenger",
    "language_name": "English",
    "location_code": 2840,
    "limit": 10
  }
]'

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": [
        {
          "se_type": null,
          "app_id": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "app_id": null,
              "avg_position": null,
              "sum_position": null,
              "intersections": null,
              "competitor_metrics": null,
              "full_metrics": null
            }
          ]
        }
      ]
    }
  ]
}

Opération réussie

Concurrents d'apps Google Play en direct

AuthentificationRequired

DataForSEO

Concurrents d'apps Google Play en direct

Référence tarifaire