Home

Awesome

Detik News Search Unofficial API

This script can search and return list of news result

Features

Prerequisites

Installation

  1. Clone the repository:

    git clone <repository-url>
    cd <repository-directory>
    
  2. Create and activate a virtual environment (optional):

    python -m venv venv
    source venv/bin/activate  # On Windows: venv\Scripts\activate
    
  3. Install the required packages:

    pip install -r requirements.txt
    

    Make sure you have a requirements.txt file with necessary dependencies. For this project, it might include:

    Flask
    requests
    beautifulsoup4
    

Configuration

Ensure that your script file contains the DetikNewsApi class and is correctly implemented. The Flask app in main.py uses this class for making API requests.

Usage

  1. Run the Flask application:

    python main.py
    
  2. Access the API endpoints:

    • Search for news articles:

      • For details and limit:
        GET /search?q=<query>&detail=<true|false>&limit=<number>
        
      • Without details and limit:
        GET /search?q=<query>
        
    • Parameters:

      • q: The search query (required).
      • detail: Whether to include the full article body in the response (true or false). Defaults to false.
      • limit: The maximum number of results to return. Defaults to None.
    • Example Request:

      GET /search?q=makan%20siang%20gratis&detail=true&limit=5
      
    • Example Response:

      {
          "status": 200,
          "data": [
              {
                  "judul": "Example Title",
                  "link": "https://news.detik.com/example",
                  "gambar": "https://example.com/image.jpg",
                  "body": "Full article body...",
                  "waktu": "2024-08-04T12:34:56"
              }
              // Additional articles...
          ],
          "length": 5
      }