Merran documentation API & integrations
What Walmart had for a thing on the list
GET
/api/stores/walmart/products/{itemId}
const url = 'http://localhost:3000/api/stores/walmart/products/0199e8b0-5a10-7a01-8b00-00000000001d';const options = { method: 'GET', headers: {cookie: 'merran.session_token=<merran.session_token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url http://localhost:3000/api/stores/walmart/products/0199e8b0-5a10-7a01-8b00-00000000001d \ --cookie merran.session_token=<merran.session_token>The products Walmart’s search had for its food when Merran’s browser extension last looked, to pick another from without looking again. Empty if it hasn’t looked yet. With an API key, it needs the list: read permission.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”itemId
required
string
Example
0199e8b0-5a10-7a01-8b00-00000000001dResponses
Section titled “Responses”What Walmart had.
Media typeapplication/json
object
products
required
What Walmart’s search had for it when the extension last looked, Walmart’s order with ads and what’s out of stock last. Empty if it hasn’t looked.
Array<object>
object
id
required
string
upc
required
string | null
name
required
string
brand
required
string | null
size
required
string | null
image
required
string | null
price
required
In the currency’s smallest unit: cents.
integer | null
salePrice
required
integer | null
saleEnds
required
The sale’s last day.
string | null
currency
required
string
aisle
required
string | null
inStock
required
boolean
url
required
string | null
Example
{ "products": [ { "id": "10450114", "upc": null, "name": "Great Value 2% Reduced Fat Milk, Gallon, 128 fl oz", "brand": "Great Value", "size": "128 fl oz", "image": "https://i5.walmartimages.com/seo/milk.jpeg", "price": 327, "salePrice": null, "saleEnds": null, "currency": "USD", "aisle": null, "inStock": true, "url": "https://www.walmart.com/ip/10450114" } ]}Not signed in.
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
fields
object
key
additional properties
string
Example
{ "error": { "code": "not_found", "message": "There's nothing here.", "fields": { "name": "Give it a name." } }}Not allowed.
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
fields
object
key
additional properties
string
Example
{ "error": { "code": "not_found", "message": "There's nothing here.", "fields": { "name": "Give it a name." } }}Not on the list.
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
fields
object
key
additional properties
string
Example
{ "error": { "code": "not_found", "message": "There's nothing here.", "fields": { "name": "Give it a name." } }}Walmart isn’t turned on on this server.
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
fields
object
key
additional properties
string
Example
{ "error": { "code": "not_found", "message": "There's nothing here.", "fields": { "name": "Give it a name." } }}© 2026 Kyle Johnson. Documentation: CC BY 4.0. Merran: AGPL-3.0-or-later.