The New York Times

The New York Times Name API

The Name API from The New York Times — 1 operation(s) for name.

GitHub OpenAPI

Documentation

📖
Documentation
https://developer.nytimes.com/docs/archive-product/1/overview
📖
Documentation
https://developer.nytimes.com/docs/articlesearch-product/1/overview
📖
Documentation
https://developer.nytimes.com/docs/books-product/1/overview
📖
Documentation
https://developer.nytimes.com/docs/most-popular-product/1/overview
📖
Documentation
https://developer.nytimes.com/docs/movie-reviews-api/1/overview
📖
Documentation
https://developer.nytimes.com/docs/semantic-api-product/1/overview
📖
Documentation
https://developer.nytimes.com/docs/timestags-product/1/overview
📖
Documentation
https://developer.nytimes.com/docs/timeswire-product/1/overview
📖
Documentation
https://developer.nytimes.com/docs/top-stories-product/1/overview

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/the-new-york-times/refs/heads/main/openapi/the-new-york-times-name-api-openapi.yml

OpenAPI Specification

the-new-york-times-name-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 Name 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: Name
paths:
  /name/{concept-type}/{specific-concept}.json:
    get:
      parameters:
      - name: concept-type
        in: path
        description: 'The type of the concept, used for Constructing a Semantic API Request by Concept Type and Specific Concept Name. The parameter is defined as a name-value pair, as in "concept_type=[nytd_geo|nytd_per|nytd_org|nytd_des]".

          '
        required: true
        schema:
          type: string
          enum:
          - nytd_geo
          - nytd_per
          - nytd_org
          - nytd_des
      - name: specific-concept
        in: path
        description: 'The name of the concept, used for Constructing a Semantic API Request by Concept Type and Specific Concept Name. The parameter is defined in the URI path, as the element immediately preceding ".json" like with "Baseball.json".

          '
        required: true
        schema:
          type: string
      - name: fields
        in: query
        description: '"all" or comma-separated list of specific optional fields: pages, ticker_symbol, links, taxonomy, combinations, geocodes, article_list, scope_notes, search_api_query


          Optional fields are returned in result_set. They are briefly explained here:


          pages: A list of topic pages associated with a specific concept.

          ticker_symbol: If this concept is a publicly traded company, this field contains the ticker symbol.

          links: A list of links from this concept to external data resources.

          taxonomy: For descriptor concepts, this field returns a list of taxonomic relations to other concepts.

          combinations: For descriptor concepts, this field returns a list of the specific meanings tis concept takes on when combined with other concepts.

          geocodes: For geographic concepts, the full GIS record from geonames.

          article_list: A list of up to 10 articles associated with this concept.

          scope_notes: Scope notes contains clarifications and meaning definitions that explicate the relationship between the concept and an article.

          search_api_query: Returns the request one would need to submit to the Article Search API to obtain a list of articles annotated with this concept.

          '
        schema:
          type: string
          enum:
          - all
          - pages
          - ticker_symbol
          - links
          - taxonomy
          - combinations
          - geocodes
          - article_list
          - scope_notes
          - search_api_query
      - name: query
        in: query
        description: Precedes the search term string. Used in a Search Query. Except for <specific_concept_name>, Search Query will take the required parameters listed above (<concept_type>, <concept_uri>, <article_uri>) as an optional_parameter in addition to the query=<query_term>.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: An array of Concepts
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                  copyright:
                    type: string
                  num_results:
                    type: integer
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/Concept'
      tags:
      - Name
components:
  schemas:
    ConceptRelation:
      type: object
      properties:
        concept_id:
          type: integer
        concept_name:
          type: string
        is_times_tag:
          type: integer
        concept_status:
          type: string
        vernacular:
          type: string
        concept_type:
          type: string
        concept_created:
          type: string
        concept_updated:
          type: string
    Concept:
      type: object
      properties:
        concept_id:
          type: integer
        concept_name:
          type: string
        is_times_tag:
          type: integer
        concept_status:
          type: string
        vernacular:
          type: string
        concept_type:
          type: string
        concept_created:
          type: string
        concept_updated:
          type: string
        taxonomy:
          type: array
          items:
            type: object
            properties:
              source_concept_id:
                type: integer
              target_concept_id:
                type: integer
              source_concept_name:
                type: string
              target_concept_name:
                type: string
              source_concept_type:
                type: string
              target_concept_type:
                type: string
              source_concept_vernacular:
                type: string
              target_concept_vernacular:
                type: string
              taxonomic_relation:
                type: string
              taxonomic_verification_status:
                type: string
        links:
          type: array
          items:
            type: object
            properties:
              concept_id:
                type: integer
              concept_name:
                type: string
              concept_status:
                type: string
              is_times_tag:
                type: integer
              concept_type:
                type: string
              link_id:
                type: integer
              relation:
                type: string
              link:
                type: string
              link_type:
                type: string
              mapping_type:
                type: string
        search_api_query:
          type: string
        article_list:
          type: object
          properties:
            results:
              type: array
              items:
                type: object
                properties:
                  body:
                    type: string
                  byline:
                    type: string
                  concepts:
                    type: object
                    properties:
                      nytd_des:
                        type: array
                        items:
                          type: string
                      nytd_org:
                        type: array
                        items:
                          type: string
                      nytd_per:
                        type: array
                        items:
                          type: string
                  date:
                    type: string
                  document_type:
                    type: string
                  title:
                    type: string
                  type_of_material:
                    type: string
                  url:
                    type: string
            total:
              type: integer
        scope_notes:
          type: array
          items:
            type: object
            properties:
              scope_note:
                type: string
              scope_note_name:
                type: string
              scope_note_type:
                type: string
        combinations:
          type: array
          items:
            type: object
            properties:
              combination_source_concept_id:
                type: integer
              combination_source_concept_name:
                type: string
              combination_source_concept_type:
                type: string
              combination_target_concept_id:
                type: integer
              combination_target_concept_name:
                type: string
              combination_target_concept_type:
                type: string
              combination_note:
                type: string
        ancestors:
          type: array
          items:
            $ref: '#/components/schemas/ConceptRelation'
        descendants:
          type: array
          items:
            $ref: '#/components/schemas/ConceptRelation'
  securitySchemes:
    apikey:
      in: query
      name: api-key
      type: apiKey
externalDocs:
  url: http://developer.nytimes.com/