# New York Times

> Search New York Times articles, get top stories and trending articles, and look up the current Best Sellers list.

App · News · 4 actions. Web page: https://docs.lodol.com/docs/integrations/nyt

## Actions

### Get bestsellers

Get the current New York Times Best Sellers list for a category.

**Inputs**

- List name (`list_name`, text, required): Best Sellers list to fetch, for example 'hardcover-fiction' or 'hardcover-nonfiction'. See the docs for the full list of names.

**Outputs**

- `books` (list): Books on the list, in rank order

**Example output**

```json
{
  "books": [
    {
      "author": "Sam Author",
      "description": "A sweeping, ambitious debut.",
      "publisher": "Example Publisher",
      "purchase_url": "https://www.amazon.com/example",
      "rank": 1,
      "title": "EXAMPLE NOVEL",
      "weeks_on_list": 3
    }
  ]
}
```

### Get most popular articles

Get the most-viewed New York Times articles over the past 1, 7, or 30 days.

**Inputs**

- Period (`period`, number): Lookback window in days: 1, 7, or 30. One of: `1` (Past day), `7` (Past week), `30` (Past month). Default: `7`.

**Outputs**

- `articles` (list): Most-viewed articles in the period

**Example output**

```json
{
  "articles": [
    {
      "abstract": "A viral story about an unexpected topic.",
      "byline": "By Alex Lee",
      "published_date": "2026-01-18",
      "title": "The Most-Read Story This Week",
      "url": "https://www.nytimes.com/example.html"
    }
  ]
}
```

### Get top stories

Get the current top stories for a New York Times section.

**Inputs**

- Section (`section`, text, required): Section to fetch, for example 'home', 'world', or 'technology'.

**Outputs**

- `stories` (list): Top stories in the section

**Example output**

```json
{
  "stories": [
    {
      "abstract": "Quarterly results beat expectations.",
      "byline": "By John Doe",
      "published_date": "2026-01-20T08:00:00-05:00",
      "title": "Tech Giants Report Earnings",
      "url": "https://www.nytimes.com/example.html"
    }
  ]
}
```

### Search articles

Search New York Times articles by keyword, optionally within a date range.

**Inputs**

- Search query (`q`, text, required): Keywords to search for.
- Begin date (`begin_date`, text): Only include articles published on or after this date (YYYYMMDD).
- End date (`end_date`, text): Only include articles published on or before this date (YYYYMMDD).

**Outputs**

- `articles` (list): Matching articles

**Example output**

```json
{
  "articles": [
    {
      "abstract": "A look at urban adaptation efforts.",
      "byline": "By Jane Smith",
      "headline": "How Climate Change Is Reshaping Cities",
      "pub_date": "2026-01-15T10:00:00Z",
      "section_name": "Climate",
      "web_url": "https://www.nytimes.com/example.html"
    }
  ]
}
```