---
title: "Get a Google Ads hero preview"
method: GET
path: "/api/apps/{app_id}/google-ads/ai/hero-preview"
---

# Get a Google Ads hero preview

`GET /api/apps/{app_id}/google-ads/ai/hero-preview`

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Writes one sample search result for the app, to show someone what their ad could look like before they connect a Google Ads account.

This is illustrative copy, not a campaign, and nothing is saved. It is built from the app's own description, so it works before there is an account, a campaign, or any business details on file.

Check `source` before you present this as generated copy: `fallback` means the model did not run or came back empty and you are looking at generic text. The response is a 200 either way.

<Note>This endpoint runs a language model and draws on a shared quota of 20 requests per minute per app, which every Google Ads AI endpoint debits. Enterprise workspaces get a higher quota. A 429 means the quota is spent, not that this endpoint has its own limit.</Note>

<Note>The copy is written in the language you send in the `Accept-Language` header. Omit the header and you get English — the app's own language is not consulted — so send it explicitly for a non-English app.</Note>

<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>

## Path parameters

- `app_id` string, required — ID of the app you are planning a Google Ads campaign for.

## Headers

- `Accept-Language` string, nullable — Language to return generated text in, as a standard `Accept-Language` value. An unsupported language falls back to English.

## Response `200`

A sample search result for the app.

- GoogleAdsHeroPreview — A sample search result to show before the app has a Google Ads account.
  - `search_query` string, required — A search someone might type to find this business.
  - `headline` string, required — Headline of the sample ad.
  - `description` string, required — Body text of the sample ad.
  - `subtitle` string, required — The display line shown under the headline, usually the site.
  - `business_name` string, required — The business name this preview was written for, taken from the app.
  - `source` string, required — `ai` when a language model wrote this preview, `fallback` when it did not run or returned nothing and Base44 filled in generic copy instead.

## Other responses

- `401` — Missing or invalid credentials.
- `403` — You don't have access to this app, the app does not exist, or you used a workspace API key. A missing app and an app you cannot reach are deliberately the same answer.
- `429` — The shared AI quota for this app is spent. Retry in a minute.

## Changes

- **2026-08-30** `394136a6cdd4` — 1 info
  - removed the non-success response with the status `422`
- **2026-08-26** `f2727732ced1` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/idealspot/apis/base44-app-management-api/changes/api/apps/:app_id/google-ads/ai/hero-preview/get.md)

---

[API](https://skmtc.dev/idealspot/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/idealspot/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/idealspot/base44-app-management-api/revisions/173e4e9c63c2/schema)