Skip to main content
GET
/
data
/
news
/
articles
List news articles
curl --request GET \
  --url https://api.lava.so/v1/data/news/articles \
  --header 'Authorization: Bearer <token>'
{
  "articles": [
    {
      "publication": "<string>",
      "isPaywalled": true,
      "title": "<string>",
      "summary": "<string>",
      "tags": [
        "<string>"
      ],
      "author": "<string>",
      "originalUrl": "<string>",
      "archiveUrl": "<string>",
      "publishedAt": "2023-11-07T05:31:56Z",
      "source": "<string>"
    }
  ],
  "total": 123,
  "limit": 123,
  "offset": 123
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication used for standard API calls. Format: 'Bearer YOUR_API_KEY'

Query Parameters

​
publication
string

Comma-separated publication slugs to filter by (e.g. nytimes,wsj)

​
tag
string

Comma-separated tags to filter by (e.g. technology,business)

​
q
string

Case-insensitive keyword search across article title and summary. Tokens are split on whitespace and every token must appear in the title or summary (order-independent). Wildcards and operators are not supported — each token is matched literally.

Maximum string length: 200
​
since
string<date-time>

ISO 8601 date string. Only articles published after this date are returned. Defaults to 24 hours ago.

​
limit
integer
default:50

Page size (default 50, max 200)

Required range: 1 <= x <= 200
​
offset
integer
default:0

Pagination offset (default 0)

Required range: x >= 0

Response

Paginated list of articles

​
articles
object[]
​
total
integer
​
limit
integer
​
offset
integer