Skip to content
merran
GitHubInstall

Merran documentation API & integrations

A recipe's photo

GET
/api/recipes/{recipe}/photo
curl --request GET \
--url 'http://localhost:3000/api/recipes/lemon-chicken/photo?size=full' \
--cookie merran.session_token=<merran.session_token>

As WebP: full for the recipe page, or card, cropped for recipe cards. Use the links in the recipe’s photo, which can be kept for good. With an API key, it needs the recipes: read permission.

recipe
required

The recipe’s id, or its slug.

string

Example

lemon-chicken

The recipe’s id, or its slug.

size
string
default: full
Allowed values: full card
v

Which photo: the links in photo say.

string

Which photo: the links in photo say.

The photo.

Media typeimage/webp
string format: binary

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

No such recipe, or it has no photo.

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.