v0.2.0-beta

OpenAPI 3.1.0

Competidores de apps de Google Play en vivo

Felo API Support

MIT

Servidor

https://openapi.felo.ai

Bibliotecas cliente

Shell Curl

DataForSEO

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

DataForSEO Operaciones

post/v1/beta/dataforseo/dataforseo_labs/google/app_competitors/live

Competidores de apps de Google Play en vivo

Apps de Google Play que compiten con una app dada en palabras clave compartidas. Pagina con limit, offset y offset_token; usa el token después de las primeras páginas. Envuelto en el sobre de DataForSEO: los datos en tasks[0].result, el resultado en tasks[0].status_code; una solicitud rechazada sigue devolviendo HTTP 200. El equivalente de Apple es post_dataforseo_labs_apple_app_competitors_live. Para las palabras clave detrás de la superposición, usa post_dataforseo_labs_google_app_intersection_live.

Referencia de precios

Medición: Coste de la respuesta notificado.
Estimación de referencia por solicitud: USD 0.1356.
Multiplicador de referencia del cliente: 1.0. No volver a aplicarlo a un importe de cliente ya liquidado.

Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.

Cuerpo

application/json

Tipo: array (object | null)[]
- app_id
  Tipo: string
  
  id de la app
  campo obligatorio
  ID de la aplicación móvil en Google Play;
  puedes encontrar el ID en la URL de cada app listada en Google Play;
  ejemplo:
  en la URL https://play.google.com/store/apps/details?id=org.telegram.messenger
  el id es org.telegram.messenger
- filters
  Tipo: array (object | null)[] | null
  
  array de parámetros de filtrado de resultados
  campo opcional
  puedes añadir varios filtros a la vez (máximo 8 filtros)
  debes definir un operador lógico and, or entre las condiciones
  se admiten los siguientes operadores:
  <, <=, >, >=, =, <>, in, not_in
  ejemplo:
  ["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"]]
  
  para obtener más información sobre los filtros, consulta Dataforseo Labs - Filters o esta guía del Centro de ayuda
  
  Objeto vacío
- language_code
  Tipo: string | null
  
  código de idioma
  campo obligatorio si no especificas language_name
  Nota: es obligatorio especificar language_name o language_code
  puedes obtener la lista de idiomas disponibles con su language_code haciendo una solicitud independiente a la
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Nota: este endpoint actualmente solo admite el idioma inglés
  ejemplo:
  en
- language_name
  Tipo: string
  
  nombre completo del idioma
  campo obligatorio si no especificas language_code
  Nota: es obligatorio especificar language_name o language_code
  puedes obtener la lista de idiomas disponibles con su language_name haciendo una solicitud independiente a la
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Nota: este endpoint actualmente solo admite el idioma inglés;
  ejemplo:
  English
- limit
  Tipo: integer | null
  
  el número máximo de apps devueltas
  campo opcional
  valor predeterminado: 100
  valor máximo: 1000
- location_code
  Tipo: integer
  
  código de ubicación
  campo obligatorio si no especificas location_name
  Nota: es obligatorio especificar location_name o location_code
  puedes obtener la lista de ubicaciones disponibles con su location_code haciendo una solicitud independiente a
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Nota: este endpoint actualmente solo admite la ubicación de Estados Unidos;
  ejemplo:
  2840
- location_name
  Tipo: string
  
  nombre completo de la ubicación
  campo obligatorio si no especificas location_code
  Nota: es obligatorio especificar location_name o location_code
  puedes obtener la lista de ubicaciones disponibles con su location_name haciendo una solicitud independiente a
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Nota: este endpoint actualmente solo admite la ubicación de Estados Unidos;
  ejemplo:
  United States
- offset
  Tipo: integer | null
  
  desplazamiento en el array de resultados de las apps devueltas
  campo opcional
  valor predeterminado: 0
  si especificas el valor 10, se omitirán las diez primeras apps del array de resultados y los datos se proporcionarán para las palabras clave siguientes
- order_by
  Tipo: array string[] | null
  
  reglas de ordenación de los resultados
  campo opcional
  puedes usar los mismos valores que en el array filters para ordenar los resultados;
  tipos de ordenación posibles:
  asc - los resultados se ordenarán en orden ascendente;
  desc - los resultados se ordenarán en orden descendente;
  debes usar una coma para especificar un tipo de ordenación;
  ejemplo:
  ["intersections,asc"]
  Nota: puedes definir como máximo tres reglas de ordenación en una sola solicitud;
  debes usar una coma para separar varias reglas de ordenación;
  ejemplo:
  ["intersections,desc","sum_position,asc"]
  
  regla predeterminada:
  ["intersections,desc"]
  Nota: si el array item_types contiene tipos de elemento diferentes de organic, los resultados se ordenarán por el primer tipo de elemento del array
- tag
  Tipo: string | null
  
  identificador de tarea definido por el usuario
  campo opcional
  el límite de caracteres es 255
  puedes usar este parámetro para identificar la tarea y relacionarla con el resultado
  encontrarás el valor de tag especificado en el objeto data de la respuesta

Respuestas

200
Tipo: object | null · Response36Afe1097B20_DataforseoLabsGoogleAppCompetitorsLiveResponseInfo
cost
Tipo: number | null Formato: double

costo total de las tareas, USD

status_code
Tipo: integer | null

código de estado general puedes encontrar la lista completa de los códigos de respuesta aquí

status_message
Tipo: string | null

mensaje informativo general puedes encontrar la lista completa de los mensajes informativos generales aquí

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

array de tareas

Tipo: object | null · Response36Afe1097B20_DataforseoLabsGoogleAppCompetitorsLiveTaskInfo
cost
Tipo: number | null Formato: double

costo total de las tareas, USD

data
Tipo: object | null

contiene los mismos parámetros que especificaste en la solicitud POST

propertyName
Tipo: object | null
id
Tipo: string | null

identificador de la tarea identificador único de la tarea en nuestro sistema en formato UUID

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

ruta de la URL

result
Tipo: array (object | null)[] | null

array de resultados

app_id
Tipo: string | null

id de la app en un array POST

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

contiene datos relacionados con el app_id y las aplicaciones competidoras

app_id
Tipo: string | null

id de la app en un array POST

avg_position
Tipo: number | null Formato: float

posición media de la aplicación en la SERP de Google Play
Nota: la posición media se calcula solo para palabras clave en intersección;
el valor de una aplicación determinada puede variar cuando se combina con aplicaciones objetivo diferentes

competitor_metrics
Tipo: object | null

métricas para palabras clave en intersección
datos de ranking relevantes para las palabras clave que la aplicación competidora proporcionada comparte con la aplicación en una solicitud POST;
nota: en este array, los datos de ranking se proporcionan para el app_id del competidor devuelto

propertyName
Tipo: object · Response36Afe1097B20_AppMetricsInfo
count
Tipo: integer | null Formato: int64

recuento total de SERP orgánicas de Amazon que contienen el producto

pos_1
Tipo: integer | null

número de SERP orgánicas en las que el producto ocupa la posición #1

pos_11_100
Tipo: integer | null

número de SERP orgánicas en las que el producto ocupa las posiciones #11-100

pos_2_3
Tipo: integer | null

número de SERP orgánicas en las que el producto ocupa las posiciones #2-3

pos_4_10
Tipo: integer | null

número de SERP orgánicas en las que el producto ocupa las posiciones #4-10

search_volume
Tipo: integer | null Formato: int64

volumen total de búsqueda de las palabras clave de posicionamiento del producto en la SERP orgánica

full_metrics
Tipo: object | null

métricas para todas las palabras clave de la aplicación
visión completa de los datos de ranking relevantes para todas las palabras clave para las que posiciona el app_id proporcionado

propertyName
Tipo: object · Response36Afe1097B20_AppMetricsInfo
count
Tipo: integer | null Formato: int64

recuento total de SERP orgánicas de Amazon que contienen el producto

pos_1
Tipo: integer | null

número de SERP orgánicas en las que el producto ocupa la posición #1

pos_11_100
Tipo: integer | null

número de SERP orgánicas en las que el producto ocupa las posiciones #11-100

pos_2_3
Tipo: integer | null

número de SERP orgánicas en las que el producto ocupa las posiciones #2-3

pos_4_10
Tipo: integer | null

número de SERP orgánicas en las que el producto ocupa las posiciones #4-10

search_volume
Tipo: integer | null Formato: int64

volumen total de búsqueda de las palabras clave de posicionamiento del producto en la SERP orgánica

intersections
Tipo: integer | null

número de palabras clave en intersección

se_type
Tipo: string | null

tipo de motor de búsqueda

sum_position
Tipo: integer | null

suma de todas las posiciones de la aplicación en la SERP de Google Play
Nota: la posición de la suma se calcula solo para palabras clave en intersección;
el valor de una aplicación determinada puede variar cuando se combina con aplicaciones objetivo diferentes

items_count
Tipo: integer | null Formato: int64

el número de resultados devueltos en el array items

language_code
Tipo: string | null

código de idioma en un array POST

location_code
Tipo: integer | null

código de ubicación en un array POST

se_type
Tipo: string | null

tipo de motor de búsqueda

total_count
Tipo: integer | null Formato: int64

cantidad total de resultados de nuestra base de datos relevantes para tu solicitud

result_count
Tipo: integer | null Formato: int64

número de elementos en el array de resultados

status_code
Tipo: integer | null

código de estado de la tarea generado por DataForSEO; puede estar dentro del siguiente intervalo: 10000-60000 puedes encontrar la lista completa de los códigos de respuesta aquí

status_message
Tipo: string | null

mensaje informativo de la tarea puedes encontrar la lista completa de los mensajes informativos generales aquí

time
Tipo: string | null

tiempo de ejecución, segundos

tasks_count
Tipo: integer | null Formato: int64

el número de tareas en el array de tareas

tasks_error
Tipo: integer | null Formato: int64

el número de tareas en el array de tareas devueltas con un error

time
Tipo: string | null

tiempo total de ejecución, en segundos

version
Tipo: string | null

la versión actual de la API
application/json
400

No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.
401

Se requiere una clave de API de Felo válida.
402

La solicitud no puede continuar porque no se cumple un requisito de facturación.
403

La cuenta no tiene permiso para realizar esta operación.
429

Se ha alcanzado un límite de solicitudes o de gasto.
502

El servicio no pudo completar la solicitud.
503

La API o el servicio de facturación no están disponibles temporalmente.
504

El servicio agotó el tiempo de espera al procesar la solicitud.
default

Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor

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

Mostrar esquema

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

Operación correcta

Competidores de apps de Google Play en vivo

AutenticaciónRequired

DataForSEO

Competidores de apps de Google Play en vivo

Referencia de precios