API de App Store Connect
Cambiar precios con la API de App Store Connect
Todo lo que hacen las pantallas de precios de App Store Connect está disponible por la API. Este es el mapa: qué recursos existen, cómo son las solicitudes, cuántas llamadas requiere un cambio mundial y qué falla en la práctica.
La respuesta corta
Para cambiar un precio con la API de App Store Connect, obtén los puntos de precio del producto para tu territorio base, elige el punto del nuevo precio y crea un calendario de precios: POST /v1/appPriceSchedules para apps, POST /v1/inAppPurchasePriceSchedules para compras dentro de la app, o un POST /v1/subscriptionPrices por territorio para suscripciones. Autentícate con un JWT firmado con una clave de API del equipo.
Autenticación
Cada solicitud lleva un JWT bearer que firmas con la clave privada .p8 de tu clave de API (Apple: generar tokens):
- Cabecera:
alg=ES256,kid= tu Key ID,typ=JWT. - Carga:
iss= tu Issuer ID,iat= ahora,exp= como máximo 20 minutos después,aud=appstoreconnect-v1. Unscopeopcional puede limitar un token a las solicitudes GET indicadas. - Reutiliza un mismo token para muchas solicitudes hasta que caduque; Apple lo recomienda por rendimiento. Los trabajos largos crean un token nuevo periódicamente.
- La clave necesita un rol que pueda gestionar precios: Admin o App Manager (las páginas de ayuda de Apple indican titular de la cuenta, Admin o App Manager como el rol necesario). Crear una se explica en la guía de la clave de API.
Los recursos
| Producto | Puntos de precio | Igualaciones | Crear un cambio de precio |
|---|---|---|---|
| App | `GET /v1/apps/{id}/appPricePoints`?filter[territory]=USA | `GET /v3/appPricePoints/{id}/equalizations` | `POST /v1/appPriceSchedules`: territorio base más precios manuales |
| Compra dentro de la app | `GET /v2/inAppPurchases/{id}/pricePoints` | `GET /v1/inAppPurchasePricePoints/{id}/equalizations` | `POST /v1/inAppPurchasePriceSchedules`: territorio base obligatorio |
| Suscripción | `GET /v1/subscriptions/{id}/pricePoints`: siempre con filter[territory] | `GET /v1/subscriptionPricePoints/{id}/equalizations` | `POST /v1/subscriptionPrices`: uno por territorio |
| Territorios | `GET /v1/territories` | — | Solo lectura: las 175 tiendas y sus divisas |
Cada punto de precio tiene un customerPrice y tus proceeds. Las igualaciones de un punto son los puntos equivalentes en todas las demás tiendas: los precios mundiales de Apple para ese precio base, sin cálculos de tipo de cambio por tu parte. En las suscripciones con tipos de plan mensual y de pago por adelantado, Apple también documenta adjustedEqualizations (Apple: configurar los precios de suscripción en todos los territorios). Lee el estado actual con GET /v1/apps/{id}/appPriceSchedule y, para suscripciones, GET /v1/subscriptions/{id}/prices.
Cómo son las solicitudes
Un calendario de precios de una app es un único documento JSON:API con precios creados en línea. Las partes que importan:
| Dónde | Campo | Valor |
|---|---|---|
data | type | appPriceSchedules |
data.relationships | app | El ID de tu app |
data.relationships | baseTerritory | Por ejemplo USA |
data.relationships | manualPrices | Referencias a los precios de included, con ID temporales como ${price-1} |
included[] | type | appPrices (compras dentro de la app: inAppPurchasePrices) |
included[].attributes | startDate, endDate | null para “ahora” y “sin fin”, o una fecha |
included[].relationships | appPricePoint | El ID del punto de precio de ese territorio |
Los territorios sin precio manual reciben el precio automático de Apple derivado de la base. El precio de una suscripción es más sencillo: type subscriptionPrices, atributos startDate y preserveCurrentPrice (más planType si ofreces tipos de plan) y relaciones con la suscripción, el territorio y el subscriptionPricePoint.
Un cambio mundial, paso a paso
- Lista los territorios una vez y guárdalos en caché; rara vez cambian.
- Para cada producto, obtén los puntos de precio de tu territorio base (200 por página) y busca el que coincide con tu nuevo precio base.
- Si quieres los precios de Apple en todas partes, para ahí: el punto base basta para apps y compras dentro de la app. Para tus propios precios regionales, calcula un objetivo por tienda y ajústalo; lo más fácil es ajustar el objetivo en la divisa base y seguir las igualaciones de ese punto (cómo funciona el ajuste).
- Apps y compras dentro de la app: haz POST de un calendario con el territorio base y todos los precios manuales. Suscripciones: haz POST de un
subscriptionPricespor tienda, con la fecha de inicio y la política para los suscriptores existentes. - Gestiona los 429 y los 5xx con espera y reintento; registra cada recurso creado como rastro de auditoría.
- Lee el calendario o los precios de vuelta y comprueba al azar unas cuantas tiendas en App Store Connect.
¿Cuántas solicitudes hacen falta?
Un ejemplo práctico: 2 apps, 10 compras dentro de la app y 4 suscripciones, con nuevos precios en 4 niveles regionales. El ejemplo de límite de frecuencia de Apple muestra 3,500 solicitudes por hora móvil por clave, y dice que los límites reales varían; lee la cabecera X-Rate-Limit de cada respuesta (Apple: límites de frecuencia).
| Paso | Cálculo | Solicitudes |
|---|---|---|
| Territorios | Una vez | 1 |
| Puntos de precio base | 16 productos × unas 5 páginas | ≈ 80 |
| Igualaciones | 16 productos × 4 puntos de nivel | ≈ 64 |
| Calendarios de apps y IAP | 12 productos × 1 | 12 |
| Precios de suscripción | 4 suscripciones × 175 tiendas | 700 |
| Total | ≈ 857 |
Dominan las suscripciones: Apple señala que no hay un endpoint masivo para aplicar precios de suscripción igualados. Duplica el catálogo, añade reintentos y una pasada de verificación, y te acercas al límite horario del ejemplo, así que dosifica el trabajo en lugar de lanzar un bucle sin pausa.
Trampas
- El POST de un calendario sustituye todo el calendario de la app o de la compra dentro de la app. Incluye todos los precios manuales que quieras conservar, no solo los que cambian: lo que dejes fuera vuelve al precio automático de Apple.
- Para programar un cambio futuro en una app o IAP, envía los precios manuales de hoy con un
endDateigual al nuevostartDate, seguidos de los precios nuevos. Dos intervalos contiguos con el mismo punto de precio se rechazan (“Adjacent intervals cannot have the same price point”), así que envía un territorio sin cambios como una única entrada sin fecha de fin. - Las suscripciones guardan como máximo un precio futuro por territorio. Elimina el que está en cola con `DELETE /v1/subscriptionPrices/{id}` antes de crear otro.
- Un precio de suscripción sin fecha de inicio es el precio inicial. Una vez aprobada la suscripción, los demás precios necesitan un
startDate; si no, la API responde con un error de estado 409. - Las bajadas de suscripciones se aplican a los suscriptores existentes, y ningún cambio de suscripción se puede revertir una vez en vigor. Las subidas pueden necesitar consentimiento: consulta subir el precio de una suscripción.
- Las listas de puntos de precio son grandes. Filtra siempre por territorio y pagina.
- Los tokens duran como máximo 20 minutos en estos endpoints; los trabajos largos deben volver a firmar.
- Los cambios pueden tardar hasta una hora en aparecer en el sandbox.
- Nada en la API pregunta “¿seguro?”. Construye tú el paso de revisión.
Probar un script de precios con seguridad
No hay una copia de pruebas de tu cuenta de App Store Connect, así que incorpora la seguridad al propio script:
- Dale al script una opción de simulación que calcule todo e imprima una tabla de producto, territorio, precio actual y precio nuevo, sin enviar nada.
- Antes de escribir, lee el calendario o los precios en vivo y compáralos con tu plan; salta los territorios que ya tienen el precio objetivo.
- Haz la primera escritura real en un producto que aún no esté en oferta, o en un solo territorio, y léela de vuelta.
- Escribe una línea de registro por territorio con el punto de precio antiguo y el nuevo. Si algo sale mal, ese registro es lo que te permite devolver los precios a su sitio.
- Guarda la clave en un almacén de secretos, nunca en el repositorio, y dale al script su propia clave para poder revocarla de forma independiente.
Sin script: RepriceCat
RepriceCat es, en la práctica, esta guía hecha producto. Conectas la clave de tu propio equipo (se guarda cifrada y se puede revocar en cualquier momento), y RepriceCat obtiene los puntos de precio, ajusta los precios de los niveles a puntos válidos, construye los calendarios (incluido el traspaso de los precios de hoy en los cambios programados) y se dosifica según el límite de frecuencia.
- Una tabla de revisión de producto × país, precio de hoy → precio nuevo, antes de enviar nada; una simulación que no envía nada.
- Hasta 200 productos de varias apps en un solo cambio, ahora o en una fecha.
- Los países que fallan aparecen con el motivo de Apple y se pueden reenviar por separado; cada cambio se registra por país, con reversión.
- Ida y vuelta con hojas de cálculo: exporta los precios a XLSX o CSV, edítalos e impórtalos de nuevo.
¿Dudas entre construirlo o comprarlo? Lee RepriceCat frente a scripts de API o empieza con un mes gratis.
Preguntas frecuentes
¿Qué rol necesita una clave de la API de App Store Connect para cambiar precios?
Admin o App Manager. Las páginas de ayuda de precios de Apple indican titular de la cuenta, Admin o App Manager como los roles que pueden gestionar precios; las claves con roles Developer, Marketing, Sales o Finance no pueden.
¿Puede la API cambiar los precios de todos los territorios en una sola solicitud?
En apps y compras dentro de la app, sí: un calendario de precios lleva el territorio base y todos los precios manuales. En las suscripciones cada territorio es su propio recurso subscriptionPrices, así que un cambio mundial son hasta 175 solicitudes por suscripción.
¿Cómo obtengo por la API los precios igualados de Apple?
Busca el punto de precio de tu precio base y llama a su endpoint de igualaciones. Devuelve el punto de precio comparable en todas las demás tiendas, que puedes usar tal cual o como precio ajustado de un nivel regional.
¿Hay un sandbox o un modo de simulación para las llamadas de precios?
No. Los calendarios de precios actúan sobre la cuenta real. Revisa con cuidado el lote calculado, prueba en un producto que aún no esté publicado o usa una herramienta con su propia simulación.
¿Cuál es el límite de frecuencia de la API de App Store Connect?
Los límites son por clave de API en una hora móvil y se indican en la cabecera X-Rate-Limit de cada respuesta. El ejemplo de Apple muestra 3,500 solicitudes por hora, pero dice que los límites reales varían; superarlo devuelve un HTTP 429.
¿Cómo cancelo un cambio de precio programado por la API?
En una suscripción, elimina el recurso subscriptionPrices pendiente. En una app o una compra dentro de la app, envía un nuevo calendario sin la entrada futura, recordando que el POST sustituye todo el calendario.
Pruébalo
Cambia el precio en todos los territorios a partir de un solo precio base
Niveles, ajuste a puntos de precio, una tabla de revisión y una sola confirmación, mediante la API de App Store Connect. Primer mes gratis y después $1 por app al mes.