Amazon Ads Write
POWER TOOL — direct access to Amazon's modern unified Ads API (/adsApi/v1 create|query|update|delete on campaigns|adGroups|ads|targets|adExtensions across ALL ad products)
POST https://api.adspirer.ai/api/v1/tools/amazon_unified_api/execute
Authorization: Bearer sk_live_... — your Adspirer API key (required)Content-Type: application/json (required)Idempotency-Key: <uuid> — recommended for write operations to make retries safeAll tool arguments are wrapped in an arguments object.
| Field | Type | Description |
|---|---|---|
profile_id | string optional | Amazon Ads profile ID (advertiser account). Omit to use the user's selected account. Find IDs with list_amazon_profiles. |
resource | string required | 'campaigns' | 'adGroups' | 'ads' | 'targets' | 'adExtensions'. adExtensions (SP video / prompt extensions) supports create/query/update ONLY — Amazon has no delete for it. |
verb | string required | 'create' | 'query' | 'update' | 'delete' (delete not valid for adExtensions) |
ad_product | string optional | Required for query/delete: SPONSORED_DISPLAY | SPONSORED_PRODUCTS | SPONSORED_BRANDS | SPONSORED_TELEVISION |
items | array optional | create/update: entity objects, each MUST carry adProduct. Targets example: {adProduct: 'SPONSORED_DISPLAY', campaignId, adGroupId, targetType: 'AUDIENCE'|'KEYWORD'|'PRODUCT'|'PRODUCT_CATEGORY'|'THEME', negative: false, state: 'ENABLED', targetDetails: {...}, bid?}. ⚠️ adExtensions CREATE supports adProduct SPONSORED_BRANDS | SPONSORED_DISPLAY | AMAZON_DSP ONLY — NOT SPONSORED_PRODUCTS (SP ad extensions are created in the Amazon console, not via API; create with SP returns ACTION_NOT_SUPPORTED). adExtensions QUERY works for all incl. SP (read existing extensions). adExtensions UPDATE only changes state/marketplaces — it CANNOT change the video/settings (Amazon ignores those fields). |
ids | array optional | delete: entity IDs |
filters | array optional | query: extra filters, e.g. [{'campaignIdFilter': {'include': ['123']}}]. For adExtensions: [{'adIdFilter': {'include': ['<productAdId>']}}] to list a specific ad's extensions. |
max_results | integer optional | query page size default: 100 |
{
"arguments": {
"resource": "string",
"verb": "string",
"profile_id": "string",
"ad_product": "string",
"items": [
{}
],
"ids": [
"string"
],
"filters": [
{}
],
"max_results": 100
}
}
{
"success": true,
"data": {
"text": "(tool-specific textual output for amazon_unified_api)",
"quota": {
"used": 42,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01"
}
},
"tool": "amazon_unified_api"
}
{
"success": false,
"error": "You have 25 meta_ads accounts connected. Please specify which account to use by passing the ad_account_id parameter:\n - Acme Holdings (ad_account_id=\"act_123456789\")\n - Acme EU (ad_account_id=\"act_987654321\")",
"is_error": true,
"tool": "amazon_unified_api"
}
{
"success": false,
"error": "\ud83d\udea8 Monthly limit reached (150/150 tool calls on Plus tier).\nUpgrade to Pro at https://adspirer.ai to keep building.",
"is_error": true,
"tool": "amazon_unified_api",
"quota": {
"used": 150,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01",
"upgrade_url": "https://adspirer.ai"
}
}
Interactive: Swagger UI
Machine-readable: OpenAPI 3.1 spec · llms-full.txt
More tools: Amazon Ads · All tools
Adspirer REST API — get an API key at adspirer.ai/keys · adspirer.ai