Skip to content
merran
GitHubInstall

Merran documentation API & integrations

Find the links in some text

POST
/api/recipes/import/links/check
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.

Media typeapplication/json
object
text
required

Pasted text with links in it: one per line, or mixed in.

string
<= 100000 characters

Example

{
"text": "Dinners to try:\nhttps://example.com/lemon-chicken\nhttps://example.com/garlic-rice"
}

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.