# Item API API

> Item API API on Apizie: 6 endpoints (Get status of an item feed, Upload an item feed, Get status of an item within a feed, Get status of an item feed, …) returned as clean JSON through one API key. 6 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/ecommerce:walmart-item/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `ecommerce:walmart-item`
- Category: E-commerce
- Status: live
- Source: https://walmart.com
- Page: https://zieapi.vercel.app/api/ecommerce/walmart-item
- OpenAPI: https://zieapi.vercel.app/api/ecommerce/walmart-item/openapi.json

Please make sure you use the correct version of the APIs for your use case. To find out the appropriate version, go to the API Docs drop down on the menu.

## Endpoints

### Get status of an item feed
`GET https://zieapi.vercel.app/v1/ecommerce:walmart-item/v2get-feed-item-status`

| Parameter | Type | Required | Description |
|---|---|---|---|
| feedId | string | no | The feed ID. |
| includeDetails | string | no | Includes the status details for each item in the feed. Do not set this parameter to true as discrepancies may appear between the header… |
| offset | string | no | The object response to start with, where 0 is the first entity that can be requested. It can only be used when includeDetails is set to… |
| limit | string | no | The number of items to be returned. Cannot be more than 50 items. Use it only when the includeDetails is set to true. |
| WM_CONSUMER.CHANNEL.TYPE | string | yes | Channel Type |
| WM_CONSUMER.ID | string | yes | Your Consumer ID |
| WM_SEC.TIMESTAMP | string | yes | Epoch timestamp |
| WM_SEC.AUTH_SIGNATURE | string | yes | Authentication signature |
| WM_SVC.NAME | string | yes | The Service name |
| WM_QOS.CORRELATION_ID | string | yes | A Transaction ID |

### Upload an item feed
`POST https://zieapi.vercel.app/v1/ecommerce:walmart-item/v2do-post-multi-part`

| Parameter | Type | Required | Description |
|---|---|---|---|
| feedType | string | no | Feed Type |
| WM_CONSUMER.CHANNEL.TYPE | string | yes | Channel Type |
| WM_CONSUMER.ID | string | yes | Your Consumer ID |
| WM_SEC.TIMESTAMP | string | yes | Epoch timestamp |
| WM_SEC.AUTH_SIGNATURE | string | yes | Authentication signature |
| WM_SVC.NAME | string | yes | The Service name |
| WM_QOS.CORRELATION_ID | string | yes | A Transaction ID |
| body | object | yes | Form fields as a JSON object |

### Get status of an item within a feed
`GET https://zieapi.vercel.app/v1/ecommerce:walmart-item/v2get-all-items-status`

| Parameter | Type | Required | Description |
|---|---|---|---|
| feedId | string | yes | The feed ID |
| includeDetails | string | no | Includes details of each entity in the feed. Do not set this parameter to true. |
| offset | string | no | The object response to start with, where 0 is the first entity that can be requested. It can only be used when includeDetails is set to… |
| limit | string | no | The number of entities to be returned. It cannot be more than 50 entities. Use it only when the includeDetails is set to true. |
| WM_CONSUMER.CHANNEL.TYPE | string | yes | Channel Type |
| WM_CONSUMER.ID | string | yes | Your Consumer ID |
| WM_SEC.TIMESTAMP | string | yes | Epoch timestamp |
| WM_SEC.AUTH_SIGNATURE | string | yes | Authentication signature |
| WM_SVC.NAME | string | yes | The Service name |
| WM_QOS.CORRELATION_ID | string | yes | A Transaction ID |

### Get status of an item feed
`GET https://zieapi.vercel.app/v1/ecommerce:walmart-item/v3get-feed-item-status`

| Parameter | Type | Required | Description |
|---|---|---|---|
| feedId | string | no | The feed ID. |
| includeDetails | string | no | Includes the status details for each item in the feed. Do not set this parameter to true as discrepancies may appear between the header… |
| offset | string | no | The object response to start with, where 0 is the first entity that can be requested. It can only be used when includeDetails is set to… |
| limit | string | no | The number of items to be returned. Cannot be more than 50 items. Use it only when the includeDetails is set to true. |
| WM_CONSUMER.CHANNEL.TYPE | string | yes | Channel Type |
| WM_CONSUMER.ID | string | yes | Your Consumer ID |
| WM_SEC.TIMESTAMP | string | yes | Epoch timestamp |
| WM_SEC.AUTH_SIGNATURE | string | yes | Authentication signature |
| WM_SVC.NAME | string | yes | The Service name |
| WM_QOS.CORRELATION_ID | string | yes | A Transaction ID |

### Upload an item feed
`POST https://zieapi.vercel.app/v1/ecommerce:walmart-item/v3do-post-multi-part`

| Parameter | Type | Required | Description |
|---|---|---|---|
| feedType | string | no | Feed Type |
| WM_CONSUMER.CHANNEL.TYPE | string | yes | Channel Type |
| WM_CONSUMER.ID | string | yes | Your Consumer ID |
| WM_SEC.TIMESTAMP | string | yes | Epoch timestamp |
| WM_SEC.AUTH_SIGNATURE | string | yes | Authentication signature |
| WM_SVC.NAME | string | yes | The Service name |
| WM_QOS.CORRELATION_ID | string | yes | A Transaction ID |
| body | object | yes | Form fields as a JSON object |

### Get status of an item within a feed
`GET https://zieapi.vercel.app/v1/ecommerce:walmart-item/v3get-all-items-status`

| Parameter | Type | Required | Description |
|---|---|---|---|
| feedId | string | yes | The feed ID |
| includeDetails | string | no | Includes details of each entity in the feed. Do not set this parameter to true. |
| offset | string | no | The object response to start with, where 0 is the first entity that can be requested. It can only be used when includeDetails is set to… |
| limit | string | no | The number of entities to be returned. It cannot be more than 50 entities. Use it only when the includeDetails is set to true. |
| WM_CONSUMER.CHANNEL.TYPE | string | yes | Channel Type |
| WM_CONSUMER.ID | string | yes | Your Consumer ID |
| WM_SEC.TIMESTAMP | string | yes | Epoch timestamp |
| WM_SEC.AUTH_SIGNATURE | string | yes | Authentication signature |
| WM_SVC.NAME | string | yes | The Service name |
| WM_QOS.CORRELATION_ID | string | yes | A Transaction ID |

## Example
```
curl "https://zieapi.vercel.app/v1/ecommerce:walmart-item/v2get-feed-item-status" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the Item API API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/ecommerce:walmart-item/v2get-feed-item-status with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Item API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the Item API API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key ecommerce:walmart-item.

### What is the status of the Item API API?
Live: works with just an Apizie key
