API REFERENCE · V1

One endpoint.
Predictable output.

The GetInSaver API resolves supported publicly accessible social-media URLs into a normalized list of media items. It never attempts to bypass privacy controls or authentication gates.

Base URL https://developers.getinsaver.com/v1. All requests and responses use JSON over HTTPS.

Authentication

Create a key in the dashboard and send it as a Bearer credential. The complete key is displayed once; only a one-way hash is stored.

Authorization: Bearer gis_live_YOUR_API_KEY

Keep keys server-side. Do not put a production API key in browser JavaScript, mobile binaries, public repositories, or support screenshots. Revoke a compromised key immediately.

First request

curl https://developers.getinsaver.com/v1/resolve \
  --request POST \
  --header "Authorization: Bearer gis_live_YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "service": "instagram",
    "url": "https://www.instagram.com/reel/SHORTCODE/",
    "max_results": 10
  }'

Resolve media

POST/v1/resolve

Request body

Field	Type	Required	Description
`service`	string	yes	A supported service ID from the table below.
`url`	string	yes	A public HTTP or HTTPS URL on the selected service domain.
`max_results`	integer	no	Maximum media items, from 1 to 20. Default: 10.

Successful response

{
  "ok": true,
  "request_id": "39a3…",
  "service": "instagram",
  "source_url": "https://www.instagram.com/reel/SHORTCODE/",
  "item_count": 1,
  "credits_used": 1,
  "items": [
    { "type": "video", "url": "https://cdn.example/media.mp4" }
  ],
  "metadata": { "title": null, "author": "creator", "caption": null }
}

Service IDs and cost

The live catalog below is the source of truth. Each successfully returned item costs the listed multiplier.

Loading service catalog…

Errors

Errors use a stable envelope and do not consume credits. HTTP 402 means the balance cannot cover the maximum reservation; 422 means the provider could not resolve the public URL; 429 means the rate limit was reached.

{
  "error": true,
  "code": "UPSTREAM_REJECTED",
  "message": "Media could not be resolved."
}

Status	Meaning
400	Invalid service, URL, or request body.
401	Missing, revoked, or invalid API key.
402	Insufficient credit balance.
422	Private, deleted, expired, unsupported, or unavailable content.
429	Too many requests.
502 / 504	Temporary provider failure or timeout.

Metering

Before work starts, the API reserves max_results × service multiplier credits to prevent concurrent overspending. After success it charges only actual returned items and returns the difference. On failure it returns the complete reservation.

A carousel with 5 items on a 1× service costs 5 credits.
Three Story items on the 2× service cost 6 credits.
A private, expired, deleted, or failed lookup costs 0 credits.

Security and acceptable use

Submit only URLs you are legally permitted to process. Do not use the API to infringe copyright, evade access controls, facilitate harassment, or create unlawful surveillance. Media URLs may be temporary; download or transform them only when your rights and the originating platform rules allow it.

Limits

Self-service accounts currently accept up to 20 returned items per request. The public gateway applies abuse and burst controls. Higher concurrency, isolated capacity, and private Docker deployments are available under a commercial agreement.

One endpoint.Predictable output.