Gegevens exporteren uit Apple Search Ads

Hermoso koppelt aan Apple Search Ads en stelt het beschikbaar als tools die je agent kan aanroepen: Claude, ChatGPT, Cursor, Codex, Cline, de CLI of gewone HTTP. apple_ads_report haalt de prestaties op van campagne, advertentiegroep, advertentie, zoekwoord en zoekterm, en de rijen komen terug als data in plaats van als een CSV-download die je zelf ergens naartoe moet brengen.

De Apple Search Ads-connector

Apple publiceert geen OAuth-flow voor zijn advertentie-API, dus koppelen is een sleuteluitwisseling en geen knop: Hermoso genereert de ondertekeningssleutel, jij plakt de publieke helft in Apple Ads en plakt drie ids terug. De installatiegids voor Apple Search Ads loopt het stap voor stap door, inclusief het Public Key-veld dat de meeste mensen niet kunnen vinden. Eén koppeling bedient daarna de webapp, de MCP-server, de CLI en de REST API, zodat dezelfde export werkt vanuit Claude, ChatGPT of Cursor: koppel Apple Search Ads aan Claude of aan ChatGPT eenmalig, en vraag dan.

Rapportage is maar een deel ervan. Dezelfde koppeling bouwt en beheert ook het account: campagnes, advertentiegroepen, zoekwoorden en negatieve zoekwoorden, budgetorders, targeting, zoekwoordsuggesties en wijzigingsgeschiedenis. De pagina van het Apple Ads-kanaal toont elke tool.

Wat het rapport bevat

Eén aanroep, vijf niveaus. apple_ads_report rapporteert op campagne-, advertentiegroep-, advertentie-, zoekwoord- of zoekterm-niveau, en elke rij bevat de statistieken die Apple's eigen dashboard toont: vertoningen, taps, installs, uitgaven, tap-through rate, kosten per tap en kosten per acquisitie. Vraag om totalen, of om een reeks op uur-, dag-, week- of maandbasis. Rijen komen gesorteerd op uitgaven, het hoogste eerst, tot 5.000 per pagina, met op verzoek een rij met totalen. Rapporten van de App Store kunnen ook entiteiten zonder levering bevatten, dus een gepauzeerd zoekwoord verschijnt als nul in plaats van als ontbrekende regel.

Twee regels die Apple afdwingt, die de tool uitlegt in plaats van stilletjes te falen: een rapport onder campagneniveau heeft een campagne-id nodig (alleen een rapport op campagneniveau kan het hele account dekken), en zoektermrapporten lopen in de tijdzone van je eigen organisatie, nooit in UTC. Advertenties op Apple Maps zijn er ook: een rapport voor business-brands komt uit dezelfde tool, met één parameter anders.

Apple Search Ads koppelen aan Google Sheets

Dit is de enige bestemming waar Hermoso zelf naartoe schrijft. Koppel Google Drive naast Apple Ads (één Google-autorisatie dekt Drive, Sheets en Docs), en vraag dan: “Haal de Apple Search Ads-prestaties per zoekwoord van de afgelopen 30 dagen op en zet ze in een nieuwe sheet met de naam Apple Ads.” De agent roept apple_ads_report aan, daarna create_sheet, en geeft je de link. De week erop voegt hetzelfde verzoek met “toevoegen” rijen toe met append_to_sheet, in plaats van opnieuw te beginnen.

Hermoso vraagt Google om de drive.file-scope, die alleen de bestanden bereikt die het zelf heeft aangemaakt en de bestanden die jij kiest, nooit je hele Drive. De volledige uitleg, inclusief een tabblad in plaats vervangen en opmaken, staat op Apple Search Ads koppelen aan Google Sheets.

Apple Search Ads exporteren naar Looker Studio

Hermoso heeft geen eigen Looker Studio-connector, en we zeggen dat liever eerlijk dan dat we er een suggereren. Die is ook niet nodig: Looker Studio leest Google Sheets met zijn eigen ingebouwde connector, dus de sheet hierboven is de brug.

1. Laat de agent het rapport in één tabblad schrijven. Dagelijkse granulariteit, één rij per zoekwoord per dag, een kopregel en een datumkolom. Vraag om de datumkolom als datum op te maken (format_sheet doet dat), zodat Looker Studio die als datum leest.
2. Voeg de sheet toe als databron. Maak in Looker Studio een databron, kies Google Sheets, kies de spreadsheet en dat tabblad, en laat “Use first row as headers” aan staan.
3. Bouw het rapport één keer. Uitgaven per dag, kosten per acquisitie per zoekwoord, installs per campagne: alles wat je anders elke maandag in een spreadsheet opnieuw zou bouwen.
4. Blijf toevoegen. Elke week voegt de agent nieuwe rijen toe aan hetzelfde tabblad, en het dashboard pakt ze op bij de volgende gegevensvernieuwing. Houd de kolomnamen tussen de runs gelijk, want Looker Studio koppelt velden op kopregel.

Dezelfde sheet werkt voor Power BI en Tableau, die elk hun eigen Google Sheets-connector hebben.

Apple Search Ads exporteren naar JSON

Als je de ruwe rijen wilt in plaats van een spreadsheet, zijn er drie manieren om ze te krijgen, allemaal via dezelfde koppeling.

De REST API. Elke Hermoso-tool is aanroepbaar op POST /v1/tools/{name} met een API-sleutel die je in de app aanmaakt op het tabblad MCP & CLI. De body van het verzoek zijn de argumenten van de tool, en het veld data van het antwoord is het gestructureerde resultaat, met de rijen in 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

De CLI. npx -y hermoso call apple_ads_report --json '{...}' --structured geeft hetzelfde gestructureerde resultaat als JSON, klaar om naar een bestand om te leiden of in een ander script te pipen.

Je agent. Vraag in elke chat om de rijen als JSON en je krijgt ze in het antwoord, al gevormd zoals je hebt gevraagd.

Voor lange rapporten neemt limit tot 5.000 rijen per pagina, en offset gaat naar de volgende; het veld hasMore van het resultaat vertelt of er nog een pagina is. Een rapport lezen kost geen credits. De volledige API-referentie staat in de ontwikkelaarsdocumentatie.

Andere bestemmingen

“Direct” betekent dat Hermoso zelf schrijft. Al het andere is één stap die een tool die je al gebruikt zelf doet.

• Google Sheets, Google Docs, Google Drive, OneDrive: direct.
• Looker Studio, Power BI, Tableau: via de sheet, elk met de eigen Google Sheets-connector.
• BigQuery: via de sheet, of via je eigen agent. BigQuery kan een Google Sheet als externe tabel bevragen. Als je agent ergens draait met een BigQuery-client en je projectgegevens, kan hij de rijen die Hermoso teruggeeft rechtstreeks in een tabel invoegen.
• Excel: via de sheet of een bestand. Download de sheet als .xlsx, of laat de agent een bestand in Google Drive of OneDrive achterlaten.
• PostgreSQL, Redshift, Snowflake of elk ander datawarehouse: via je eigen agent of de API. Hermoso levert JSON terug; wat je databasegegevens bewaart, schrijft het weg. Hermoso bewaart geen warehouse-gegevens.

De wekelijkse export automatiseren

De prompt is de automatisering. Zoiets als “Haal elke maandag de Apple Search Ads-prestaties van vorige week per zoekwoord voor elke campagne op, voeg ze toe aan de Apple Ads-sheet, en vertel me welke zoekwoorden het meest zijn veranderd in kosten per acquisitie” is een volledige taak. Draai hem op een schema met de planning die je client al heeft (geplande taken in Claude of ChatGPT, of een cronjob die de Hermoso CLI of de API aanroept), en de sheet, en elk dashboard dat erop leest, blijft actueel.

Omdat dezelfde koppeling ook het account bewerkt, staan het rapport en de correctie op één plek: de agent die ziet dat de kosten per acquisitie van een zoekwoord zijn verdubbeld, kan het in hetzelfde gesprek pauzeren of een negatief zoekwoord toevoegen.

Veelgestelde vragen

Hoe exporteer ik gegevens uit Apple Search Ads?

Koppel Apple Ads één keer aan Hermoso, en vraag dan je agent om het rapport dat je wilt, bijvoorbeeld zoekwoordprestaties van vorige week. De tool apple_ads_report haalt het op uit de rapportage-API van Apple, en de agent schrijft het naar een Google Sheet, geeft je JSON, of beide.

Kan ik Apple Search Ads aan Google Sheets koppelen?

Ja. Koppel Apple Ads en Google Drive in Hermoso, en vraag dan de agent om het rapport in een sheet te zetten. Hij maakt de sheet aan met create_sheet, of voegt rijen toe aan een bestaande met append_to_sheet, en kan dat elke week herhalen.

Kan ik Apple Search Ads naar Looker Studio exporteren?

Ja, via Google Sheets. Hermoso heeft geen eigen Looker Studio-connector. De agent schrijft het rapport in een sheet, jij voegt die sheet één keer toe als Google Sheets-databron in Looker Studio, en elke toevoeging verschijnt bij de volgende vernieuwing van het dashboard.

Hoe exporteer ik Apple Search Ads-data naar JSON?

Roep POST /v1/tools/apple_ads_report aan op de Hermoso API met een API-sleutel en lees data.rows uit het antwoord, of draai hermoso call apple_ads_report --json '{...}' --structured vanuit de CLI. Beide geven dezelfde rijen als JSON.

Is er een rapportage-API voor Apple Search Ads?

Ja, en Hermoso is erop gebouwd. apple_ads_report dekt de prestaties van campagne, advertentiegroep, advertentie, zoekwoord en zoekterm, en de andere Apple Ads-tools bouwen en beheren het account.

Kan ik rapporten op zoektermniveau krijgen?

Ja. Vraag om het zoektermniveau en noem de campagne. Apple levert zoektermen alleen per campagne, in de eigen tijdzone van de organisatie.

Hoeveel rijen kan één rapport teruggeven?

Tot 5.000 per pagina, gesorteerd op uitgaven van hoog naar laag, met een vlag die de agent vertelt of er nog pagina's zijn. Een wekelijks zoekwoordrapport past voor de meeste accounts op één pagina.

Geldt dit ook voor advertenties op Apple Maps?

Ja. Rapporten voor business-brands-campagnes komen uit dezelfde tool, met het type promoted object ingesteld op Apple Maps in plaats van de App Store.

Heb ik een ontwikkelaar nodig om dit in te stellen?

Nee. Koppel Apple Ads één keer in de app, en vraag je agent dan in gewone taal: haal vorige week op per zoekwoord en zet het in een sheet. De API en de CLI zijn er als je het toch wilt scripten.