Merran documentation API & integrations
Kroger stores near a ZIP code
GET
/api/stores/kroger/locations
const url = 'http://localhost:3000/api/stores/kroger/locations?zip=85016';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/kroger/locations?zip=85016' \ --cookie merran.session_token=<merran.session_token>Up to twelve of Kroger’s stores, of any banner, near a ZIP code. With an API key, it needs the list: read permission.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”zip
required
string
Example
85016Responses
Section titled “Responses”Stores near it.
Media typeapplication/json
object
locations
required
Array<object>
object
locationId
required
string
name
required
string
banner
required
Kroger’s name for the chain: Fry’s, Ralphs, King Soopers…
string
domain
required
The banner’s site.
string
address
required
string
Example
{ "locations": [ { "locationId": "70500822", "name": "Fry's Food Stores - Phoenix", "banner": "Fry's", "domain": "frysfood.com", "address": "4724 N 20th St, Phoenix, AZ" } ]}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." } }}Kroger isn’t set up 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.