Instagram Downloader API

Dokumentasi resmi Instagram Downloader API dari Maelyn API untuk mendownload media Instagram (image, video, dan slide) dengan kualitas terbaik dan metadata lengkap

Base Information

  • BASE_URL_API: https://api.maelyn.eu/api
  • Path / Endpoint: /downloader/instagram
  • Method: GET
  • Credit Usage: 2

Authentication

Gunakan header berikut pada setiap request:

x-maelyn-auth: YOUR_API_KEY

Query Parameters

Endpoint ini digunakan untuk mendownload media dari Instagram seperti post image, video, maupun carousel (slide).

Example Request

GET /downloader/instagram?url=https://www.instagram.com/p/xxxxx/

Parameters

NameTypeRequiredDescription
urlstringYesURL post Instagram yang ingin didownload

Example Usage

GET /downloader/instagram?url=https://www.instagram.com/reel/xxxxx/

Success Response (Image)

{
  "success": true,
  "metadata": {
    "type": "image",
    "id": "123456789",
    "code": "ABCDEF",
    "caption": "Example caption",
    "create_time": 1710000000,
    "like_count": 1200,
    "comment_count": 150,
    "author": {
      "id": "user123",
      "username": "exampleuser",
      "full_name": "Example User",
      "verified": false,
      "is_private": false,
      "profile_pic": "https://..."
    }
  },
  "result": {
    "type": "image",
    "url": "https://cdn.maelyn.eu/image-abc123.jpg",
    "file": {
      "filename": "image-abc123.jpg",
      "ext": ".jpg",
      "size": 2048576,
      "size_human": "2 MB"
    }
  }
}

Success Response (Video)

{
  "success": true,
  "metadata": {
    "type": "video"
  },
  "result": {
    "type": "video",
    "url": "https://cdn.maelyn.eu/video-abc123.mp4",
    "file": {
      "filename": "video-abc123.mp4",
      "ext": ".mp4",
      "size": 10485760,
      "size_human": "10 MB"
    }
  }
}

Success Response (Slide / Carousel)

{
  "success": true,
  "metadata": {
    "type": "slide"
  },
  "result": {
    "type": "slide",
    "total_slides": 2,
    "items": [
      {
        "index": 1,
        "type": "image",
        "url": "https://cdn.maelyn.eu/img1.jpg",
        "file": {
          "filename": "img1.jpg",
          "ext": ".jpg",
          "size": 1024000,
          "size_human": "1 MB"
        }
      },
      {
        "index": 2,
        "type": "video",
        "url": "https://cdn.maelyn.eu/video1.mp4",
        "file": {
          "filename": "video1.mp4",
          "ext": ".mp4",
          "size": 5097152,
          "size_human": "5 MB"
        }
      }
    ]
  }
}

Error Response

Missing URL

{
  "success": false,
  "message": "Query url wajib diisi"
}

Invalid URL

{
  "success": false,
  "message": "URL tidak valid"
}

Media Not Found

{
  "success": false,
  "message": "Gagal mengambil data Instagram"
}

Unsupported Media Type

{
  "success": false,
  "message": "Tipe media tidak didukung"
}

File Too Large

{
  "success": false,
  "message": "Ukuran file melebihi batas 100 MB"
}

Internal Server Error

{
  "success": false,
  "message": "Terjadi kesalahan saat memproses permintaan"
}

Notes

  • Mendukung Image, Video, dan Carousel (Slide).
  • Otomatis memilih kualitas terbaik (video & audio).
  • Maksimal ukuran file: 100 MB.

Playground