---
title: "Save an article by URL"
method: POST
path: "/api/v1/saved/url"
tags: ["Saved"]
---

# Save an article by URL

`POST /api/v1/saved/url`

## Request

- Base URL: `https://feednest.com`
- URL: `https://feednest.com/api/v1/saved/url`
- Auth: HTTP bearer

Saves any web URL to the user's saved list, fetching and parsing the page so it reads like a feed article. Creates the article when FeedNest has not seen the URL before, otherwise reuses it. Rate limited to 100 requests per hour. Requires the `write` scope.

## Request body

- object
  - `url` string, uri, required

## Response `201`

URL saved

- object
  - `data` object, required
    - `id` string, uuid, required
    - `article_id` string, uuid, required
    - `url` string, uri, required
    - `title` string, nullable, required

## Other responses

- `400`: Input validation failed
- `401`: Missing or invalid API key
- `403`: Insufficient permissions or subscription required
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/feednest/apis/feednest-public-api.md) · [All operations](https://skmtc.dev/feednest/apis/feednest-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/feednest/apis/feednest-public-api/revisions/51c8242d8418?raw)