Amazon Ads Read
Read an Amazon ad's moderation (review) status — APPROVED, IN_PROGRESS, REJECTED, or FAILED — including per-component (image/text/VIDEO) results and policy-violation details when rejected
POST https://api.adspirer.ai/api/v1/tools/get_amazon_moderation/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. |
ad_id | string required | The ad ID to check moderation status for (the productAd ID for SP). |
ad_program_type | string optional | SPONSORED_PRODUCTS | SPONSORED_DISPLAY | SB_PRODUCT_COLLECTION | SB_STORE_SPOTLIGHT | SB_VIDEO default: "SPONSORED_PRODUCTS" |
max_results | integer optional | Max results (1-10). default: 10 |
moderation_status_filter | array optional | Filter to statuses: APPROVED | IN_PROGRESS | REJECTED | FAILED |
version_id_filter | array optional | Filter to specific ad version ids (SB creative version). Empty = all versions. |
next_token | string optional | Pagination token from a prior page. |
{
"arguments": {
"ad_id": "string",
"profile_id": "string",
"ad_program_type": "SPONSORED_PRODUCTS",
"max_results": 10,
"moderation_status_filter": [
"string"
],
"version_id_filter": [
"string"
],
"next_token": "string"
}
}
{
"success": true,
"data": {
"text": "(tool-specific textual output for get_amazon_moderation)",
"quota": {
"used": 42,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01"
}
},
"tool": "get_amazon_moderation"
}
{
"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": "get_amazon_moderation"
}
{
"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": "get_amazon_moderation",
"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