---
title: "Walmart's itemSearch over the advertiser's OWN catalog: name, image, page and suggested bid per item, at most 25 rows"
method: GET
path: "/walmart/advertisers/{public_id}/items"
tags: ["walmart"]
---

# Walmart's itemSearch over the advertiser's OWN catalog: name, image, page and suggested bid per item, at most 25 rows

`GET /walmart/advertisers/{public_id}/items`

## Request

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

`[]` is a real answer — the word matches nothing this advertiser sells.

## Query parameters

- `q` string
- `ids` string

## Response `200`

Success

- WalmartItem[]
  - `item_id` string: Walmart item ID as a string (the number in the item's walmart.com/ip/ URL) — what a goal binds to
  - `item_name` string: the item's title on walmart.com
  - `item_image_url` string: the item's primary image
  - `item_page_url` string: the item's walmart.com page
  - `suggested_bid` number, nullable: Walmart's suggested opening bid for the item, or null when it offers none
  - `variant_item_ids` string[]: item IDs of the item's variants (Walmart's variantItems[].variantItemId); empty when it has none

## Other responses

- `400`: Neither or both of q and ids; q outside 2-100 characters; ids not numeric or more than 20.
- `403`: Walmart has not granted Autron access to this advertiser.
- `502`: Walmart refused or did not answer the search; 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)