# downloader api documentation and reference - fastsaver api

every endpoint, every field, with a real response you can copy. one GET, one shape, and a panel on each page that runs the call.

> source: https://api.fastsaver.io/docs

## one get request

Paste a link, get the media as json. No proxies, no cookies, no bot blocks to deal with - that part is ours.

the whole thing

```
GET https://api.fastsaver.io/v1/fetch?url=https://www.instagram.com/p/example
X-Api-Key: fs_sk_…
```

### three rules

- Read `ok`, not the status code. Every body has it.
- Check `type` before reading `download_url`. An album puts the media in `items` instead.
- Out of credits is a 400 - there is no 402.

### endpoints

#### core

- [GET /fetch](https://api.fastsaver.io/docs/fetch) - one link in, clean json out

#### youtube

- [GET /youtube/info](https://api.fastsaver.io/docs/youtube/info) - video formats, or a community post with its media
- [GET /youtube/search](https://api.fastsaver.io/docs/youtube/search) - search youtube
- [POST /youtube/download](https://api.fastsaver.io/docs/youtube/download) - a direct link to the file
- [POST /youtube/audio/tg-bot](https://api.fastsaver.io/docs/youtube/audio-tg-bot) - audio straight into your telegram bot

#### shazam

- [GET /shazam/top](https://api.fastsaver.io/docs/shazam/top) - top charts by country
- [POST /shazam/identify](https://api.fastsaver.io/docs/shazam/identify) - name that track

#### account

- [GET /balance](https://api.fastsaver.io/docs/balance) - plan, credits and rate limit

### before you start

authentication is one header. errors explains the envelope. credits lists what each call costs, and rate limits covers the 429.

Or skip reading and run something against your own key.