↑ ↓ to move ↵ to open
Nana Express API reference

Nana Express One Product by Pid

nana.product.get

Read one product from a store by its stable pid, with price, stock, status and pack details.

At a glance

Endpoint ID
nana.product.get
Price
1 credit per call; failed calls are free
Runs for up to
30 seconds
Request
POST /execute
Run an endpoint
MCP tool when pinned
nana__product__get
Pin tools
OpenAPI
openapi.json
Download

Request

Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.

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.product.get",  "input": {    "pid": "PID10000257",    "store_id": "STR00002232"  }}'

Input

FieldTypeRequiredWhat it doesExample
pid string yes Stable product id as returned by products.list or products.search, for example PID10000257. Inventory ids (INVP…) are a different route and answer not_found here. PID10000257
store_id string yes Nana store id the product must be listed in. STR00002232

Response

A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.

This is results[0].data from a real run:

results[0].data
{  "product": {    "name": "Luna Sweetened Condensed Milk - 370g",    "price": 8.5,    "brand": "Luna",    "currency": "SAR",    "in_stock": true,    "max_quantity": 46,    "pid": "PID10000257",    "size_text": "370 g"  }}

Fields

FieldTypeExample
product object 8 fields
product.brand string Luna
product.currency string SAR
product.in_stock boolean true
product.max_quantity integer 46
product.name string Luna Sweetened Condensed Milk - 370g
product.pid string PID10000257
product.price number 8.5
product.size_text string 370 g

If a call fails

A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.

Other Nana Express endpoints

Something missing or unclear? Ask the team that builds the Nana Express endpoints.