API REFERENCE · v1

Docs

One base URL, bearer auth, JSON in every response. You can be in production in ten minutes.

Quickstart

Create a key in the dashboard, then send your first request. The link goes in as a query parameter.

curl -s "https://api.saveapi.org/v1/download" \
  -H "Authorization: Bearer sk_live_xxxx" \
  -G --data-urlencode "url=https://instagram.com/reel/Cx1a2b3c"

Authentication

Every request carries your secret key in the Authorization header. Keys never expire, but you can revoke and rotate them at any time.

Authorization: Bearer sk_live_xxxxxxxxxxxx

GET /v1/download

Resolves a link into direct media URLs plus author and caption metadata.

PARAMETERTYPEDESCRIPTION

url *stringThe public link to resolve. Must be URL-encoded.

limit_mbnumberCap the returned media size. Only used by platforms that offer variants.

GET /v1/{platform}

Target one platform directly — same response shape

GET /v1/detect

Check whether a link is supported before spending a credit

Error codes

400INVALID_URLThe url parameter is missing, malformed, or not a valid post link.

401INVALID_API_KEYMissing or unknown API key.

403PRIVATE_CONTENTThe post is private. Not billed.

404MEDIA_NOT_FOUNDThe post is deleted, restricted, or holds no media. Not billed.

429RATE_LIMITEDToo many requests this minute. Check the Retry-After header.

429QUOTA_EXCEEDEDMonthly quota is used up. See X-Quota-Reset for the reset time.

502UPSTREAM_ERRORThe source platform failed to respond. Safe to retry.

Pricing

Billed per successful request. Private, deleted or failed links are never charged.

Pricing →