The New York Times Company

The New York Times Company Timestags API

The Timestags API from The New York Times Company — 1 operation(s) for timestags.

Documentation GitHub OpenAPI

Documentation

https://developer.nytimes.com/docs/articlesearch-product/1/overview

https://developer.nytimes.com/docs/top-stories-product/1/overview

https://developer.nytimes.com/docs/most-popular-product/1/overview

https://developer.nytimes.com/docs/timeswire-product/1/overview

https://developer.nytimes.com/docs/archive-product/1/overview

https://developer.nytimes.com/docs/books-product/1/overview

https://developer.nytimes.com/docs/movie-reviews-api/1/overview

https://developer.nytimes.com/docs/timestags-product/1/overview

https://developer.nytimes.com/docs/semantic-api-product/1/overview

https://developer.nytimes.com/docs/geo-product/1/overview

https://developer.nytimes.com/docs/community-api-product/1/overview

Specifications

https://raw.githubusercontent.com/api-evangelist/new-york-times-company/refs/heads/main/openapi/new-york-times-company-timestags-api-openapi.yml

Schemas & Data

https://raw.githubusercontent.com/api-evangelist/new-york-times-company/refs/heads/main/json-schema/article-schema.json

https://raw.githubusercontent.com/api-evangelist/new-york-times-company/refs/heads/main/json-schema/best-seller-book-schema.json

https://raw.githubusercontent.com/api-evangelist/new-york-times-company/refs/heads/main/json-schema/movie-review-schema.json

https://raw.githubusercontent.com/api-evangelist/new-york-times-company/refs/heads/main/json-schema/tag-schema.json

https://raw.githubusercontent.com/api-evangelist/new-york-times-company/refs/heads/main/json-schema/concept-schema.json

Other Resources

https://raw.githubusercontent.com/api-evangelist/new-york-times-company/refs/heads/main/examples/article-search-example.json

https://developer.nytimes.com/accounts/create

https://raw.githubusercontent.com/api-evangelist/new-york-times-company/refs/heads/main/examples/top-stories-home-example.json

https://raw.githubusercontent.com/api-evangelist/new-york-times-company/refs/heads/main/examples/most-popular-emailed-example.json

https://raw.githubusercontent.com/api-evangelist/new-york-times-company/refs/heads/main/examples/timeswire-content-example.json

https://raw.githubusercontent.com/api-evangelist/new-york-times-company/refs/heads/main/examples/archive-month-example.json

https://raw.githubusercontent.com/api-evangelist/new-york-times-company/refs/heads/main/examples/books-best-sellers-list-example.json

https://raw.githubusercontent.com/api-evangelist/new-york-times-company/refs/heads/main/examples/movie-reviews-search-example.json

https://raw.githubusercontent.com/api-evangelist/new-york-times-company/refs/heads/main/examples/times-tags-example.json

https://raw.githubusercontent.com/api-evangelist/new-york-times-company/refs/heads/main/examples/semantic-concept-example.json

https://raw.githubusercontent.com/api-evangelist/new-york-times-company/refs/heads/main/examples/geo-query-example.json

https://raw.githubusercontent.com/api-evangelist/new-york-times-company/refs/heads/main/examples/community-comments-example.json

https://developer.nytimes.com/docs/community-api-product/1/overview

OpenAPI Specification

swagger: '2.0'
info:
  version: 2.0.0
  title: Archive Timestags API
  description: 'The Archive API returns an array of NYT articles for a given month, going back to 1851.  Its response fields are the same as the Article Search API. The Archive API is very useful if you want to build your own database of NYT article metadata. You simply pass the API the year and month and it returns a JSON object with all articles for that month.  The response size can be large (~20mb).


    ```

    /{year}/{month}.json

    ```


    ## Example Call

    ```

    https://api.nytimes.com/svc/archive/v1/2019/1.json?api-key=yourkey

    ```

    '
host: api.nytimes.com
basePath: /svc/archive/v1
schemes:
- https
produces:
- application/json
security:
- apikey: []
tags:
- name: Timestags
paths:
  /timestags:
    get:
      parameters:
      - name: query
        in: query
        description: Your search query
        type: string
        required: true
      - name: filter
        in: query
        description: 'If you do not specify a value for filter (see the Optional Parameters), your query will be matched to tags in all four Times dictionaries: subject, geographic location, organization and person. To use more than one, separate with commas.

          '
        required: false
        type: string
        enum:
        - Des
        - Geo
        - Org
        - Per
      - name: max
        in: query
        description: Sets the maximum number of results
        default: 10
        required: false
        type: integer
      responses:
        '200':
          description: An array of tags
          schema:
            type: array
            items:
              type: array
              items:
                type: string
      tags:
      - Timestags
securityDefinitions:
  apikey:
    type: apiKey
    name: api-key
    in: query