Merran documentation API & integrations
A recipe's photo
GET
/api/recipes/{recipe}/photo
const url = 'http://localhost:3000/api/recipes/lemon-chicken/photo?size=full';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/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.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”recipe
required
The recipe’s id, or its slug.
string
Example
lemon-chickenThe recipe’s id, or its slug.
Query Parameters
Section titled “Query Parameters”size
string
v
Which photo: the links in photo say.
string
Which photo: the links in photo say.
Responses
Section titled “Responses”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.