nextjs cheerio puppeteer chrome-aws-lambda turndown axios

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` ⚠️

headline berita category
route ➡️ /api/category/[category]
route ➡️ /api/category/[category]/[sub_category]/page/[page]
headline berita search engine
route ➡️ /api/search/[search]/[sortby]/[page]
post_content detailpost
route ➡️ /api/detailpost/[slug]
post_content detailpodcast
route ➡️ /api/detailpodcast/[slug]

Teknologi yang di gunakan

Instalasi

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

klon repositori ini.

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

Unduh dependencies.

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

yarn install
or
npm install

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

Contributors ✨

_{Faruq Maulana}
💻 🔨 📖 🚧 🤔

License

MIT license

About

JAKARTA POST API merupakan API hasil scraping website media berita Jakarta Post. API ini tidak hanya menyajikan data berita, melainkan juga data podcast yang didalamnya memuat link file audio (.mp3).

https://jakpost.vercel.app