> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wokelo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# [Legacy] Initiate News Report

## Overview

This endpoint initiates news report on a company

## Endpoint Details

* **Method:** POST
* **Endpoint:** `/api/news/start/`

## Authentication requirements

* Include a valid JWT token in your request header
* If you don't have a token yet, you can get one from the `/auth/token/` endpoint first.

## Request

### Request Parameter

#### Header Parameters

<ParamField header="Authorization" type="string" required>
  JWT token obtained from the Authentication request
</ParamField>

#### Body Parameters

<ParamField body="whitelisted_domains" type="array">
  Domains of news sources from which to fetch news
</ParamField>

<ParamField body="blacklisted_domains" type="array">
  News source domains to exclude from search
</ParamField>

<ParamField body="news_limit" type="integer">
  Number of news items to retrieve (Default: 1000)
</ParamField>

<ParamField body="start_date" type="string">
  Date from which news will be retrieved.

  * Default: 2 years
  * Format: `YYYY-MM-DD`
</ParamField>

<ParamField body="end_date" type="string">
  Date till which news will be retrieved.

  * Default: current date
  * Format: `YYYY-MM-DD`
</ParamField>

<ParamField body="website" type="string" required>
  Website of the target company
</ParamField>

<ParamField body="permalink" type="string" required>
  Crunchbase permalink of the target company
</ParamField>

*Note: Either of permalink or website is required as company identifier*

## Response

Successful response JSON will include the report\_id of the news report

<ResponseExample>
  ```json 200 theme={"system"}
  {
      "report_id": 2000156
  }
  ```
</ResponseExample>