Merran documentation API & integrations
What the extension put in the Walmart cart
POST
/api/stores/walmart/sent
const url = 'http://localhost:3000/api/stores/walmart/sent';const options = { method: 'POST', headers: { cookie: 'merran.session_token=<merran.session_token>', 'Content-Type': 'application/json' }, body: '{"lines":[{"itemId":"0199e8b0-5a10-7a01-8b00-00000000001d","packages":1,"product":{"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"}}]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url http://localhost:3000/api/stores/walmart/sent \ --header 'Content-Type: application/json' \ --cookie merran.session_token=<merran.session_token> \ --data '{ "lines": [ { "itemId": "0199e8b0-5a10-7a01-8b00-00000000001d", "packages": 1, "product": { "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" } } ] }'Remembered as sent while it’s still on the list, so it’s left unticked next time, and its product kept as the household’s, as its page showed it. The extension adds to the cart in the person’s own Walmart tab; this only records it. With an API key, it needs the list: write permission.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
lines
required
Array<object>
object
itemId
required
string
packages
required
integer
product
The product as its page showed it when it was added.
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
integer | null
salePrice
required
integer | null
saleEnds
required
Walmart’s pages don’t say, so the extension sends null.
string | null format: date
currency
required
string
aisle
required
string | null
inStock
required
boolean
url
required
string | null
Example
{ "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"}Example
{ "lines": [ { "itemId": "0199e8b0-5a10-7a01-8b00-00000000001d", "packages": 1, "product": { "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" } } ]}Responses
Section titled “Responses”Remembered.
Media typeapplication/json
object
sent
required
integer
store
required
string
cartUrl
required
The store’s cart, to check out.
string
Example
{ "sent": 1, "store": "Fry's", "cartUrl": "https://www.frysfood.com/cart"}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." } }}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.