# Livenews

## List

`livenews.list(LivenewListParams**kwargs)  -> LivenewListResponse`

**get** `/livenews`

Returns a list of live news from query

### Parameters

- **q:** `str`

  Search query used to retrieve relevant news from index

### Returns

- `class LivenewListResponse`

  - **news:** `News`

    - **query:** `NewsQuery`

      - **original:** `str`

      - **spellcheck\_off:** `bool`

    - **results:** `List[NewsResult]`

      - **age:** `str`

      - **title:** `str`

      - **type:** `str`

      - **url:** `str`

      - **article\_id:** `Optional[str]`

      - **description:** `Optional[str]`

      - **meta\_url:** `Optional[NewsResultMetaURL]`

        - **hostname:** `str`

        - **netloc:** `str`

        - **path:** `str`

        - **scheme:** `str`

      - **metadata:** `Optional[Dict[str, object]]`

      - **page\_age:** `Optional[datetime]`

      - **source\_name:** `Optional[str]`

      - **thumbnail:** `Optional[NewsResultThumbnail]`

        - **src:** `str`

    - **type:** `str`

    - **metadata:** `Optional[NewsMetadata]`

      - **request\_uuid:** `str`

### Example

```python
from you_api import YouAPI

client = YouAPI(
    api_key="My API Key",
)
livenews = client.livenews.list(
    q="q",
)
print(livenews.news)
```