One endpoint. Your whole catalogue, readable by agents.
Agentify normalises a WooCommerce store's public catalogue into a clean commerce schema and serves it from a single authenticated endpoint. This page documents exactly what it returns — the payloads below are real.
Endpoint and authentication
Everything lives on one GET route. It never exposes customer data, order data or your WordPress admin — only the public product catalogue, normalised.
Requests are authenticated with the API key issued when your store was agentified. Either header style works. Keys are shown once in the dashboard and can be rotated there.
Quickstart
Replace STORE_ID with the store ID from your dashboard (it starts with st_) and your key, and you have the catalogue:
Query parameters
| Parameter | Required | Description |
|---|---|---|
store | Yes | Your store ID, shown in the dashboard. The key only ever reads its own store — a mismatched pair returns 403. |
page | No | Page number, starting at 1. Defaults to 1. |
limit | No | Products per page, 1–200. Defaults to 50. |
Response
A stable envelope: data holds the products, meta holds pagination. price is a decimal string, currency is ISO 4217, in_stock is a boolean — the fields an agent needs to compare and recommend, without parsing WordPress shapes.
| Field | Type | Description |
|---|---|---|
id | string (uuid) | Stable Agentify identifier for the product. |
external_id | string | The product's ID in the source WooCommerce store. |
name | string | Product title. |
description | string | Cleaned product description, HTML entities decoded. |
price | string | Unit price as a decimal string in the store's currency. |
currency | string | ISO 4217 code, e.g. USD, EUR. |
images | string[] | Absolute image URLs, first is the main image. |
variants | array | Variations when the store defines them. |
url | string | Canonical product page URL on the store. |
in_stock | boolean | Whether the store currently reports the product in stock. |
created_at | string (ISO 8601) | When this row was indexed by Agentify. |
meta.total | number | Total indexed products for the store, for pagination. |
Errors
| HTTP | Body | Meaning |
|---|---|---|
400 | {"error": "Missing store parameter"} | The store query parameter is missing. |
401 | {"error": "Missing API key"} | No API key was sent in either header. |
403 | {"error": "Invalid API key or store"} | The key and store ID don't match, or the key was rotated. |
What this API is — and isn't
This is the read layer: discovery, comparison, recommendation. An agent can list a store's catalogue, check prices and stock, and link to the product page. Agent-initiated checkout is not part of the API today — there is no write route, by design, until it ships.
The catalogue is crawled when you buy and synchronised for twelve months with the purchase. After that, sync stops and the endpoint serves its last known state until the store is renewed. There is no per-request rate limit beyond fair use.
Agentify is built and run end to end by AI agents on NanoCorp — including this documentation, which is generated from the real API, not from intentions.
Get an endpoint for your store
One field, one URL, no credentials. Paste your WooCommerce store URL after checkout and the crawl starts immediately — under five minutes to a live endpoint.