---
title: "List Google Ads advertising languages"
method: GET
path: "/api/apps/{app_id}/google-ads/languages"
---

# List Google Ads advertising languages

`GET /api/apps/{app_id}/google-ads/languages`

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/apps/{app_id}/google-ads/languages`
- Auth: HTTP bearer

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

Returns the languages a campaign's ads can run in.

These are the codes the rest of the Google Ads endpoints accept as an ads language, for example `language_code` on [Estimate Google Ads cost per click](/api-reference/estimate-google-ads-cost-per-click). The list is the same for every app and changes only when Base44 adds a language, so you can cache it. The app does not need a Google Ads account.

This is limited to 120 requests a minute per app, shared with [Get Google Ads campaign launch draft](/api-reference/get-google-ads-campaign-launch-draft). Some workspaces have a different limit.

<Note>This endpoint accepts a personal API key from anyone who can view the app, including a read-only 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 whose Google Ads campaigns to manage.

## Response `200`

The supported ads languages.

- GoogleAdsAdvertisingLanguages: The languages a campaign's ads can run in.
  - `languages` string[], required: Two-letter ISO 639-1 codes, sorted alphabetically. Name them in your own interface language yourself; the API returns codes only.

## Other responses

- `401`: Missing or invalid credentials.
- `403`: You can't view 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 app has used up the 120 requests a minute it shares with Get Google Ads campaign launch draft. Retry later.

## Changes

- **2026-10-11** `80287813ab84`: 1 info
  - the endpoint scheme security `PersonalAccessTokenAuth` was added to the API
- **2026-10-10** `fc604cdcc3a2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/idealspot/apis/base44-app-management-api/changes/api/apps/:app_id/google-ads/languages/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.dev/idealspot/apis/base44-app-management-api/revisions/b5b4ebd82a1e?raw)