works / 14 Jul 2026 / 4 min read / 0 views
ApaKabar API: REST API Mock Berita Lengkap dengan Fitur Search, Filter, dan Pagination
ApaKabar API adalah REST API publik untuk portal berita/artikel yang siap digunakan untuk kebutuhan pengembangan frontend (latihan slicing, portofolio, maupun kompetisi seperti LKS Web Technologies).
API ini sudah mendukung CORS publik, pencarian multi-field, filter multi-kategori, sorting, serta pagination lengkap dengan total data di response header.
Base URL
text
https://apa-kabar-api.vercel.app
1. Mengambil Daftar Berita / Artikel
Endpoint
http
GET /api/v1/posts
Parameter Query (Opsional)
| ParameterTipeDefaultKeterangan | |||
page | number | 1 | Nomor halaman data. |
per_page | number | 20 | Jumlah artikel yang ditampilkan per halaman. |
order_by | string | latest | Urutan artikel: latest (terbaru) atau popular (paling banyak dilihat). |
search | string | "" | Kata kunci pencarian (mencari di judul, isi, slug, penulis, dan tags). |
category | string | "" | Filter kategori berdasarkan slug. Mendukung multi-kategori dipisah koma (contoh: teknologi,bisnis). |
Response Header Penting
Untuk keperluan navigasi pagination di frontend, API menyertakan header:
X-Total-Count: Menampilkan total seluruh data yang cocok sebelum dipotong per halaman.
Contoh Request
A. Artikel Terbaru dengan Paginasi
bash
GET /api/v1/posts?page=1&per_page=10
B. Artikel Terpopuler
bash
GET /api/v1/posts?order_by=popular&per_page=5
C. Filter Berdasarkan Kategori
bash
GET /api/v1/posts?category=teknologi
Atau multi-kategori:
bash
GET /api/v1/posts?category=teknologi,bisnis
D. Pencarian Berita
bash
GET /api/v1/posts?search=aplikasi
E. Kombinasi Lengkap
bash
GET /api/v1/posts?category=teknologi&search=pwa&order_by=popular&page=1&per_page=5
Contoh Response (200 OK)
json
[
{
"id": 1,
"slug": "peluncuran-aplikasi-apakabar-media-online-masa-kini",
"title": "Peluncuran Aplikasi Apakabar: Media Online Masa Kini yang Super Cepat",
"category_name": "Teknologi",
"category_slug": "teknologi",
"author_name": "Admin Utama",
"publish_date": "2026-06-29",
"visited_count": 5420,
"thumbnail": "https://images.unsplash.com/photo-1512428559087-560fa5ceab42?w=500",
"body": "Platform media online terbaru bernama Apakabar resmi diluncurkan...",
"tags": ["apakabar", "aplikasi", "mobile-first"]
}
]
2. Mengambil Detail Artikel (Berdasarkan Slug)
Endpoint
http
GET /api/v1/posts/:slug
Contoh Request
bash
GET /api/v1/posts/peluncuran-aplikasi-apakabar-media-online-masa-kini
Contoh Response (200 OK)
Mengembalikan array berisi data artikel yang cocok:
json
[
{
"id": 1,
"slug": "peluncuran-aplikasi-apakabar-media-online-masa-kini",
"title": "Peluncuran Aplikasi Apakabar: Media Online Masa Kini yang Super Cepat",
"category_name": "Teknologi",
"category_slug": "teknologi",
"author_name": "Admin Utama",
"publish_date": "2026-06-29",
"visited_count": 5420,
"thumbnail": "https://images.unsplash.com/photo-1512428559087-560fa5ceab42?w=500",
"body": "Platform media online terbaru bernama Apakabar resmi diluncurkan hari ini dengan fokus utama pada kenyamanan pengguna mobile...",
"tags": ["apakabar", "aplikasi", "mobile-first"]
}
]
3. Mengambil Daftar Kategori
Endpoint
http
GET /api/v1/categories
Contoh Response (200 OK)
json
[
{ "id": 1, "name": "Teknologi", "slug": "teknologi" },
{ "id": 2, "name": "Bisnis", "slug": "bisnis" },
{ "id": 3, "name": "Gaya Hidup", "slug": "gaya-hidup" },
{ "id": 4, "name": "Kesehatan", "slug": "kesehatan" },
{ "id": 5, "name": "Hiburan", "slug": "hiburan" }
]
Contoh Implementasi di JavaScript (Frontend)
Berikut contoh fungsi pemanggilan menggunakan fetch native JavaScript untuk membaca data beserta total pagination-nya:
async function getNews({ page = 1, perPage = 10, category = '', search = '', orderBy = 'latest' }) {
const params = new URLSearchParams({
page,
per_page: perPage,
order_by: orderBy,
});
if (category) params.append('category', category);
if (search) params.append('search', search);
const res = await fetch(`https://<domain-kamu>.vercel.app/api/v1/posts?${params.toString()}`);
// Baca total data dari header untuk hitung total halaman
const totalCount = Number(res.headers.get('X-Total-Count') || 0);
const totalPages = Math.ceil(totalCount / perPage);
const posts = await res.json();
return {
data: posts,
totalCount,
totalPages,
currentPage: page
};
}