> For the complete documentation index, see [llms.txt](https://jsmiiith.gitbook.io/nytimes/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://jsmiiith.gitbook.io/nytimes/documentation/popular-mostviewed.md).

# Popular - mostViewed

## Example

{% code title="example.js" %}

```javascript
const { Popular } = require('nytimes-api');
const popular = new Popular('your-super-secret-api-key');

popular.mostViewed(data => console.log(data[0]);
```

{% endcode %}

### What does it do?

`mostViewed` gets the articles with the most amount of views on the New York Times' website.

The code example above, however, only displays the most viewed **article** rather than the most viewed **articles**.

## Example Response

{% code title="example-response.json" %}

```javascript
{
  "url": "https://www.nytimes.com/interactive/2019/02/15/upshot/british-irish-dialect-quiz.html",
  "adx_keywords": "English Language;Geography;Ireland;Great Britain",
  "column": "",
  "section": "The Upshot",
  "byline": "By JOSH KATZ",
  "type": "Interactive",
  "title": "The British-Irish Dialect Quiz",
  "abstract": "What does the way you speak say about where you’re from? Answer 25 questions to see your own custom dialect map.",
  "published_date": "2019-02-15",
  "source": "The New York Times",
  "id": 100000006354694,
  "asset_id": 100000006354694,
  "views": 1,
  "des_facet": ["GEOGRAPHY"],
  "org_facet": ["ENGLISH LANGUAGE"],
  "per_facet": "",
  "geo_facet": ["IRELAND", "GREAT BRITAIN"],
  "media": [
    {
      "type": "image",
      "subtype": "photo",
      "caption": null,
      "copyright": null,
      "approved_for_syndication": 0,
      "media-metadata": [Array]
    }
  ]
}

```

{% endcode %}
