apple-app-store/
app-detail

Obtenga fichas públicas de Apple App Store a partir de URL conocidas de apps.apple.com y reciba la identidad de la app, descripciones, contexto del desarrollador, calificaciones, precios y contenido multimedia como registros normalizados.

Apple App Store App Detail API

URL de fichas conocidas
Registros de apps normalizados
Metadatos de páginas de producto públicas
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 App Detail

Las fichas de Apple App Store son páginas de producto públicas con la identidad de la app, el texto descriptivo, el contexto del desarrollador y de la categoría, las calificaciones visibles, el precio y el contenido multimedia. Estos campos sirven para enriquecer catálogos, comparar fichas y monitorear metadatos en momentos concretos.

Funcionalidades de la Apple App Store App Detail API

  • Entrada por lotes de URL conocidasEnvíe una o más URL de páginas de producto de apps.apple.com; cada URL depurada se asigna a una entrada del proveedor y se conserva como máximo un registro de app normalizado por cada URL enviada.
  • Identidad de la ficha y metadatos descriptivosDevuelve el ID de la app, el nombre, el texto de la descripción, el desarrollador, la categoría, la URL de origen y el momento de recopilación en un esquema de app uniforme.
  • Contexto visible de calificación y precioConserva la calificación, la cantidad de reseñas y los campos estructurados de precio disponibles, para comparar las fichas sin tener que analizar el texto de la página de producto.
  • Contexto multimedia y de catálogoMantiene el contenido multimedia disponible de la ficha junto con las marcas de tiempo de publicación y recopilación, y omite los valores del esquema que la página pública no expone.

Parámetros de la Apple App Store App Detail API

ParámetrosObligatorioDescripción
urlsObligatorioLista obligatoria con una o más URL conocidas de páginas de producto. Cada elemento no vacío debe resolverse a apps.apple.com o a uno de sus subdominios; este endpoint no acepta palabras clave, bundle ID ni países.

Cómo usar la Apple App Store App Detail API

Envíe URL de fichas conocidas, siga la tarea asíncrona y lea los registros de apps normalizados desde las páginas de resultados almacenadas.

  1. Prepare una o más URL públicas de páginas de producto de Apple App Store cuyo nombre de host sea apps.apple.com o uno de sus subdominios.
  2. Envíe por POST la lista urls a /v1/apple-app-store/app-detail y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea se complete con éxito o devuelva un error.
  4. Lea los registros de apps en data.results.items y siga next_cursor solo cuando has_more sea true.
curl -X POST "https://api.socq.ai/v1/apple-app-store/app-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://apps.apple.com/us/app/chatgpt/id6448311069"]}'

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

Casos de uso de la Apple App Store App Detail API

  • Enriquecimiento de catálogos de apps: Agregue la identidad normalizada de la app, los metadatos descriptivos, el desarrollador, la categoría, el precio, el contenido multimedia y las URL de origen a registros que ya contienen enlaces conocidos de App Store.
  • Comparación de fichas: Compare el contexto del desarrollador y de la categoría, las calificaciones visibles, las cantidades de reseñas, los precios y los textos descriptivos en un conjunto seleccionado de URL.
  • Monitoreo de instantáneas de metadatos: Almacene los resultados repetidos con collected_at para identificar cambios en nombres, descripciones, categorías, calificaciones visibles, precios y contenido multimedia a lo largo del tiempo.

Consejos de expertos para la Apple App Store App Detail API

  • Valide que cada nombre de host analizado corresponda a apps.apple.com y envíe URL de páginas de producto en lugar de términos de búsqueda, bundle ID o nombres de tiendas.
  • Elimine las URL duplicadas antes del envío para que las entradas repetidas no generen filas redundantes del proveedor ni registros de apps duplicados.
  • Trate rating, reviews_count, price, media, published_at, installs y rank como valores que pueden ser nulos, porque una ficha puede exponer solo una parte del esquema de la app.
  • No trate next_cursor como un token de página de App Store en origen; solo avanza por los resultados ya almacenados de la tarea completada de SocQ.

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

  • 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.
  • Apple App Store Rankings API — Recolecta entradas de clasificaciones por categoría desde URLs compatibles de la Apple App Store, con posición de origen, identidad de la app, desarrollador, calificación, cantidad de reseñas, precio y contenido multimedia.

Explorar otras plataformas

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

Apple App Store App Detail API — FAQ

Apple App Store App Detail API es una interfaz programática para obtener metadatos públicos a partir de URL conocidas de páginas de producto de Apple App Store. Devuelve la identidad de la app, descripciones, contexto del desarrollador y de la categoría, calificaciones visibles, precios, contenido multimedia y momento de recopilación, todo normalizado.

Envíe una lista urls no vacía con referencias a páginas de producto cuyo nombre de host analizado sea apps.apple.com o uno de sus subdominios. Este endpoint no acepta palabras clave, bundle ID, códigos de país ni un campo results_limit.

Un registro normalizado puede incluir ID de la app, nombre, texto de la descripción, desarrollador, categoría, calificación, cantidad de reseñas, installs, precio estructurado, rank, contenido multimedia, URL de origen, momento de publicación y momento de recopilación. Los campos ausentes en la ficha pública quedan en null y conviene omitirlos en la vista que se muestre.

No. El proveedor recibe una fila de entrada por cada URL enviada y la tarea conserva como máximo un registro normalizado por URL. next_cursor y has_more pertenecen solo al lector de resultados almacenados de SocQ.

La estimación de la solicitud usa la cantidad de URL enviadas a 0.15 créditos por resultado esperado. La facturación final usa la cantidad de resultados normalizados almacenados con éxito, y una tarea vacía se liquida con el cargo base de cero créditos.