# Importing recipes from the web

Bring a recipe in from a link or from text you already hold, matched to You2Chef foods and known dishes.

**When to use:** The person shares a link, pastes a recipe, or asks to save something they saw online.

## What to know

- Call import_recipe_from_url with `url` and You2Chef reads the page (it honours robots.txt). When you already hold the text (pasted, or read from a page or a video you can see), pass `capture: { url, text }`: the link is then attribution only and never fetched. Social and video links need capture.text.
- The answer is the graph, the steps and ingredients compiled from it, unmatched ingredient names (`new:` ids), diets it does not suit, similar recipes, and `dish`: which known dish it is, part by part.
- `save: "none"` only returns it; `"library"` adds it to the person's recipes at once, recorded in their activity (revertible for 30 days). Successful imports per account per day are limited (usually one), so import once and reuse the answer.

## Tools

- `import_recipe_from_url`
