Nest API · Akses data

Feed data e-commerce SEA terbersih, melalui API.

Akses REST langsung ke pipeline Magpie mentah. SKU, harga, stok, terjual, ulasan, penjual, kategori — di lima platform dan enam negara. Untuk tim yang ingin membangun di atas aset data terlengkap di kawasan ini.

Jadwalkan demo Dokumentasi API ↗

cURL

              $ curl -X GET \
  "https://nest-api.magpieiq.com/v1/listings" \
  -H "X-API-Key: mk_live_••••••••••" \
  -d '{
    "platform": "shopee",
    "country":  "ID",
    "category": "Baby Care",
    "period":   "2026-04",
    "seller_type": "OS"
  }'
            

              Respons · 200 OK
              ✓ 12.480 record
            

              {
  "data": [
    {
      "sku_id":      "SHP-ID-12345678",
      "sku_name":    "Enfa A+ Stage 1 900g",
      "brand":       "Enfa",
      "platform":    "shopee",
      "seller_type": "OS",
      "gmv":         142500000,
      "units_sold":  1580,
      "avg_price":   90189,
      "discount_pct":21.5,
      "rating":      4.9,
      "review_count":12847,
      "period":      "2026-04"
    }
  ],
  "meta": {
    "total":    12480,
    "page":     1,
    "per_page":100
  }
}
            

Kasus penggunaan

Dibangun di atas landasan yang telah dikembangkan selama enam tahun.

Data yang sama yang digunakan untuk mendukung produk-produk Magpie IQ sendiri — Farsight, Owl, dan dasbor Looker untuk klien — tersedia untuk tim teknik Anda melalui API.

Isi gudang data Anda

Ambil snapshot SKU bulanan langsung ke BigQuery, Snowflake, atau Redshift. Gabungkan data pasar SEA dengan data penjualan internal, inventaris, atau kampanye Anda.

BigQuerySnowflakedbt

Mengoptimalkan dasbor kustom

Bangun dasbor Looker Studio, Tableau, atau React kustom di atas data pasar yang andal, bersih, dan dinormalisasi — tanpa perlu melakukan scraping sendiri.

Looker StudioTableauPower BI

Melatih model AI dan ML

Data longitudinal SKU, penetapan harga, dan penjualan selama enam tahun digunakan untuk peramalan permintaan, optimasi harga, dan model prediksi pangsa pasar di seluruh pasar Asia Tenggara.

Model hargaPeramalan permintaanPrediksi pangsa

Skema respons

Setiap field, terdokumentasi.

Endpoint /v1/listings mengembalikan satu baris per SKU per platform per periode. Skema lengkap di nest-api.magpieiq.com/docs.

Field Tipe Deskripsi

sku_idstringIdentifier stabil yang ditetapkan Magpie untuk listing. Konsisten di seluruh siklus scrape.

sku_namestringNama produk yang dinormalisasi Magpie. Pencocokan SKU lintas platform diterapkan — produk yang sama di Shopee dan Lazada dipetakan ke sku_name yang sama.

platformstringshopee · lazada · tiktok_shop · tokopedia · blibli

seller_typestringOS = Official Store · C2C = Reseller · MART = Mall platform

gmvintegerGross Merchandise Value dalam IDR untuk periode tersebut. Dihitung sebagai avg_price × units_sold menggunakan harga akhir setelah diskon.

units_soldintegerUnit terjual dalam periode pelaporan. Direkonsiliasi dari penghitung kumulatif; mencakup catatan lag konfirmasi pembeli di data_notes.

avg_priceintegerRata-rata harga jual akhir (setelah diskon) dalam IDR. Harga dipegang konstan pada snapshot terbaru dalam periode pelaporan.

ratingfloatRata-rata penilaian produk (0.0–5.0) saat scraping.

categorystringKategori taksonomi Magpie. Stabil lintas platform dan waktu — tidak berubah ketika Shopee mengganti nama kategori internalnya.

periodstringPeriode pelaporan dalam format YYYY-MM.

+ 14 lainnya seller_city · search_rank · is_free_shipping · has_discount · seller_name · seller_id · sub_category · pack_type · pack_size · bundle_count · data_notes · scraped_at · country · value_share_pct

Akses

Cara mendapatkan akses

API Nest bukan layanan mandiri. Akses diberikan per organisasi setelah panggilan penentuan ruang lingkup singkat — kami mengkonfigurasi batasan laju, cakupan data, dan akses kategori berdasarkan kasus penggunaan Anda.

Jadwalkan demo

Sampaikan kasus penggunaan Anda — pengumpulan data dari gudang data, dasbor khusus, pelatihan ML, atau perlindungan merek. Kami akan membatasi akses sesuai kebutuhan.

Kunci API diterbitkan

Anda akan menerima kunci API beserta batasan tarif yang telah dikonfigurasi, platform yang diizinkan, negara, dan cakupan kategori.

Pengambilan data pertama

Data yang sama yang digunakan Magpie IQ untuk produknya sendiri — telah dibersihkan, dinormalisasi, dan dengan riwayat enam tahun yang tersedia berdasarkan permintaan.

Jadwalkan demo

Teknis

Referensi cepat

URL Dasarnest-api.magpieiq.com/v1

AutentikasiHeader X-API-Key

Format responsJSON (UTF-8)

Paginasipage · per_page (maks 1000)

Rate limitingDikonfigurasi per org

Data historisHingga 2020 (Shopee)

Dokumentasinest-api.magpieiq.com/docs ↗

Feed data e-commerce SEA terbersih, melalui API.

Dibangun di atas landasan yang telah dikembangkan selama enam tahun.

Setiap field, terdokumentasi.

Cara mendapatkan akses

Referensi cepat

Data e-commerce SEA selama enam tahun.Hanya dengan satu panggilan API.

Data e-commerce SEA selama enam tahun.
Hanya dengan satu panggilan API.