Nana Express API · Endpoint

Nana Express Categories API

Q: What do I send?

Send store_id. The input fields below list every option with its type and limits.

Q: Can my AI agent call it?

Yes, over MCP: the agent finds nana.categories.list, checks its price and runs it with the same credits as the REST API.

A Nana store's category tree, each category with its subcategories and how many products they hold.

1 credit per call
Failed calls are free
Updated 27 Sep 2026
nana.categories.list

Start free, 100 credits API reference

Response completed

{  "categories": [    {      "name": "Chilled Meat",      "id": "COL7214322072",      "children": [        {          "name": "Minced Meat",          "id": "COL2065829044",          "product_count": 2        },        {          "name": "Boneless Meat",          "id": "COL3303748058",          "product_count": 8        }      ]    },    {      "name": "Water & Ice",      "id": "COL1139197048",      "product_count": 39,      "children": [        {          "name": "Flavoured Water",          "id": "COL3926903428",          "product_count": 2        },        {          "name": "Sparkling Water",          "id": "COL5382064033",          "product_count": 11        }      ]    }  ]}

47 rows

#	Category	ID	Product count
1	Chilled Meat	COL7214322072
2	Water & Ice	COL1139197048	39
3	Rice, Pasta & Grains	COL6082763880	129
4	Chips & Savory Snacks	COL5580083228	107
5	Chocolate & Cake	COL4850933640	152
6	Biscuits & Cookies	COL6012070401	260
7	Candies & Gums	COL1006788405	165
8	Coffee	COL1106239060	78
9	Nuts & Dried Fruits	COL7691324107	21
10	Carbonated & Energy Drinks	COL1167091990	158

Try it live, free

Input

What you send

The input object of the request, with every field the endpoint accepts.

Field	Type	Required	What it does	Example
store_id	string	yes	The Nana store's ID, such as STR00002232.	STR00002232

Response

Fields it returns

What each record in the response holds, with the values from the sample above.

Field	Type	What it is	Example
categories[].name	string	The name of the category or product.	Chilled Meat
categories[].id	string	Nana's ID for it.	COL7214322072
categories[].children[].name	string	The subcategory's name.	Minced Meat
categories[].children	array	The sub-categories.	3 records
categories[].children[].id	string	Nana's ID for the subcategory.	COL2065829044
categories[].children[].product_count	integer	How many products the subcategory has.	2
categories	array	The categories.	47 records

REST API · MCP server

Call it from your code, or ask your agent

Set UPSCRAPE_API_KEY to your key and copy a working request.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "nana.categories.list",  "input": {    "store_id": "STR00002232"  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "nana.categories.list",  "input": {    "store_id": "STR00002232"  }}''')response = requests.post(    "https://data.upscrape.com/execute",    headers={        "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}",        "Content-Type": "application/json",        "Prefer": "wait=30",    },    json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))

const response = await fetch("https://data.upscrape.com/execute", {  method: "POST",  headers: {    "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`,    "Content-Type": "application/json",    "Prefer": "wait=30",  },  body: JSON.stringify({  "capability": "nana.categories.list",  "input": {    "store_id": "STR00002232"  }}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));