Integrations / HTTP
HTTP
Search
The same call as in n8n and Make. The agent reads items.
Request
POST /v1/catalog/my_shop/search. Header Authorization: Bearer nwp_…. The body is the customer's words and a limit.
| Field | Default | Meaning |
|---|---|---|
q | empty | Search query |
limit | 5 | From 1 to 20 |
sku | empty | Exact SKU |
in_stock_only | false | Only items in stock |
Response fields
| Field | For the agent |
|---|---|
items | SKU, price, stock, link, photo |
catalog.stale | The collection is old; confirm the price |
In stock means the item is available. Stock not set means the feed left stock empty. Out of stock means it is not available. More on the Answer page.
Card, tools, and collect
GET /v1/catalog/my_shop/products/SKU— one item. An unknown SKU returns 404.GET /v1/catalog/my_shop/tools?format=openai— the search description for an agent. Formats:openai,anthropic,schema.POST /v1/catalog/my_shop/collect— pull the feed now. Same Bearer key as search. Use after prices or stock change (n8n / Make / CMS).
Error codes are collected on Search API.