Walmart Connect Read
List keywords in a Walmart campaign (text, match type, bid, state)
POST https://api.adspirer.ai/api/v1/tools/list_walmart_keywords/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. |
campaign_id | string optional | Walmart Campaign ID. |
query | string optional | Free-text search across names/ids/text (case-insensitive). |
status_filter | string optional | Comma-separated status/state values to keep (e.g. 'live,paused'). Omit for all. |
type_filter | string optional | Comma-separated type values to keep (campaignType / matchType / placementType). |
sort_by | string optional | Field to sort by (e.g. name, dailyBudget, bid). Unknown/absent values sort last. |
sort_order | string optional | Sort direction (default asc). one of: asc, desc |
start_after | string optional | Keep rows dated on/after this date (YYYY-MM-DD), where the entity has a date. |
end_before | string optional | Keep rows dated on/before this date (YYYY-MM-DD). |
offset | integer optional | Row offset for paging (default 0). |
limit | integer optional | Max rows per page (default 50, capped at 200). The response reports total, filtered and has_more. |
{
"arguments": {
"sort_order": "asc"
}
}
{
"success": true,
"data": {
"text": "(tool-specific textual output for list_walmart_keywords)",
"quota": {
"used": 42,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01"
}
},
"tool": "list_walmart_keywords"
}
{
"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": "list_walmart_keywords"
}
{
"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": "list_walmart_keywords",
"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