apple-app-store/
rankings

Recopile clasificaciones públicas por categoría de Apple App Store a partir de URL conocidas de listas de apps.apple.com y obtenga la posición, la identidad de la app, metadatos de la tienda y contenido multimedia en registros normalizados.

Apple App Store Rankings API

URL de listas por categoría
Posición de origen
Registros de apps normalizados
0.15 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

Apple App Store Rankings

Las clasificaciones por categoría de Apple App Store son listas públicas ordenadas de apps, con campos de posición, identidad de la app, desarrollador, categoría, calificación, cantidad de reseñas, precio y arte gráfico. Estos registros sirven para monitorear listas, enriquecer catálogos clasificados y comparar el contexto público de la tienda asociado a cada posición.

Funcionalidades de la Apple App Store Rankings API

  • Descubrimiento a partir de URL de listas por categoríaUse una o más URL públicas de categorías o clasificaciones de apps.apple.com como entradas para descubrir los registros de apps clasificadas que exponen esas páginas.
  • Posición e identidad de la appConserve cada posición de origen disponible junto al ID de la app, el nombre y la URL pública de la tienda, para que los resultados ordenados sigan siendo identificables.
  • Contexto del desarrollador y de la categoríaDevuelve el nombre del desarrollador o editor disponible y la categoría de la tienda con cada registro de aplicación normalizado.
  • Señales visibles de la tiendaIncluye la calificación, la cantidad de reseñas y los valores estructurados de precio cuando el resultado público de la lista los expone.
  • Descripciones y arte gráficoConserva el texto de la app y las referencias multimedia disponibles en el mismo esquema de app fijo que se usa en el resto del resultado.

Parámetros de la Apple App Store Rankings API

ParámetrosObligatorioDescripción
urlsObligatorioLista obligatoria de URL públicas de clasificaciones de Apple App Store. Todo nombre de host analizado debe ser apps.apple.com o uno de sus subdominios, y toda ruta debe contener /charts/.
results_limitOpcionalLímite general opcional de la tarea, de 1 a 2,000. El backend usa 100 cuando se omite este campo.

Cómo usar la Apple App Store Rankings API

Comience con la URL pública de una lista por categoría de Apple App Store, defina el límite general de resultados y lea los registros de apps normalizados guardados cuando la tarea se complete con éxito.

  1. Ingrese una o más URL públicas de clasificaciones de apps.apple.com cuya ruta contenga /charts/; el ejemplo incluido cumple la regla de validación del backend.
  2. Defina results_limit de 1 a 2,000, u omítalo para usar el valor predeterminado del backend de 100 resultados.
  3. Envíe los datos por POST a /v1/apple-app-store/rankings, guarde el task_id y consulte /v1/tasks/{task_id} hasta que la tarea se complete con éxito o falle.
  4. Lea data.results.items y solicite la siguiente página de resultados almacenados con next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/apple-app-store/rankings" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://apps.apple.com/us/iphone/charts/6007"],"results_limit":3}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso de la Apple App Store Rankings API

  • Monitoreo de listas por categoría: Almacene la posición, la identidad de la app y collected_at de ejecuciones repetidas para distinguir instantáneas de la lista en momentos concretos.
  • Enriquecimiento de catálogos de apps clasificadas: Agregue ID de apps, nombres, desarrolladores, categorías, URL de la tienda, descripciones y arte gráfico a las entradas descubiertas en una lista.
  • Comparación del contexto de la tienda: Compare los campos disponibles de posición, calificación, cantidad de reseñas y precio entre las apps devueltas de la misma lista por categoría.

Consejos de expertos para la Apple App Store Rankings API

  • Use una URL de clasificación de apps.apple.com cuya ruta contenga /charts/. Las URL de detalle de una app individual y las rutas no relacionadas no pasan la validación antes de que comience la recopilación.
  • Envíe tareas separadas cuando cada lista necesite su propio cupo, porque results_limit limita el total de filas guardadas para la tarea aunque urls contenga varias listas.
  • Siga next_cursor solo para recorrer los resultados almacenados de SocQ; no solicita otra página de lista al proveedor ni amplía el límite original de resultados.
  • Ejecute por separado las listas que se superponen cuando importe conservar cada aparición en una lista, porque una tarea deduplica los registros guardados por ID de app o URL de origen.
  • Trate description, la calificación, la cantidad de reseñas, el precio, el arte gráfico y otros campos opcionales como valores que pueden ser nulos, y omita los valores vacíos en las vistas posteriores.

Además de la Apple App Store Rankings API, use estas APIs cuando necesite otro tipo de datos públicos de Apple App Store.

  • Apple App Store App Detail API — Obtiene desde URLs conocidas de fichas de la App Store la identidad pública normalizada de la app, los metadatos descriptivos, el contexto del desarrollador y la categoría, las calificaciones visibles, el precio y el contenido multimedia.
  • Apple App Store App Reviews API — Recolecta reseñas públicas de apps desde URLs conocidas de apps.apple.com, con texto normalizado, calificaciones, datos de quien reseña, marcas de tiempo y referencias a la app.

Explorar otras plataformas

Combine los datos de Apple App Store con datos públicos de otras plataformas sociales compatibles.

Apple App Store Rankings API — FAQ

Apple App Store Rankings API es una interfaz programática para recopilar apps clasificadas públicas a partir de URL conocidas de listas por categoría. Devuelve campos normalizados de posición, identidad de la app, desarrollador, categoría, calificación, reseñas, precio y contenido multimedia.

Envíe URL públicas de clasificaciones cuyo nombre de host sea apps.apple.com o un subdominio y cuya ruta contenga /charts/. La validación de entrada rechaza las URL de apps individuales y las rutas no relacionadas.

Cada registro de app tiene el esquema fijo de app, con campos de posición de origen, identidad, URL pública, desarrollador, categoría, calificación, cantidad de reseñas, precio, texto, contenido multimedia y momento de recopilación. Los valores opcionales quedan en null cuando la fuente no los expone.

Es un límite general de la tarea, de 1 a 2,000, y su valor predeterminado es 100 cuando se omite. La cantidad de resultados guardados puede ser menor cuando las listas exponen menos filas o los registros se deduplican.

No. next_cursor lee la siguiente página de resultados que SocQ ya almacenó; este endpoint no expone un cursor del proveedor para ampliar la ejecución original de descubrimiento de la lista.

Cada resultado de app normalizado guardado con éxito cuesta 0.15 créditos de SocQ. La estimación de la solicitud usa results_limit, o 100 cuando se omite, y los créditos cobrados por adelantado que no se usaron se reembolsan al liquidar la tarea.