Get Meta Campaign Details

User wants to see detailed information about a specific Meta campaign, including its full structure (ad sets, ads, targeting, budgets).

This tool retrieves comprehensive details about a single campaign. With include_hierarchy=true, it shows the complete campaign tree: Campaign - Ad Sets - Ads.

Returns:

Campaign settings (name, status, objective, budget, bid strategy, schedule)
Performance summary (impressions, clicks, spend, reach, CTR, CPC)
Ads Manager URL
When include_hierarchy=true: Full structure with all ad sets and their ads, targeting details, hierarchy stats

When to use this tool:

“Show me details for campaign [ID]”
“What’s the structure of my campaign?”
“How many ad sets and ads does this campaign have?”
“What targeting is set on my campaign?”
“Show me the full campaign hierarchy”
After list_meta_campaigns when user wants to drill into a specific campaign

Parameters:

campaign_id: The Meta Campaign ID (required)
include_hierarchy: Include ad sets and ads (default: false, set true for full view)

Execution time: 3-10 seconds (longer with hierarchy due to multiple API calls) Data source: Meta Marketing API (live)

Workflow:

Use list_meta_campaigns to find campaign IDs
Use get_meta_campaign_details with include_hierarchy=true to see everything
Use update_meta_ad_set or update_meta_ad to make changes to specific items

POST

api

tools

get_meta_campaign_details

execute

Get Meta Campaign Details

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

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

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 getting detailed campaign information

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

Get Meta Campaign PerformanceUser asks about Meta/Facebook/Instagram ad performance, campaign metrics, ROAS, spend analysis, or wants to understand how their Meta ads are performing. This tool retrieves comprehensive campaign performance metrics from Meta Ads. Returns: - Account summary (total spend, impressions, reach, conversions, ROAS) - Campaign breakdown with status and objectives - Top performing campaigns by ROAS - Meta-specific metrics (reach, frequency, reach/impressions ratio) - Optimization recommendations When to use this tool: - "How are my Meta ads performing?" - "What's my Facebook campaign ROAS?" - "Show me Instagram ad performance" - "Which Meta campaigns are doing best?" - "Analyze my Meta ad spend" Parameters: - lookback_days: 7, 14, 30 (default), 60, or 90 days - start_date: Optional start date (YYYY-MM-DD). Overrides lookback_days when used with end_date. - end_date: Optional end date (YYYY-MM-DD). Overrides lookback_days when used with start_date. ⚠️ DATE CLARIFICATION: If the user's date request is vague or ambiguous (e.g., "March to June" without a year, "last quarter", "recently", "a few months ago"), ask the user to specify exact dates before calling this tool. Do not assume or guess dates. - include_recommendations: true (default) or false - ad_account_id: Required for multi-account users. Get from list_connected_accounts Execution time: 1-3 seconds (cached database query) Data source: campaign_daily_metrics table (updated nightly) Note: Unlike Google Ads, Meta does not have keyword or search term data. Meta uses interest-based targeting.

Get Meta Campaign Details

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

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