API Documentation

Welcome to the ReelDownload API. Integrate Instagram media retrieval capabilities directly into your applications. Our API is built for speed, scalability, and ease of use.

Introduction

The ReelDownload API is organized around REST. Our API has predictable resource-oriented URLs, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

Base URL: https://api.reeldownload.net/v1

Authentication

The ReelDownload API uses API keys to authenticate requests. You can view and manage your API keys in the Dashboard. Authentication to the API is performed via the x-api-key header.

curl "https://api.reeldownload.net/v1/info?url=..." \
  -H "x-api-key: YOUR_API_KEY"
                    

Get Media Info

Retrieve metadata and download links for a specific Instagram URL (Reel, Post, or Video).

GET /v1/info

Parameters

Parameter	Type	Description
url REQUIRED	string	The public Instagram URL to process.

Response Example

JSON

{
  "status": "success",
  "data": {
    "type": "video",
    "thumbnail": "https://cdn.instagram.com/...",
    "download_url": "https://cdn.reeldownload.net/file.mp4",
    "author": "username",
    "description": "Amazing view! #travel"
  },
  "meta": {
    "processed_in": 0.45s
  }
}
                    

Rate Limiting

To ensure the stability of the API, we limit the number of requests you can make. Rate limits depend on your plan.

Basic: 5 requests per minute.
Creator: 50 requests per minute.

If you exceed the limit, you will receive a 429 Too Many Requests response.

Errors

The API uses standard HTTP status codes to indicate the success or failure of an API request.

Code	Description
200	OK - Success
400	Bad Request - Invalid URL
401	Unauthorized - Invalid API Key
404	Not Found - Media deleted or private
429	Too Many Requests - Rate limit exceeded
500	Server Error - Something went wrong on our end