---
title: "Top Stories"
method: GET
path: "/{section}.{format}"
tags: ["Stories"]
---

# Top Stories

`GET /{section}.{format}`

The Top Stories API returns a list of articles and associated images currently on the specified section.  Support JSON and JSONP.

## Path parameters

- `section` 'home' | 'opinion' | 'world' | 'national' | 'politics' | 'upshot' | 'nyregion' | 'business' | 'technology' | 'science' | 'health' | 'sports' | 'arts' | 'books' | 'movies' | 'theater' | 'sundayreview' | 'fashion' | 'tmagazine' | 'food' | 'travel' | 'magazine' | 'realestate' | 'automobiles' | 'obituaries' | 'insider', required
- `format` 'json' | 'jsonp', required

## Query parameters

- `callback` string

## Response `200`

An array of articles

- object
  - `results` Article[]
    - `section` string
    - `subsection` string
    - `title` string
    - `abstract` string
    - `url` string
    - `thumbnail_standard` string
    - `short_url` string
    - `byline` string
    - `item_type` string
    - `updated_date` string
    - `created_date` string
    - `published_date` string
    - `material_type_facet` string
    - `kicker` string
    - `des_facet` string[]
    - `org_facet` string[]
    - `per_facet` string[]
    - `geo_facet` string[]
    - `multimedia` object[]
      - `url` string
      - `format` string
      - `height` integer
      - `width` integer
      - `type` string
      - `subtype` string
      - `caption` string
      - `copyright` string
    - `related_urls` object[]
      - `suggested_link_text` string
      - `url` string

---

[API](https://skmtc.net/nytimes/apis/top-stories.md) · [All operations](https://skmtc.net/nytimes/apis/top-stories/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nytimes/top-stories/versions/5d99044174ce/schema)