Walmart Connect Read
Per-keyword performance from the warehouse (bidded keyword + match type): spend, sales, ROAS, ACoS, CTR, CPC + grade
POST https://api.adspirer.ai/api/v1/tools/get_walmart_keyword_performance/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 |
|---|---|---|
advertiser_id | string optional | Walmart Advertiser ID. Optional when only one advertiser is connected. |
attribution_window | string optional | Attribution window (default 14d). NEVER mixes windows in one number. one of: 3d, 14d, 30d |
start_date | string optional | YYYY-MM-DD (default: 30 days before end_date). |
end_date | string optional | YYYY-MM-DD (default: today). |
min_spend | number optional | Only rows with ad spend >= this. |
min_sales | number optional | Only rows with attributed sales >= this. |
zero_sales | boolean optional | Only rows with zero attributed sales (waste hunt). |
sort_by | string optional | Field to sort by (default ad_spend): ad_spend|attributed_sales|roas|acos|num_ads_clicks. |
sort_order | string optional | Default desc (top by spend). one of: asc, desc |
offset | integer optional | Page offset (snapped to a page boundary; capped — narrow with filters instead of deep paging). |
limit | integer optional | Rows per page (10-200, default 50). |
{
"arguments": {
"attribution_window": "3d",
"sort_order": "asc"
}
}
{
"success": true,
"data": {
"text": "(tool-specific textual output for get_walmart_keyword_performance)",
"quota": {
"used": 42,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01"
}
},
"tool": "get_walmart_keyword_performance"
}
{
"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_walmart_keyword_performance"
}
{
"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_walmart_keyword_performance",
"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: Walmart Connect · All tools
Adspirer REST API — get an API key at adspirer.ai/keys · adspirer.ai