Merran documentation API & integrations
Starter collections
GET
/api/collections
const url = 'http://localhost:3000/api/collections';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/collections \ --cookie merran.session_token=<merran.session_token>Sets of recipes to start a library with, each filled from the recipe sites Merran reads by its own rule, around a few hand-picked classics. Only collections in season for the household, with at least four recipes that suit it. With an API key, it needs the recipes: read permission.
Authorizations
Section titled “Authorizations”Responses
Section titled “Responses”The collections.
Media typeapplication/json
object
collections
required
Array<object>
object
id
required
string
title
required
string
description
required
string
theme
required
What Find more looks for.
string
count
required
number
toImport
required
How many aren’t in the library yet.
number
photos
required
Up to four, for its card.
Array<string>
Example
{ "collections": [ { "id": "weeknight", "title": "Weeknight wins", "description": "Dinners on the table in 40 minutes or less.", "theme": "Weeknight dinners on the table in 40 minutes or less", "count": 2, "toImport": 1, "photos": [ "/api/sites/recipes/0199e8b0-5a10-7a01-8b00-000000000031/photo" ] } ]}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." } }}© 2026 Kyle Johnson. Documentation: CC BY 4.0. Merran: AGPL-3.0-or-later.