---
title: "Walmart's keywordAnalytics per item: the queries shoppers use that lead to each item, with Walmart's High/Medium/Low frequency for the item and for the query's traffic overall"
method: POST
path: "/walmart/advertisers/{public_id}/keyword-analytics"
tags: ["walmart"]
---

# Walmart's keywordAnalytics per item: the queries shoppers use that lead to each item, with Walmart's High/Medium/Low frequency for the item and for the query's traffic overall

`POST /walmart/advertisers/{public_id}/keyword-analytics`

## Request

- Base URL: `https://api.autron.ai`
- URL: `https://api.autron.ai/walmart/advertisers/{public_id}/keyword-analytics`
- Auth: API key in header `Authorization`

A read for the cold start: what to target before any campaign has data.

## Request body

- WalmartKeywordAnalyticsRequest
  - `item_ids` union[], required: Walmart item ids (numeric strings or numbers), 1 to 20, from the advertiser's own catalog
    - union
      - string
      - integer

## Response `200`

Success

- WalmartKeywordAnalyticsRow[]
  - `item_id` string: the item the query belongs to
  - `normalized_query` string: the query as Walmart normalises it
  - `raw_query` string: the query as shoppers type it
  - `item_keyword_frequency` string: how often the query leads to this item: High | Medium | Low
  - `traffic_keyword_frequency` string: how much search traffic the query carries overall: High | Medium | Low

## Other responses

- `400`: item_ids missing, empty, more than 20, or not numeric.
- `403`: Walmart has not granted Autron access to this advertiser.
- `502`: Walmart refused or did not answer; the message carries Walmart's text.
- `503`: No Walmart credentials on this environment.

---

[API](https://skmtc.dev/autron/apis/autron-api.md) · [All operations](https://skmtc.dev/autron/apis/autron-api/llms.txt) · [OpenAPI document](https://skmtc.dev/autron/apis/autron-api/revisions/f696bfa7295f?raw)