List Campaign Extensions

List all extensions (sitelinks, callouts, structured snippets) for a campaign.

Returns a summary of all extension types configured on the campaign.

Parameters:

campaign_id: The campaign ID (REQUIRED). Get from list_campaigns.
customer_id: Optional Google Ads customer ID

Returns:

Sitelinks: Clickable links with text, URL, and descriptions
Callouts: Non-clickable text highlights
Structured Snippets: Header + values combinations

Execution time: 1-2 seconds (read-only)

When to use:

User asks “what extensions do I have?”
Before adding extensions, check what already exists
Auditing campaign setup

Example: User: “Show me the extensions on my campaign” Agent:

Uses list_campaigns to get campaign_id
Uses list_campaign_extensions to see all extensions

POST

/

api

/

v1

/

tools

/

list_campaign_extensions

/

execute

List Campaign Extensions

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/list_campaign_extensions/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "campaign_id": "<campaign_id>",
    "customer_id": "string"
  }
}
'

{
  "data": {
    "quota": {
      "limit": 150,
      "period_end": "2026-05-01",
      "tier": "plus",
      "used": 42
    },
    "text": "(tool-specific textual output for list_campaign_extensions)"
  },
  "success": true,
  "tool": "list_campaign_extensions"
}

Authorizations

Authorization

string

header

required

API key from https://adspirer.ai/keys. Prefix sk_live_. Treat as a secret — never commit.

Headers

Idempotency-Key

string<uuid>

Client-generated UUID to make writes idempotent. Strongly recommended for write tools. A repeat call with the same key returns the cached result instead of re-executing. Example: 550e8400-e29b-41d4-a716-446655440000

Body

application/json

All tool arguments are wrapped in an arguments object. The fields accepted inside arguments are listed below — required fields are marked with a red asterisk.

arguments

object

required

Input schema for listing all extensions on a campaign.

Returns all sitelinks, callouts, and structured snippets for the campaign.

Show child attributes

Response

Tool executed successfully. data.text carries the human-readable result (markdown-friendly). data.quota shows your current usage against the plan limit. data.structured appears when the tool emits machine-parseable structured content. data.content appears for tools that return non-text blocks (images, resources).

Returned on HTTP 200. data.text is the primary human-readable output. data.quota is always present for billable calls. data.structured is set only when the tool emits machine-parseable structured content. data.content is set only when the tool emits non-text content blocks.

data

object

required

Show child attributes

success

boolean

required

tool

string

required

Echoed tool_name from the request URL.

Last modified on April 23, 2026

List CampaignsList all Google Ads campaigns for the connected account. ⚠️ CRITICAL: Call this tool BEFORE creating new campaigns to ask the user: "Would you like to create a new campaign or update an existing one?" This tool retrieves READ-ONLY data. Safe to call multiple times. **Returns:** - List of all campaigns with IDs, names, status, type, budget - 30-day performance metrics for each campaign (impressions, clicks, cost, conversions) - Total campaign count **Parameters:** - status_filter: ENABLED, PAUSED, or ALL (optional, default: ALL) - campaign_type: SEARCH, PERFORMANCE_MAX, DISPLAY, SHOPPING, or ALL (optional, default: ALL) - customer_id: Optional (uses connected account if omitted) **Execution time:** 2-5 seconds (direct Google Ads API call) **Campaign Management Guidelines:** BEFORE Starting Any Campaign Work: 1. ALWAYS use `list_campaigns` first 2. Ask user: "Would you like to create a new campaign or update an existing one?" 3. If updating, use `get_campaign_structure` to see full details User Intent Mapping: | User Says | Agent Action | |-----------|--------------| | "Create a campaign for X" | List existing first, then ask create vs update | | "Change the budget" | Get structure, then use update tools | | "Add more keywords" | Get structure, then add keywords | | "Update my ads" | Get structure, then update ad content | | "Pause the campaign" | Use pause_campaign tool | **Use this tool to:** - View all existing campaigns before creating new ones - Find campaign IDs for update operations - Get a quick overview of account structure - Identify active vs paused campaigns

List Campaign Extensions

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/list_campaign_extensions/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "campaign_id": "<campaign_id>",
    "customer_id": "string"
  }
}
'

{
  "data": {
    "quota": {
      "limit": 150,
      "period_end": "2026-05-01",
      "tier": "plus",
      "used": 42
    },
    "text": "(tool-specific textual output for list_campaign_extensions)"
  },
  "success": true,
  "tool": "list_campaign_extensions"
}