Merran documentation API & integrations
Find the links in some text
POST
/api/recipes/import/links/check
const url = 'http://localhost:3000/api/recipes/import/links/check';const options = { method: 'POST', headers: { cookie: 'merran.session_token=<merran.session_token>', 'Content-Type': 'application/json' }, body: '{"text":"Dinners to try:\nhttps://example.com/lemon-chicken\nhttps://example.com/garlic-rice"}'};
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/recipes/import/links/check \ --header 'Content-Type: application/json' \ --cookie merran.session_token=<merran.session_token> \ --data '{ "text": "Dinners to try:\nhttps://example.com/lemon-chicken\nhttps://example.com/garlic-rice" }'The links in pasted text, up to 100, tidied, with which are in the library already and which are videos (which can’t be imported yet). Nothing is imported. With an API key, it needs the recipes: read permission.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
text
required
Pasted text with links in it: one per line, or mixed in.
string
Example
{ "text": "Dinners to try:\nhttps://example.com/lemon-chicken\nhttps://example.com/garlic-rice"}Responses
Section titled “Responses”The links.
Media typeapplication/json
object
links
required
Array<object>
object
url
required
string
video
required
A video link, which can’t be imported yet.
boolean
existing
required
In the library already: it’s skipped.
object
slug
required
string
name
required
string
more
required
Links past the first 100, which are left out.
integer
Example
{ "links": [ { "url": "https://example.com/lemon-chicken", "video": false, "existing": { "slug": "lemon-chicken", "name": "Lemon Chicken" } }, { "url": "https://example.com/garlic-rice", "video": false, "existing": null } ], "more": 0}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.