Skip to content

Vivekmasona/instacdn

 
 

Repository files navigation

Instagram Videos Downloader

instacdn.vercel.app/api/video?url= Simple Website/API for downloading instagram videos made with Next.js that actually works with no problem.

Description

A website that lets you download Instagram videos easily and quickly. You can paste the URL of any public Instagram post and get the video file in MP4 format. there is also an API that you can use to integrate this functionality into your own applications. The API is simple, and it returns JSON responses with the video URL and other metadata.

Note: Instagram stories aren't supported.

You can preview and try the website live in Vercel here : instagram-videos.vercel.app

Website Preview

Easy and User friendly UI (Interactions feedback and error messages).

Desktop preview

Responsive on mobile and small devices.

Mobile preview

Getting Started

1. Cloning the repository:

git clone https://github.com/riad-azz/instagram-video-downloader.git

2. Installing dependencies:

cd instagram-video-downloader
npm install

3. Starting the server:

# Development
npm run dev

# Build
npm run build

# Start
npm run start

Server API

The Server API is disabled by default but you can enable it by :

  1. Go to src/configs/instagram.ts
  2. Set enableServerAPI to true.

Now you can use the API and integrate this functionality in your other applications.

Endpoint: /api/video?url={POST_URL}

Parameters :

  • url : Instagram Post or Reel link (required).

GET Request example

curl -i "https://localhost:3000/api/video?url=https://www.instagram.com/p/CGh4a0iASGS"

API Response

API response preview

Rate Limiter - Upstash

In order to reduce the load on the API and ensure optimal performance, I have implemented rate limiting using Upstash. This integration allows me to restrict the number of requests made to the API within a specified time frame, preventing excessive traffic and potential service disruptions.

To enable this feature follow these steps:

  1. Create an account on upstash.com.
  2. Create a new Redis database.
  3. Click on the newly created database.
  4. Scroll down to REST API, click on .env and copy the two variables provided.
  5. Create a new .env.local file in the root directory.
  6. Paste what you copied inside and add USE_UPSTASH and set it to true.

Here is what your .env.local should look like:

# ...other variables
USE_UPSTASH="true"
UPSTASH_REDIS_REST_URL="YOUR-UPSTASH-URL"
UPSTASH_REDIS_REST_TOKEN="YOUR-UPSTASH-TOKEN"

All ratelimit configs can be found in src/configs/upstash.ts.

If you would like to change the identifier (default is IP) you can change it in src/middleware.ts.

License

This project is licensed under the [MIT] License - see the LICENSE.md file for details