Execute a Google GAQL query

GET

/api/v1/google/gaql

Executes a raw or structured Google Ads Query Language request for a validated ad account owned by the authenticated external user.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Header Params

Responses

🟢200OK

application/json

GAQL result set flattened across the resolved account ids, echoing the executed query and per-account currency codes.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.adlyfy.dev/api/v1/google/gaql' \
--header 'x-api-key;' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "success": true,
    "message": "Request successful",
    "timestamp": "2026-03-30T12:00:00.000Z",
    "statusCode": 200,
    "data": {
        "data": [
            {
                "campaign": {
                    "resourceName": "customers/1234567890/campaigns/11111111",
                    "id": "11111111",
                    "name": "Search - Brand",
                    "status": "ENABLED"
                },
                "metrics": {
                    "impressions": "52000",
                    "clicks": "3100"
                }
            }
        ],
        "gaqlQuery": "SELECT campaign.id, campaign.name, campaign.status, metrics.impressions, metrics.clicks FROM campaign",
        "accountIds": [
            "1234567890"
        ],
        "currencyCodes": {}
    }
}

Read Google assets

StandardSuccessEnvelopeDto