JAKARTA POST API

JAKARTA POST API merupakan API hasil scraping website media berita Jakarta Post. Jika anda menemukan error pada API ini, maka ada kemungkinan terjadi perubahan DOM structure pada web tersebut. Jika hal tersebut terjadi, anda bisa melaporkannya di Issues. Apabila anda ingin lebih jauh lagi seperti ikut kontribusi terhadap perubahan code, anda bisa memulainya dengan melakukan pull request.

Mulai project anda dan jadilah produktif 🔥

Routes

• /api/category
• /api/category/[category] 🡆 index
• /api/category/[category]/[sub_category]/page/[page] 🡆 sub kategori
• /api/detailpost/[slug]
• /api/podcast
• /api/podcast/[slug]/page/[page]
• /api/detailpodcast/[slug]
• /search/[search]/[sortby]/[page]

Details

● /api/category
  > Menampilkan data kategori dan sub kategori.

● /api/category/[category]
  > Menampilkan data berita dari kategori yang dipilih.

● /api/category/[category]/[sub_category]/page/[page]
  > Menampilkan data berita dari sub kategori yang dipilih.

● /api/detailpost/[slug]
  > Menampilkan data detailpost.

● /api/podcast/page/[page]
  > Menampilkan semua data podcast.

● /api/detailpodcast/[slug]
  > Menampilkan data detail podcast.

● /api/search/[search]/[sortby]/[page]
  > Menampilkan hasil pencarian.
  > Opsi pencarian yang bisa anda pilih :
    1. date       🡆 pencarian berdasarkan tanggal
    2. relevance  🡆 pencarian berdasarkan relevansi

Paginasi

Beberapa route memiliki paginasi, untuk lebih detailnya bisa anda cek dibawah :

● CATEGORY
  > https://jakpost.vercel.app/api/category/indonesia/page/2           || paginasi ❌
  > https://jakpost.vercel.app/api/category/indonesia/politics/page/2  || paginasi ✅

● PODCAST
  > https://jakpost.vercel.app/api/podcast/page/2                      || paginasi ✅

● SEARCH ENGINE
  > https://jakpost.vercel.app/api/search/ukraine/relevance/1          || paginasi ✅

  note : jika anda tidak menambahkan parameter halaman, maka tidak akan terjadi error.
  karena halaman akan otomatis default ke halaman 1.

Penting ❗

Dalam API ini ada beberapa data yang me-return markdown. Jika anda ingin menampilkan data tersebut didalam proyek anda, maka anda perlu mem-parsenya terlebih dahulu menggunakan markdown parser. Banyak sekali markdown parser yang mungkin bisa anda gunakan seperti, react-markdown, markdown-it, markedjs dan masih banyak lagi.

⚠️ Data yang me-return markdown ⚠️

1. headline berita category
   route ➡️ /api/category/[category]
   route ➡️ /api/category/[category]/[sub_category]/page/[page]

2. headline berita search engine
   route ➡️ /api/search/[search]/[sortby]/[page]

3. post_content detailpost
   route ➡️ /api/detailpost/[slug]

4. post_content detailpodcast
   route ➡️ /api/detailpodcast/[slug]

Teknologi yang di gunakan

• Axios
• NextJs
• Cheerio
• Puppeteer
• TurndownJs
• dll

Instalasi

Jika Anda ingin menambahkan project ini di komputer Anda sendiri, Anda bisa melakukan instalasi dengan mengikuti cara dibawah ini :

1. klon repositori ini.

git clone https://github.com/faruqmaulana/JAKARTA-POST-API.git

2. Unduh dependencies.

dalam kasus saya, saya menggunakan yarn untuk package manager. Anda bisa menggunakan package manager kesukaan anda.

yarn install
or
npm install

3. Run project.

yarn dev
or
npm run dev

Kontribusi

Project ini bersifat open source. Apabila anda menemukan bug atau anda memiliki saran terkait format API yang baik, anda bisa melakukan pull request diproject ini. Saya sangat terbuka dengan segala bentuk kontribusi yang anda berikan dengan tujuan membuat project ini menjadi lebih baik.

Showcase

Jika Anda menggunakan API ini di project yang anda buat, Anda bisa mendaftarkan project Anda di bawah ini :

• jadilah yang pertama 🔥

Referensi

Artikel

• JavaScript
• NextJs API Routes

Contributors ✨

Faruq Maulana 💻 🔨 📖 🚧 🤔

---

License

MIT license