> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Invalid URL

> The url is missing, malformed, not a media page, or a playlist. HTTP 400 or a failed job, code INVALID_URL or PLAYLIST_NOT_SUPPORTED.

```json theme={null}
{
  "success": false,
  "error": "Invalid URL format - must be a valid HTTP or HTTPS URL",
  "code": "INVALID_URL",
  "documentationUrl": "https://www.importly.io/docs/errors/invalid-url"
}
```

| `code` | Where you see it | Meaning |
| - | - | - |
| `INVALID_URL` | `400` response | `url` is missing, or isn't a valid `http(s)://` URL |
| `INVALID_URL` | A failed job | The URL is valid but isn't a media page Importly can read, or a YouTube link is cut off |
| `PLAYLIST_NOT_SUPPORTED` | A failed job | The URL is a playlist page |

## Reasons and how to fix

### The URL is missing or malformed

Send `url` in the JSON body (or as a query parameter on the `GET` forms), with the scheme included: `https://www.youtube.com/watch?v=jNQXAC9IVRw`, not `youtube.com/watch?v=…`. URL-encode it if you put it in a query string.

### It's not the page where the media plays

Use the link you'd share for that one video or episode. Channel pages, search results, and home pages aren't media.

### It's a playlist

Submit each video on its own. A YouTube watch URL with `&list=` is fine; it's treated as that single video. A `youtube.com/playlist?list=…` page is rejected.

See [Supported sites](/docs/features/supported-sites.md) for URL examples.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.