The New York Times Timestags API

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

OpenAPI Specification

the-new-york-times-timestags-api-openapi.yml Raw ↑
openapi: 3.0.0
info:
  description: The Archive API provides lists of NYT articles by month going back to 1851.  You can use it to build your own local database of NYT article metadata.
  termsOfService: http://developer.nytimes.com/tou
  title: The New York Times Archive Timestags API
  version: 1.0.0
  x-apiClientRegistration:
    url: http://developer.nytimes.com/signup
  x-apisguru-categories:
  - media
  - open_data
  x-logo:
    url: https://api.apis.guru/v2/cache/logo/https_static01.nyt.com_images_icons_t_logo_291_black.png
  x-origin:
  - format: openapi
    url: https://raw.githubusercontent.com/nytimes/public_api_specs/master/archive_api/archive_api.json
    version: '3.0'
  x-providerName: nytimes.com
  x-serviceName: archive
servers:
- url: http://api.nytimes.com/svc/archive/v1
- url: https://api.nytimes.com/svc/archive/v1
security:
- apikey: []
tags:
- name: Timestags
paths:
  /timestags:
    get:
      parameters:
      - name: query
        in: query
        description: Your search query
        required: true
        schema:
          type: string
      - 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.

          '
        schema:
          type: string
          enum:
          - Des
          - Geo
          - Org
          - Per
      - name: max
        in: query
        description: Sets the maximum number of results
        schema:
          type: integer
          default: 10
      responses:
        '200':
          description: An array of tags
          content:
            application/json:
              schema:
                type: array
                items:
                  type: array
                  items:
                    type: string
      tags:
      - Timestags
components:
  securitySchemes:
    apikey:
      in: query
      name: api-key
      type: apiKey
externalDocs:
  url: http://developer.nytimes.com/