Nana Express scraper API

Go client library for scraping Nana Express grocery stores in Saudi Arabia.

Commerce & delivery 3 capabilities stable 78.0% success rate Streaming

Capabilities

Every capability is one POST /execute call that returns structured JSON.

Categories List


            nana.categories.list

List categories available in a Nana store.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"store_id":"STR00002232"},"capability":"nana.categories.list"}'

Input

Field	Type	Required	Description
`store_id`	string	required	The store ID obtained from nana.store.get

Products List


            nana.products.list

Streaming

List products for a Nana store category.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"category_id":"COL2581000813","store_id":"STR00002232"},"capability":"nana.products.list"}'

Input

Field	Type	Required	Description
`category_id`	string	required	The category ID obtained from nana.categories.list
`category_name`	string	optional	Optional category display name from nana.categories.list, preserved in normalized output.
`store_id`	string	required	The store ID obtained from nana.store.get

Output

Field	Type	Required
`products`	array<object>	required
`products[].barcode`	string	optional
`products[].brand`	string	optional
`products[].currency`	string	optional
`products[].dynamics_product_id`	string	optional
`products[].id`	string	required
`products[].image_url`	string	optional
`products[].in_stock`	boolean	optional
`products[].item_unit`	string	optional
`products[].max_quantity`	integer	optional
`products[].name`	string	required
`products[].pid`	string	optional
`products[].price`	number	optional
`products[].selling_unit`	string	optional
`products[].size`	string	optional

Store Get


            nana.store.get

Resolve the Nana store for a geographic location.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"location":{"latitude":24.70886700126982,"longitude":46.687542982399464}},"capability":"nana.store.get"}'

Input

Field	Type	Required	Description
`location`	object	required	Geographic coordinates for store lookup
`location.latitude`	number	required	Latitude of the location (e.g., 24.7089 for Riyadh)
`location.longitude`	number	required	Longitude of the location (e.g., 46.6875 for Riyadh)

Related scrapers

HungerStation Market Keeta Keemart Panda Saudi Arabia TalabatMart

Run Nana Express in under a minute

Get an API key