Merran documentation API & integrations

Check prices now

POST

/api/stores/kroger/prices

const url = 'http://localhost:3000/api/stores/kroger/prices';
const options = {
  method: 'POST',
  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 POST \
  --url http://localhost:3000/api/stores/kroger/prices \
  --cookie merran.session_token=<merran.session_token>

Household admins only. What’s done each morning by itself: today’s prices for the products the household keeps, and a look at the store for foods its recipes use, for their sales.

Authorizations

session

Responses

200

Checked.

application/json

object

refreshed

required

Products the household keeps, given today’s price.

integer

searched

required

Foods from its recipes looked up at the store.

integer

deals

required

Foods in its recipes that are a deal now.

integer

Example

{
  "refreshed": 12,
  "searched": 20,
  "deals": 3
}

401

Not signed in.

application/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."
    }
  }
}

403

Not allowed.

application/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."
    }
  }
}

422

Kroger isn’t set up, or there’s no store picked.

application/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."
    }
  }
}

429

Kroger’s daily limit for the app is used up.

application/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."
    }
  }
}

502

Kroger didn’t answer.

application/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."
    }
  }
}