Pinterest Download API

Dokumentasi resmi Pinterest Download API dari Maelyn API untuk mengambil file download video, GIF, atau gambar dari URL Pinterest

Base Information

  • BASE_URL_API: https://api.maelyn.eu/api
  • Path / Endpoint: /download/pinterest
  • Method: POST
  • Credit Usage: 1

Authentication

Gunakan header berikut pada setiap request:

x-maelyn-auth: YOUR_API_KEY
Content-Type: application/json

Description

Endpoint ini digunakan untuk mengambil data download dari URL Pinterest.

API akan memproses link Pinterest, lalu mengembalikan informasi konten seperti:

  • judul
  • durasi
  • tipe konten
  • URL file utama
  • thumbnail / image
  • daftar source download yang tersedia

Endpoint ini mendukung konten seperti:

  • video
  • GIF
  • image

Request Body

{
  "url": "https://id.pinterest.com/pin/xxxxxxxxxxxx/"
}

Body Parameters

NameTypeRequiredDescription
urlstringYesURL Pinterest yang ingin diambil data download-nya

Notes

  • Body request harus berupa JSON.
  • Field url wajib diisi.
  • URL harus valid dan menggunakan protokol http atau https.
  • Hasil download tergantung pada konten yang tersedia dari URL Pinterest tersebut.
  • Jika source utama tidak ditemukan, sistem akan mencoba mengambil source pertama yang tersedia.

Example Usage

{
  "url": "https://www.pinterest.com/pin/123456789012345678/"
}

Success Response

{
  "success": true,
  "message": "Berhasil mengambil data Pinterest",
  "result": {
    "title": "Beautiful Pinterest Video",
    "duration": "00:15",
    "type": "video",
    "url": "https://example.com/video.mp4",
    "image": "https://example.com/preview.jpg",
    "sources": [
      {
        "type": "video",
        "label": "Download Video",
        "url": "https://example.com/video.mp4"
      },
      {
        "type": "image",
        "label": "Download Image",
        "url": "https://example.com/image.jpg"
      }
    ]
  }
}

Response Fields

FieldTypeDescription
successbooleanStatus request
messagestringPesan hasil request
resultobjectHasil data Pinterest
titlestringJudul konten Pinterest
durationstringDurasi konten jika tersedia
typestringTipe konten utama (video, gif, image, atau unknown)
urlstringURL file utama yang dipilih sistem
imagestringURL gambar / preview jika tersedia
sourcesarrayDaftar semua source download yang ditemukan
labelstringLabel source download
typestringTipe source download
urlstringURL source download

Error Response

Invalid JSON

{
  "success": false,
  "message": "Body JSON tidak valid"
}

URL Required

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

Invalid URL

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

Failed Open Initial Page

{
  "success": false,
  "message": "Gagal membuka halaman awal (500)"
}

Failed Get CSRF Token

{
  "success": false,
  "message": "Gagal mendapatkan CSRF token"
}

Failed Process Download

{
  "success": false,
  "message": "Gagal memproses download (500)"
}

Content Not Found

{
  "success": false,
  "message": "Konten tidak ditemukan atau URL tidak valid"
}

Source Website Error

{
  "success": false,
  "message": "The provided URL is invalid or unsupported"
}

Internal Server Error

{
  "success": false,
  "message": "Internal server error"
}

Playground