Threads Downloader API

Dokumentasi resmi Threads Downloader API dari Maelyn API untuk mengambil media gambar dan video dari postingan Threads

Base Information

BASE_URL_API: https://api.maelyn.eu/api
Path / Endpoint: /downloader/threads
Method: GET
Credit Usage: 1

Authentication

Gunakan header berikut pada setiap request:

x-maelyn-auth: YOUR_API_KEY

Description

Endpoint ini digunakan untuk mengambil media dari postingan Threads.

API akan memproses URL postingan Threads dan mengembalikan:

informasi author jika tersedia
caption jika tersedia
timestamp jika tersedia
jumlah like, reply, repost, dan share jika tersedia
daftar URL gambar
daftar URL video
daftar media gabungan dalam satu array

Endpoint ini mendukung postingan Threads yang berisi satu media maupun carousel dengan banyak gambar atau banyak video.

Query Parameters

GET /downloader/threads?url=https://www.threads.com/@username/post/POST_ID

Parameters

Name	Type	Required	Description
`url`	`string`	Yes*	URL postingan Threads
`link`	`string`	Yes*	Alternatif dari `url`

Salah satu dari url atau link wajib diisi.

Notes

Request menggunakan method GET.
Parameter url atau link wajib dikirim melalui query params.
URL harus valid dan berasal dari Threads.
Domain yang didukung adalah threads.com, www.threads.com, threads.net, dan www.threads.net.
API dapat mengembalikan media berupa gambar, video, atau keduanya.
Beberapa metadata seperti author, caption, timestamp, dan counts bisa bernilai null jika tidak tersedia.
URL media dari Threads/CDN bisa memiliki masa berlaku tertentu.
Endpoint ini menggunakan sistem queue untuk menjaga stabilitas server.

Example Usage

1. Ambil media dari URL Threads

GET /downloader/threads?url=https://www.threads.com/@username/post/POST_ID

2. Menggunakan parameter alternatif `link`

GET /downloader/threads?link=https://www.threads.net/@username/post/POST_ID

Success Response

Multiple Video Response

{
  "success": true,
  "message": "Berhasil mengambil media Threads",
  "result": {
    "input": "https://www.threads.com/@username/post/POST_ID",
    "author": {
      "username": null,
      "profile_url": null,
      "avatar": null
    },
    "caption": null,
    "timestamp": null,
    "counts": {
      "like": null,
      "reply": null,
      "repost": null,
      "share": null
    },
    "image_urls": [],
    "video_urls": [
      {
        "download_url": "https://cdn.threadsphotodownloader.com/video-1.mp4"
      },
      {
        "download_url": "https://cdn.threadsphotodownloader.com/video-2.mp4"
      }
    ],
    "medias": [
      {
        "type": "video",
        "url": "https://cdn.threadsphotodownloader.com/video-1.mp4"
      },
      {
        "type": "video",
        "url": "https://cdn.threadsphotodownloader.com/video-2.mp4"
      }
    ]
  }
}

Multiple Image Response

{
  "success": true,
  "message": "Berhasil mengambil media Threads",
  "result": {
    "input": "https://www.threads.com/@username/post/POST_ID",
    "author": {
      "username": null,
      "profile_url": null,
      "avatar": null
    },
    "caption": null,
    "timestamp": null,
    "counts": {
      "like": null,
      "reply": null,
      "repost": null,
      "share": null
    },
    "image_urls": [
      "https://cdn.threadsphotodownloader.com/image-1.webp",
      "https://cdn.threadsphotodownloader.com/image-2.webp",
      "https://cdn.threadsphotodownloader.com/image-3.webp",
      "https://cdn.threadsphotodownloader.com/image-4.webp"
    ],
    "video_urls": [],
    "medias": [
      {
        "type": "image",
        "url": "https://cdn.threadsphotodownloader.com/image-1.webp"
      },
      {
        "type": "image",
        "url": "https://cdn.threadsphotodownloader.com/image-2.webp"
      },
      {
        "type": "image",
        "url": "https://cdn.threadsphotodownloader.com/image-3.webp"
      },
      {
        "type": "image",
        "url": "https://cdn.threadsphotodownloader.com/image-4.webp"
      }
    ]
  }
}

Response Fields

Field	Type	Description
`success`	`boolean`	Status request
`message`	`string`	Pesan hasil request
`result`	`object`	Hasil proses Threads downloader
`input`	`string`	URL Threads yang diproses
`author`	`object`	Informasi author jika tersedia
`author.username`	`string`	Username author Threads
`author.profile_url`	`string`	URL profile author Threads
`author.avatar`	`string`	URL avatar author Threads
`caption`	`string`	Caption postingan jika tersedia
`timestamp`	`string`	Waktu postingan jika tersedia
`counts`	`object`	Informasi jumlah interaksi jika tersedia
`counts.like`	`string`	Jumlah like jika tersedia
`counts.reply`	`string`	Jumlah reply jika tersedia
`counts.repost`	`string`	Jumlah repost jika tersedia
`counts.share`	`string`	Jumlah share jika tersedia
`image_urls`	`array`	Daftar URL gambar dari postingan Threads
`video_urls`	`array`	Daftar URL video dari postingan Threads
`video_urls.download_url`	`string`	URL download video
`medias`	`array`	Daftar semua media dalam satu array
`medias.type`	`string`	Tipe media, yaitu `image` atau `video`
`medias.url`	`string`	URL media

Error Response

URL Required

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

Invalid Threads URL

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

Media Not Found

{
  "success": false,
  "message": "Media Threads tidak ditemukan"
}

Internal Server Error

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

Playground

Terabox Spotify