📚 New Documentation System Available!

We've upgraded our documentation with interactive guides, code examples, and API reference.

📡 Swagger UI 📖 Redoc

Dokumentasi

v1.2.1

Selamat datang di dokumentasi Emas API ID. API ini menyediakan data harga emas real-time yang handal, bersumber langsung dari penyedia terpercaya di Indonesia seperti Antam, Galeri 24, Waris Sampoerna, dan King Halim, serta Lotus Archi.

lightbulb Base URL: https://emas.maulanar.my.id

Autentikasi

Emas API menggunakan kunci API untuk mengautentikasi permintaan. Anda dapat melihat dan mengelola kunci API Anda di Dashboard.

Autentikasi ke API dilakukan melalui header X-API-Key atau token Authorization: Bearer. 

# Opsi 1: X-API-Key Header (Direkomendasikan)
curl -H "X-API-Key: KUNCI_API_ANDA" https://emas.maulanar.my.id/api/prices

# Opsi 2: Bearer Token
curl -H "Authorization: Bearer KUNCI_API_ANDA" https://emas.maulanar.my.id/api/prices
warning Permintaan tanpa Kunci API akan sangat dibatasi (rate-limited) dan mungkin diblokir. Selalu gunakan Kunci API Anda untuk aplikasi produksi.

Sumber Data

Logam Mulia (Antam)

Harga resmi bersumber langsung dari www.logammulia.com

Galeri 24

Harga ritel bersumber dari galeri24.co.id.

Hartadinata

Harga ritel bersumber dari hartadinataabadi.co.id

Waris Sampoerna

Harga ritel bersumber dari sampoernagold.com

Pegadaian

Harga ritel bersumber dari pegadaian.co.id

King Halim

Harga logam mulia bersumber dari kinghalim.com

Lotus Archi

Harga emas resmi bersumber dari lotusarchi.com

Ambil Semua Harga

GET /api/prices

Mengambil daftar harga emas saat ini yang disesuaikan dengan parameter query. 

curl -H "X-API-Key: KUNCI_API_ANDA" "https://emas.maulanar.my.id/api/prices?limit=2"
{
  "status": "success",
  "data": [
    {
      "brand": "ANTAM",
      "resource": "antam",
      "weight": 0.5,
      "sell_price": 750000,
      "buyback_price": 650000,
      "updated_at": "2026-01-01T08:00:00Z"
    },
    {
      "brand": "UBS",
      "resource": "galeri24",
      "weight": 1,
      "sell_price": 1400000,
      "buyback_price": 1300000,
      "updated_at": "2026-01-01T08:00:00Z"
    }
  ]
}

Ambil Harga per Brand

GET /api/prices/brand/{brand}

Mengambil harga untuk brand tertentu (misal: Antam, UBS).

curl -H "X-API-Key: KUNCI_API_ANDA" "https://emas.maulanar.my.id/api/prices/brand/antam"

Ambil Harga per Sumber

GET /api/prices/resource/{resource}

Mengambil harga berdasarkan sumber data. Tidak sensitif huruf besar/kecil.

Sumber yang tersedia: antam (Logammulia.com), galeri24 (Galeri24.co.id), hartadinata (Hartadinata), pegadaian (Pegadaian), warissampoerna (Waris Sampoerna), kinghalim (King Halim), lotusarchi (Lotus Archi) 

curl -H "X-API-Key: KUNCI_API_ANDA" "https://emas.maulanar.my.id/api/prices/resource/antam"

Ambil Harga Hari Ini

GET /api/prices/today/{brand}

Mengambil semua harga emas hari ini (semua weight dan resource) untuk brand tertentu beserta perubahan harga dari hari sebelumnya.

Response includes array of prices with changes from previous day for both selling and buyback prices.

curl -H "X-API-Key: KUNCI_API_ANDA" "https://emas.maulanar.my.id/api/prices/today/antam"
{
  "status": "success",
  "timestamp": "2026-04-02T10:30:00Z",
  "data": {
    "brand": "ANTAM",
    "resource": "antam",
    "weight": 1.0,
    "sell_price": 1574000,
    "buyback_price": 1450000,
    "date": "2026-04-02",
    "updated_at": "2026-04-02",
    "sell_price_change": 5000,
    "buyback_price_change": -2000,
    "gramasi": 1.0
  }
}

Paginasi & Batasan

Kelola dataset besar dengan membatasi hasil dan menavigasi melalui halaman.

low_priority limit

Jumlah maksimum catatan yang akan dikembalikan. Standarnya adalah 10-20 tergantung pada endpoint.

?limit=5

auto_stories page

Nomor halaman hasil yang akan diambil. Digunakan bersama dengan limit.

?page=2&limit=10

Metadata dalam Respons

Saat menggunakan paginasi, API mengembalikan objek meta untuk membantu Anda membangun UI.

{
  "status": "success",
  "data": [...],
  "meta": {
    "page": 2,
    "per_page": 10,
    "total_items": 45,
    "total_pages": 5
  }
}

Filter Lanjutan

Filter hasil menggunakan operator query yang kuat melalui `field[operator]=value`.

Operator Deskripsi Contoh
eq Sama dengan (default) brand[eq]=ANTAM
gt / gte Lebih besar dari (atau sama dengan) weight[gte]=1
lt / lte Lebih kecil dari (atau sama dengan) sell_price[lte]=1000000
like Pencarian SQL LIKE brand[like]=ant
info
Tips Pro: Anda dapat menggabungkan beberapa filter.
/api/prices?weight[gte]=1&sell_price[lt]=2000000&sort_by=sell_price&order=asc

Contoh Penggunaan

Berikut adalah pola umum untuk menanyakan data harga emas.

label Filter berdasarkan Brand

Cari brand tertentu (ANTAM, UBS, King Halim, Lotus Archi):

GET /api/prices?brand[eq]=antam GET /api/prices?brand[eq]=ubs GET /api/prices?brand[eq]=king%20halim GET /api/prices?brand[like]=lotus

source Filter berdasarkan Sumber

Dapatkan data dari scraper tertentu:

GET /api/prices?resource[eq]=antam GET /api/prices?resource[eq]=galeri24 GET /api/prices?resource[eq]=hartadinata GET /api/prices?resource[eq]=pegadaian GET /api/prices?resource[eq]=kinghalim GET /api/prices?resource[eq]=lotusarchi

sort Pengurutan & Riwayat

Urutkan berdasarkan pembaruan terbaru atau harga:

GET /api/prices?sort_by=updated_at&order=desc GET /api/prices?sort_by=sell_price&order=asc

Filter berdasarkan hari/tanggal tertentu:

GET /api/prices?updated_at[eq]=2026-01-20

weight Filter berdasarkan Berat (Gram)

Cari ukuran tertentu atau rentang:

GET /api/prices?weight[eq]=1 GET /api/prices?weight[eq]=0.5 GET /api/prices?weight[gte]=5&weight[lte]=10

auto_stories Paginasi & Batasan

Batasi jumlah hasil:

GET /api/prices?limit=5

Navigasi melalui halaman:

GET /api/prices?page=1&limit=10 GET /api/prices?page=2&limit=10

Contoh Query Kompleks

"Saya ingin melihat harga emas Antam antara 1g dan 10g, diurutkan dari harga termurah yang diperbarui hari ini"

curl "https://emas.maulanar.my.id/api/prices?brand[eq]=antam&weight[gte]=1&weight[lte]=10&sort_by=sell_price&order=asc"

Panduan AI Agent

Panduan khusus untuk AI agents yang ingin mengintegrasikan dengan Emas API. Pahami struktur data multi-brand, multi-source untuk pengambilan data yang akurat.

warning PENTING: Satu brand bisa ada di beberapa sources. Selalu spesifikasikan baik brand DAN resource untuk hasil yang tepat.

article Dokumentasi Lengkap

Baca panduan lengkap untuk integrasi AI Agent:

description Download AGENT_GUIDE.md

lightbulb Konsep Krusial

Pahami konsep brand vs source:

  • • Brand: Produsen (ANTAM, UBS, EMASKU, KING HALIM, LOTUS ARCHI)
  • • Source: Penyedia data (galeri24, antam, pegadaian, kinghalim, lotusarchi)
  • • 1 brand bisa ada di multiple sources

Quick Reference - Kombinasi Valid

Brand Source Valid Deskripsi
ANTAM antam Resmi ANTAM, harga terpercaya
ANTAM pegadaian ANTAM di Pegadaian, cross-check
UBS galeri24 UBS di Galer24, harga kompetitif
UBS pegadaian UBS di Pegadaian, alternatif
GALERI 24 galeri24 Resmi Galer24, harga langsung
GALERI 24 pegadaian Galeri 24 di Pegadaian, referensi
EMASKU hartadinata Resmi Hartadinata, harga premium
WARIS SAMPOERNA warissampoerna Resmi Sampoerna, harga luxury
KING HALIM kinghalim Resmi King Halim, logam mulia retail
LOTUS ARCHI lotusarchi Resmi Lotus Archi, harga emas harian

check_circle Contoh Benar 

# BENAR: Spesifikasikan brand DAN source
curl -H "X-API-Key: KEY" \
  "https://emas.maulanar.my.id/api/prices?brand=ANTAM&resource=antam&weight=1"

cancel Contoh Salah 

# SALAH: Hanya spesifikasikan brand
curl -H "X-API-Key: KEY" \
  "https://emas.maulanar.my.id/api/prices?brand=ANTAM&weight=1"
# Hasil: MUNGKIN dapatkan multiple results dari sources berbeda!