works / 14 Jul 2026 / 4 min read / 0 views

ApaKabar API: REST API Mock Berita Lengkap dengan Fitur Search, Filter, dan Pagination

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
pagenumber1Nomor halaman data.
per_pagenumber20Jumlah artikel yang ditampilkan per halaman.
order_bystringlatestUrutan artikel: latest (terbaru) atau popular (paling banyak dilihat).
searchstring""Kata kunci pencarian (mencari di judul, isi, slug, penulis, dan tags).
categorystring""Filter kategori berdasarkan slug. Mendukung multi-kategori dipisah koma (contoh: teknologi,bisnis).

Response Header Penting

Untuk keperluan navigasi pagination di frontend, API menyertakan header:

  1. 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
};
}


Bacaan Terkait

Diskusi