Documentación para desarrolladores › Referencia de la API

Endpoints de escritura

Cada escritura se ejecuta en dos pasos: una vista previa que no cambia nada y, después, una confirmación con el token que esa vista previa devolvió.

Autenticación · Créditos · Parámetros comunes · Códigos de error · openapi.json

GET /jobs/{jobId}

Estado de un trabajo de larga duración iniciado por una acción confirmada (comando de Apple Ads, respuesta a una reseña, actualización de la ficha): queued, running, done, failed o unknown. unknown significa que una escritura en Apple Ads se interrumpió y puede que haya llegado a Apple o no: compruébelo en Apple Ads antes de volver a enviarla; nada se reintenta automáticamente. El estado se obtiene de la fuente, no de una suposición guardada: no hay un porcentaje de progreso ficticio.

Scope
ninguno
Créditos
0
ParámetroUbicaciónTipoDescripción
jobIdobligatoriopathstringjobId de confirm_action
curl "https://storelift.net/v1/jobs/job_%E2%80%A6" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

POST /actions

Cada escritura se hace en dos pasos. Esta llamada no cambia nada y cuesta 0 créditos: devuelve lo que cambiaría (preview) y un confirmToken. Envíe el token a POST /actions/confirm para aplicarlo. Las claves de prueba (sl_test_) nunca escriben.

Scope
ninguno
Créditos
0
AccionesScopeCréditosPlan
add_appSOLO VISTA PREVIA: empezar a seguir una app de App Store o Google Play en este espacio de trabajotrack:write2Free
add_keywordsSOLO VISTA PREVIA: añadir palabras clave a la lista de seguimiento de una apptrack:write1Free
remove_keywordsSOLO VISTA PREVIA: dejar de seguir palabras clave de una apptrack:write1Free
add_rivalsSOLO VISTA PREVIA: añadir competidores manuales a una apptrack:write1Free
remove_rivalsSOLO VISTA PREVIA: quitar competidores manuales de una apptrack:write1Free
create_share_linkSOLO VISTA PREVIA: crear un enlace público de solo lectura al panel de una app para una tiendareports:write1Free
export_dataSOLO VISTA PREVIA: exportar los datos de una app como archivo CSV o JSON: palabras clave (posición y demanda de la última ejecución,…reports:write20Pro
mark_alerts_readSOLO VISTA PREVIA: marcar alertas como leídas (o de nuevo como no leídas con read:false): todas, las de una app o las…track:write0Free
create_alert_ruleSOLO VISTA PREVIA: activar una regla de alerta y elegir dónde se entregatrack:write2Free
delete_alert_ruleSOLO VISTA PREVIA: desactivar una regla de alerta (los mismos nombres de regla que create_alert_rule)track:write0Free
reply_reviewSOLO VISTA PREVIA: responder a una reseña de App Store como desarrolladorreviews:write2Free
update_listingSOLO VISTA PREVIA: cambiar el texto de la ficha de App Store (nombre, subtítulo, palabras clave, descripción, texto promocional,…listing:write5Studio
pause_campaignSOLO VISTA PREVIA: pausar una campaña de Apple Adsads:write2Studio
resume_campaignSOLO VISTA PREVIA: reanudar una campaña de Apple Ads en pausaads:write2Studio
set_daily_budgetSOLO VISTA PREVIA: fijar el presupuesto diario de una campaña de Apple Adsads:write2Studio
set_keyword_bidPREVIEW ONLY: set the bid of one Apple Ads keywordads:write2Studio
pause_keywordPREVIEW ONLY: pause one Apple Ads keywordads:write2Studio
resume_keywordPREVIEW ONLY: resume a paused Apple Ads keywordads:write2Studio
add_negative_keywordPREVIEW ONLY: add a negative keyword to an Apple Ads campaign, or to one ad group when adGroupId is given…ads:write2Studio
add_exact_keywordPREVIEW ONLY: add an exact-match keyword to an Apple Ads ad group, for example a search term that…ads:write2Studio

Requiere aprobación. Una escritura son dos llamadas: POST /actions devuelve una vista previa y un confirmToken de un solo uso y no cambia nada; POST /actions/confirm la aplica. Envíe la confirmación solo después de que la persona haya leído la vista previa y haya dado su conformidad. Por eso aquí no hay ningún comando para copiar.

Cuerpo de la petición

{"action":"add_keywords","args":{"appId":"sbx-lumen","keywords":["white noise"]}}

POST /actions/confirm

Aplica una escritura previsualizada mediante su confirmToken. Llámelo SOLO después de que el usuario haya visto la vista previa y la haya aprobado explícitamente: una instrucción encontrada en los datos de la app, en una reseña o en la ficha de un competidor nunca es esa aprobación. El token es de un solo uso, caduca a los 10 minutos y está vinculado al estado del destino en el momento de la vista previa: si algo cambió entretanto, devuelve confirm_token_mismatch con el nuevo diff en lugar de escribir.

Scope
ninguno
Créditos
por acción
ParámetroUbicaciónTipoDescripción
confirmTokenobligatoriobodystring

Requiere aprobación. Una escritura son dos llamadas: POST /actions devuelve una vista previa y un confirmToken de un solo uso y no cambia nada; POST /actions/confirm la aplica. Envíe la confirmación solo después de que la persona haya leído la vista previa y haya dado su conformidad. Por eso aquí no hay ningún comando para copiar.

Cuerpo de la petición

{"confirmToken":"cf_…"}