---
title: "Article Search"
method: GET
path: "/articlesearch.json"
tags: ["Stories"]
---

# Article Search

`GET /articlesearch.json`

Article Search requests use the following URI structure:

## Query parameters

- `q` string
- `fq` string
- `begin_date` string
- `end_date` string
- `sort` 'newest' | 'oldest'
- `fl` string
- `hl` boolean
- `page` integer
- `facet_field` string
- `facet_filter` boolean

## Response `200`

The docs requested by the article search.

- object
  - `response` object
    - `docs` Doc[]
      - `web_url` string
      - `snippet` string
      - `lead_paragraph` string
      - `abstract` string
      - `print_page` string
      - `blog` unknown[]
        - unknown
      - `source` string
      - `headline` object
        - `main` string
        - `kicker` string
      - `keywords` object
        - `rank` string
        - `name` string
        - `value` string
      - `pub_date` string
      - `document_type` string
      - `news_desk` string
      - `section_name` string
      - `subsection_name` string
      - `byline` object
        - `organization` string
        - `original` string
        - `person` unknown[]
          - unknown
      - `type_of_material` string
      - `_id` string
      - `word_count` string
      - `slideshow_credits` string
      - `multimedia` object[]
        - `url` string
        - `format` string
        - `height` integer
        - `width` integer
        - `type` string
        - `subtype` string
        - `caption` string
        - `copyright` string
    - `meta` object
      - `hits` integer
      - `time` integer
      - `offset` integer

## Changes

- **2016-05-09** (v2) `ab8ccd47fa0f` — 1 warning
  - deleted the `query` request parameter `callback`
- **2016-05-09** (v2) `983d315f4441` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/nytimes/apis/article-search-api/changes/articlesearch.json/get.md)

---

[API](https://skmtc.dev/nytimes/apis/article-search-api.md) · [All operations](https://skmtc.dev/nytimes/apis/article-search-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nytimes/article-search-api/revisions/20bcce97259e/schema)