---
title: "Clip a recipe from a URL or raw HTML"
method: POST
path: "/clip"
tags: ["clip"]
---

# Clip a recipe from a URL or raw HTML

`POST /clip`

## Request body

- object
  - `url` string
  - `html` string

## Response `200`

Success

- object
  - `title` string, required
  - `description` string
  - `yield` string
  - `activeTime` string
  - `totalTime` string
  - `source` string
  - `url` string
  - `notes` string
  - `ingredients` string
  - `instructions` string
  - `folder` string
  - `rating` number
  - `lastMadeAt` string, nullable
  - `nutritionInfo` string
  - `nutritionServingSize` string, nullable
  - `nutritionCalories` number, nullable
  - `nutritionTotalFat` number, nullable
  - `nutritionSaturatedFat` number, nullable
  - `nutritionTransFat` number, nullable
  - `nutritionPolyunsaturatedFat` number, nullable
  - `nutritionMonounsaturatedFat` number, nullable
  - `nutritionCholesterol` number, nullable
  - `nutritionSodium` number, nullable
  - `nutritionTotalCarbs` number, nullable
  - `nutritionDietaryFiber` number, nullable
  - `nutritionTotalSugars` number, nullable
  - `nutritionAddedSugars` number, nullable
  - `nutritionProtein` number, nullable
  - `nutritionVitaminD` number, nullable
  - `nutritionCalcium` number, nullable
  - `nutritionIron` number, nullable
  - `nutritionPotassium` number, nullable
  - `nutritionOtherDetails` string, nullable
  - `imageURL` string, required

## Other responses

- `400` — Invalid input data
- `401` — Authorization not provided
- `403` — Insufficient access
- `500` — Internal server error

---

[API](https://skmtc.dev/recipesage/apis/recipesage-api.md) · [All operations](https://skmtc.dev/recipesage/apis/recipesage-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recipesage/recipesage-api/revisions/08ef517bf108/schema)