Exportar datos de Apple Search Ads

Hermoso se conecta a Apple Search Ads y lo expone como herramientas que tu agente puede llamar: Claude, ChatGPT, Cursor, Codex, Cline, la CLI o HTTP simple. apple_ads_report saca el rendimiento de campañas, grupos de anuncios, anuncios, palabras clave y términos de búsqueda, y las filas llegan como datos y no como un CSV que tengas que descargar y llevar tú a otro sitio.

El conector de Apple Search Ads

Apple no publica un flujo OAuth para su API de anuncios, así que conectarla es un intercambio de claves y no un botón: Hermoso genera la clave de firma, tú pegas su mitad pública en Apple Ads y devuelves tres ids. La guía de configuración de Apple Search Ads lo explica paso a paso, incluido el campo Public Key que la mayoría no encuentra. Una sola conexión sirve después a la app web, al servidor MCP, a la CLI y a la API REST, así que la misma exportación funciona desde Claude, ChatGPT o Cursor: conecta Apple Search Ads a Claude o a ChatGPT una vez, y luego pregunta.

Los informes son solo una parte. La misma conexión crea y gestiona la cuenta: campañas, grupos de anuncios, palabras clave y negativas, órdenes de presupuesto, segmentación, sugerencias de palabras clave e historial de cambios. La página del canal de Apple Ads enumera todas las herramientas.

Qué contiene el informe

Una llamada, cinco niveles. apple_ads_report informa a nivel de campaña, grupo de anuncios, anuncio, palabra clave o término de búsqueda, y cada fila trae las métricas que muestra el propio panel de Apple: impresiones, toques, instalaciones, gasto, tasa de toques, coste por toque y coste por adquisición. Puedes pedir totales o una serie a granularidad por hora, día, semana o mes. Las filas llegan ordenadas por gasto, de mayor a menor, hasta 5.000 por página, con una fila de totales generales si la pides. Los informes de la App Store también pueden incluir entidades sin entrega, así que una palabra clave pausada aparece como cero y no como una línea que falta.

Dos reglas que impone Apple, y que la herramienta explica en lugar de fallar en silencio: un informe por debajo del nivel de campaña necesita un id de campaña (solo un informe a nivel de campaña puede cubrir toda la cuenta), y los informes de términos de búsqueda se ejecutan en la zona horaria de tu organización, nunca en UTC. Los anuncios en Apple Maps también están cubiertos: un informe de business-brands sale de la misma herramienta con un parámetro cambiado.

Conectar Apple Search Ads a Google Sheets

Este es el único destino al que Hermoso escribe directamente. Conecta Google Drive junto a Apple Ads (una sola autorización de Google cubre Drive, Sheets y Docs) y luego pide: "Saca el rendimiento de Apple Search Ads por palabra clave de los últimos 30 días y ponlo en una hoja nueva llamada Apple Ads." El agente llama a apple_ads_report, después a create_sheet, y te devuelve el enlace. La semana siguiente, la misma petición con "añadir" agrega filas con append_to_sheet en lugar de empezar de nuevo.

Hermoso pide a Google el ámbito drive.file, que solo alcanza los archivos que creó y los que tú eliges, nunca todo tu Drive. El recorrido completo, incluido reemplazar una pestaña en su lugar y darle formato, está en Conectar Apple Search Ads a Google Sheets.

Exportar Apple Search Ads a Looker Studio

Hermoso no tiene un conector nativo de Looker Studio, y preferimos decirlo antes que dar a entender que sí. No lo necesita: Looker Studio lee Google Sheets con su propio conector integrado, así que la hoja de arriba es el puente.

1. Pide al agente que escriba el informe en una pestaña. Granularidad diaria, una fila por palabra clave y por día, una fila de encabezados y una columna de fecha. Pide que la columna de fecha tenga formato de fecha (format_sheet lo hace) para que Looker Studio la lea como tal.
2. Añade la hoja como fuente de datos. En Looker Studio, crea una fuente de datos, elige Google Sheets, selecciona la hoja de cálculo y esa pestaña, y deja activada la opción "Usar la primera fila como encabezados".
3. Crea el informe una vez. Gasto por día, coste por adquisición por palabra clave, instalaciones por campaña: lo que de otro modo reconstruirías en una hoja de cálculo cada lunes.
4. Sigue añadiendo. Cada semana el agente añade filas nuevas a la misma pestaña, y el panel las recoge en su siguiente actualización de datos. Mantén los mismos nombres de columna entre ejecuciones, porque Looker Studio asigna los campos por encabezado.

La misma hoja sirve para Power BI y Tableau, que tienen sus propios conectores de Google Sheets.

Exportar Apple Search Ads a JSON

Si quieres las filas en bruto en lugar de una hoja de cálculo, hay tres formas de obtenerlas, todas con la misma conexión.

La API REST. Cada herramienta de Hermoso se puede llamar en POST /v1/tools/{name} con una clave de API que creas en la app, en la pestaña MCP & CLI. El cuerpo de la petición son los argumentos de la herramienta, y el campo data de la respuesta es el resultado estructurado, con las filas en data.rows:

curl -sX POST https://app.hermoso.ai/v1/tools/apple_ads_report \
  -H "Authorization: Bearer hmk_..." -H 'content-type: application/json' \
  -d '{"level":"keyword","campaignId":"1234567890","startTime":"2026-09-01","endTime":"2026-09-07","granularity":"DAILY"}' \
  | jq '.data.rows' > apple-search-ads.json

La CLI. npx -y hermoso call apple_ads_report --json '{...}' --structured imprime el mismo resultado estructurado como JSON, listo para redirigirlo a un archivo o pasarlo a otro script.

Tu agente. En cualquier chat, pide las filas como JSON y las recibes en la respuesta, ya con la forma que pediste.

Para informes largos, limit admite hasta 5.000 filas por página y offset pasa a la siguiente; el campo hasMore del resultado indica si hay otra página. Leer un informe no gasta créditos. La referencia completa de la API está en la documentación para desarrolladores.

Otros destinos

"Directo" significa que lo escribe Hermoso. Todo lo demás es un paso que una herramienta que ya usas hace por sí misma.

• Google Sheets, Google Docs, Google Drive, OneDrive: directo.
• Looker Studio, Power BI, Tableau: a través de la hoja, cada uno con su propio conector de Google Sheets.
• BigQuery: a través de la hoja, o a través de tu propio agente. BigQuery puede consultar una hoja de Google como tabla externa. Si tu agente se ejecuta en un lugar con un cliente de BigQuery y tus credenciales del proyecto, puede insertar directamente en una tabla las filas que devuelve Hermoso.
• Excel: a través de la hoja o de un archivo. Descarga la hoja como .xlsx, o pide al agente que deje un archivo en Google Drive o OneDrive.
• PostgreSQL, Redshift, Snowflake o cualquier almacén de datos: a través de tu propio agente o de la API. Hermoso devuelve JSON; lo que tenga tus credenciales de base de datos lo escribe. Hermoso no guarda credenciales de almacenes de datos.

Automatizar la exportación semanal

El prompt es la automatización. Algo como "Cada lunes, saca el rendimiento de Apple Search Ads de la semana pasada por palabra clave para cada campaña, añádelo a la hoja de Apple Ads y dime qué palabras clave cambiaron más en coste por adquisición" es un trabajo completo. Ejecútalo con la programación que ya tenga tu cliente (tareas programadas en Claude o ChatGPT, o un cron que llame a la CLI o a la API de Hermoso) y la hoja, y todos los paneles que la leen, se mantienen al día.

Como la misma conexión también edita la cuenta, el informe y la corrección viven en el mismo lugar: el agente que detecta que el coste por adquisición de una palabra clave se ha duplicado puede pausarla o añadir una negativa en la misma conversación.

Preguntas frecuentes

¿Cómo exporto datos de Apple Search Ads?

Conecta Apple Ads a Hermoso una vez y luego pide a tu agente el informe que quieras, por ejemplo el rendimiento por palabra clave de la semana pasada. La herramienta apple_ads_report lo saca de la API de informes de Apple y el agente lo escribe en una hoja de Google, te entrega JSON, o ambas cosas.

¿Puedo conectar Apple Search Ads a Google Sheets?

Sí. Conecta Apple Ads y Google Drive en Hermoso, luego pide al agente que ponga el informe en una hoja. Crea la hoja con create_sheet, o añade filas a una existente con append_to_sheet, y puede repetirlo cada semana.

¿Puedo exportar Apple Search Ads a Looker Studio?

Sí, a través de Google Sheets. Hermoso no tiene un conector nativo de Looker Studio. El agente escribe el informe en una hoja, tú añades esa hoja como fuente de datos de Google Sheets en Looker Studio una vez, y cada añadido aparece en la siguiente actualización del panel.

¿Cómo exporto datos de Apple Search Ads a JSON?

Llama a POST /v1/tools/apple_ads_report en la API de Hermoso con una clave de API y lee data.rows de la respuesta, o ejecuta hermoso call apple_ads_report --json '{...}' --structured desde la CLI. Ambas devuelven las mismas filas en JSON.

¿Existe una API de informes de Apple Search Ads?

Sí, y Hermoso está construido sobre ella. apple_ads_report cubre el rendimiento de campañas, grupos de anuncios, anuncios, palabras clave y términos de búsqueda, y las demás herramientas de Apple Ads crean y gestionan la cuenta.

¿Puedo obtener informes de términos de búsqueda de Apple Search Ads?

Sí. Pide el nivel de término de búsqueda y nombra la campaña. Apple solo sirve términos de búsqueda por campaña, en la zona horaria propia de la organización.

¿Cuántas filas puede devolver un informe?

Hasta 5.000 por página, ordenadas por gasto de mayor a menor, con una marca que indica al agente si hay más páginas. Un informe semanal por palabra clave cabe en una página para la mayoría de las cuentas.

¿Esto cubre los anuncios en Apple Maps?

Sí. Los informes de campañas business-brands salen de la misma herramienta, con el tipo de objeto promocionado cambiado a Apple Maps en lugar de la App Store.

¿Necesito un desarrollador para configurarlo?

No. Conecta Apple Ads una vez en la app y luego pide a tu agente en lenguaje natural: saca la semana pasada por palabra clave y ponla en una hoja. La API y la CLI están ahí si quieres automatizarlo con scripts.