API de Búsqueda de App Store

POST

Salud de la API

Salud 24 h
Normal
Tiempo medio 24 h
—
Última comprobación
26 de septiembre de 2026 a las 18:04 (UTC)
  • Saludable / normal
  • Disponible
  • Limitada
  • Casi sin servicio
API de saludNormal
Cómo se mide la salud
  • Salud = porcentaje de llamadas que devolvieron datos. Los resultados vacíos, los fallos y los resultados desconocidos no cuentan como datos devueltos.
  • Niveles: desde 90 % saludable, desde 70 % disponible, desde 40 % limitada; por debajo, casi sin servicio.
  • Un periodo (las últimas 24 horas, una hora o un día) solo se puntúa a partir de 50 llamadas. Los periodos con menos llamadas se muestran como normales: unos pocos fallos entre pocas llamadas no significan que la API esté caída.
  • Las llamadas incluyen las reales de clientes y nuestras llamadas de sondeo diarias. Los errores de la propia solicitud (parámetros incorrectos, saldo insuficiente) no se cuentan.
  • El tiempo medio solo cuenta las llamadas que terminaron con normalidad: tiempo de respuesta en las síncronas; de la aceptación a la finalización en las asíncronas.
Por periodo
Hora (UTC)EstadoSaludTiempo medio
2026-09-26 18:00 - 18:59Normal——
2026-09-26 17:00 - 17:59Normal——
2026-09-26 16:00 - 16:59Normal——
2026-09-26 15:00 - 15:59Normal——
2026-09-26 14:00 - 14:59Normal——
2026-09-26 13:00 - 13:59Normal——
2026-09-26 12:00 - 12:59Normal——
2026-09-26 11:00 - 11:59Normal——
2026-09-26 10:00 - 10:59Normal——
2026-09-26 09:00 - 09:59Normal——
2026-09-26 08:00 - 08:59Normal——
2026-09-26 07:00 - 07:59Normal——
2026-09-26 06:00 - 06:59Normal——
2026-09-26 05:00 - 05:59Normal——
2026-09-26 04:00 - 04:59Normal——
2026-09-26 03:00 - 03:59Normal——
2026-09-26 02:00 - 02:59Normal——
2026-09-26 01:00 - 01:59Normal——
2026-09-26 00:00 - 00:59Normal——
2026-09-25 23:00 - 23:59Normal——
2026-09-25 22:00 - 22:59Normal——
2026-09-25 21:00 - 21:59Normal——
2026-09-25 20:00 - 20:59Normal——
2026-09-25 19:00 - 19:59Normal——
2026-09-26Normal——
2026-09-25Normal——
2026-09-24Normal——
2026-09-23Normal——
2026-09-22Normal——
2026-09-21Normal——
2026-09-20Normal——
2026-09-19Normal——
2026-09-18Normal——
2026-09-17Normal——
2026-09-16Normal——
2026-09-15Normal——
2026-09-14Normal——
2026-09-13Normal——
2026-09-12Normal——
2026-09-11Normal——
2026-09-10Normal——
2026-09-09Normal——
2026-09-08Normal——
2026-09-07Normal——
2026-09-06Normal——
2026-09-05Normal——
2026-09-04Normal——
2026-09-03Normal——
2026-09-02Normal——
2026-09-01Normal——
2026-08-31Normal——
2026-08-30Normal——
2026-08-29Normal——
2026-08-28Normal——

keyword acepta el nombre o la categoría que se quiere explorar. La respuesta separa app_id, bundle_id, aplicación, desarrollador, versión, precio y valoraciones; no devuelve descargas, ingresos o un historial de posiciones por palabra clave.

Precio $1.39 por 1.000 solicitudes ($0.001389 por llamada). Las llamadas fallidas y los resultados vacíos no se cobran. Síncrona. Para tareas lentas añade "mode": "async" al cuerpo, recibe un job_id y consúltalo.

Parámetros de la solicitud

NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código.
platformbodystringSíapp_storeIdentificador de la plataforma, valor fijo.
actionbodystringSísearchIdentificador de la capacidad, valor fijo.
keywordbody.paramsNo declaradoSí-Término de búsqueda de aplicaciones en la App Store, como «habit tracker» o el nombre de la aplicación. No es el Bundle ID. El app_id de los resultados de búsqueda se puede usar después para obtener detalles y reseñas de la app.
countrybody.paramsNo declaradoNo-Selecciona la tienda regional de App Store para search, profile y reviews mediante un código de país de dos letras en minúsculas, como us, cn o jp. El valor predeterminado es us. Cambia la tienda consultada, no la región de la cuenta ni la facturación de EveryInfra.
limitbody.paramsinteger (1–200)No20

Ejemplos de código

bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "app_store",
  "action": "search",
  "params": {
    "keyword": "habit tracker"
  }
}'

[Definición OpenAPI (JSON)]Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.

Ejemplo de respuesta

Respuesta real

Obtenida el 26 de septiembre de 2026 a las 08:56 (UTC) llamando a esta API con los parámetros del ejemplo de código de arriba. results y count son la respuesta real de esa llamada, sin información personal (nombres, usuarios, avatares, enlaces de perfil, datos de contacto); la lista conserva los primeros 2. id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.

json
{
  "id": "req_…",
  "platform": "app_store",
  "action": "search",
  "results": [
    {
      "app_id": 1438388363,
      "name": "Habit Tracker",
      "url": "https://apps.apple.com/us/app/habit-tracker/id1438388363?uo=4",
      "bundle_id": "com.davetech.habit",
      "developer": "InnerGrow",
      "developer_url": "https://apps.apple.com/us/developer/innergrow/id1828382777?uo=4",
      "description": "Habit Tracker: A simple daily planner to schedule and track your routine, making it easy to build lasting habits. \nJoin 15M+ happy users, achieve your goals, and make every day count!\nMore than a self-care companion, it lets you share with others to grow and improve together. \n\n-…",
      "release_notes": "- add shortcut supports \n- add custom repeat interval \n- fix bugs\n----- Beta Tester needed -----\nIf you want to help us to test new version, contact us: (已隐去)\nIf your widget is not working, restart your iPhone.\nOur IG: Tiny Useful Apps",
      "version": "2.14.23",
      "price": 0,
      "currency": "USD",
      "formatted_price": "Free",
      "rating": 4.79,
      "rating_count": 147260,
      "current_version_rating_count": 147260,
      "content_rating": "4+",
      "category": "Productivity",
      "icon_url": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/d3/ef/00/d3ef00c2-9b1c-b5ef-0464-2e08231b80de/AppIcon-pink-gr-0-0-1x_U007epad-0-1-0-sRGB-85-220.png/512x512bb.jpg",
      "min_os": "15.0",
      "file_size_bytes": 339836928,
      "released_at": "2019-01-31T09:10:14+00:00",
      "updated_at": "2026-08-15T15:18:18+00:00",
      "platform": "app_store",
      "genres": [
        "Productivity",
        "Health & Fitness"
      ],
      "languages": [
        "EN",
        "FR",
        "DE"
      ],
      "screenshot_urls": [
        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/5c/b8/05/5cb8051e-e125-e84e-f0b5-2551b6e9d69d/_U767d1.jpg/320x480bb.jpg",
        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/13/5d/32/135d32df-678d-5c7e-d940-4f16d5c4e396/_U767d2.jpg/320x480bb.jpg",
        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/2e/a8/66/2ea866a0-2271-4d8a-e380-8386b935283f/_U767d3.jpg/320x480bb.jpg"
      ],
      "rating_scale": 5
    },
    {
      "app_id": 6443918070,
      "name": "Habit Tracker - HabitKit",
      "url": "https://apps.apple.com/us/app/habit-tracker-habitkit/id6443918070?uo=4",
      "bundle_id": "com.roehl.habitkit",
      "developer": "Sebastian Roehl",
      "developer_url": "https://apps.apple.com/us/developer/sebastian-roehl/id1602956482?uo=4",
      "description": "Big life changes do not start big. They start with one small habit, done today, done again tomorrow. HabitKit turns those daily wins into a colorful grid of tiles, one square for every day you show up, so you can finally see yourself becoming the person you want to be.\n\nThat visi…",
      "release_notes": "- Choose Yes/No, Count or Measure with decimals and custom units\n- Change habit types without losing history or streaks\n- At a Count goal above 1, tap to edit instead of clearing\n- New iOS Shortcuts to log amounts and notes, get progress and open habits; translated labels and cle…",
      "version": "1.18.0",
      "price": 0,
      "currency": "USD",
      "formatted_price": "Free",
      "rating": 4.85,
      "rating_count": 2430,
      "current_version_rating_count": 2430,
      "content_rating": "4+",
      "category": "Productivity",
      "icon_url": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/79/91/fe/7991fe78-b459-1397-205f-54525a639bde/NewAppIcon-0-0-1x_U007ephone-0-1-sRGB-85-220.png/512x512bb.jpg",
      "min_os": "15.0",
      "file_size_bytes": 230910976,
      "released_at": "2022-11-26T08:00:00+00:00",
      "updated_at": "2026-09-21T08:40:41+00:00",
      "platform": "app_store",
      "genres": [
        "Productivity"
      ],
      "languages": [
        "AR",
        "BE",
        "CA"
      ],
      "screenshot_urls": [
        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/cb/27/c1/cb27c143-49f7-12ba-a1f1-68fd4caf0634/Apple_iPhone_11_Pro_Max_Screenshot_0.png/320x480bb.jpg",
        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/18/ba/4e/18ba4eac-d29a-94ae-88a5-92204e14eb24/Apple_iPhone_11_Pro_Max_Screenshot_1.png/320x480bb.jpg",
        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/23/59/4e/23594e53-c451-7772-0dbb-7cd58b8470bb/Apple_iPhone_11_Pro_Max_Screenshot_2.png/320x480bb.jpg"
      ],
      "rating_scale": 5
    }
  ],
  "count": 18,
  "billing": { … },
  "quota": { … }
}

Campos de la respuesta

Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la fuente no ofrece nunca se inventan.

CampoSignificado
app_idConserva el significado de la plataforma
nameNombre del propio objeto, en capacidades de cuentas, productos y negocios.
urlEnlace al registro en la plataforma de origen.
bundle_idConserva el significado de la plataforma
developerConserva el significado de la plataforma
developer_idConserva el significado de la plataforma
developer_urlConserva el significado de la plataforma
descriptionResumen o descripción, normalmente más breve que text.
release_notesConserva el significado de la plataforma
versionConserva el significado de la plataforma
pricePrecio como número, sin símbolo de moneda; ver currency.
currencyCódigo de moneda del precio (por ejemplo CNY, USD). Si hay price pero currency es null, no supongas una moneda.
formatted_priceConserva el significado de la plataforma
ratingValoración. La escala depende de la plataforma: rating_scale en la misma fila indica el máximo (normalmente 5; Booking, Douban, iQIYI y NAVER usan 10). Convierte con rating_scale antes de comparar entre plataformas o la comparación puede salir al revés.
rating_scaleMáximo de rating en la misma fila: 5 en escalas de cinco estrellas y 10 en escalas de diez puntos. Solo aparece si la fila tiene rating.
rating_countNúmero de personas que valoraron. null significa no publicado, no 0.
current_version_ratingConserva el significado de la plataforma
current_version_rating_countConserva el significado de la plataforma
content_ratingConserva el significado de la plataforma
categoryNombre de la categoría según la taxonomía de la plataforma de origen, sin normalizar entre plataformas.
icon_urlConserva el significado de la plataforma
min_osConserva el significado de la plataforma
file_size_bytesConserva el significado de la plataforma
released_atConserva el significado de la plataforma
updated_atConserva el significado de la plataforma
platformIdentificador de la plataforma de origen, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).
genresConserva el significado de la plataforma
languagesConserva el significado de la plataforma
screenshot_urlsConserva el significado de la plataforma

Errores y facturación

401
Falta la clave o no es válida. La autenticación se comprueba antes que los parámetros, así que las solicitudes sin autenticar no ven el esquema de parámetros.
422
Nombre o valor de parámetro incorrecto. El error enumera los parámetros y valores permitidos de esta capacidad y la opción más cercana; ocurre antes de cualquier cobro.
402
Saldo insuficiente. Recarga primero.
429
Se alcanzó el límite de solicitudes por minuto. Espera lo que indique Retry-After y vuelve a intentarlo.
503
No se pudo completar ahora. Cualquier cargo de la llamada vuelve automáticamente a tu saldo, y el recibo de facturación de la respuesta indica el resultado real, también cuando aún no se conoce. No reenvíes a ciegas.
200 vacío
La solicitud terminó sin datos y no se cobra (billing.reason = empty_result_refunded).