The New York Times Company
The New York Times Company Name API

The Name API from The New York Times Company — 1 operation(s) for name.
Documentation GitHub OpenAPI
OpenAPI Specification

swagger: '2.0'
info:
  version: 2.0.0
  title: Archive Name 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: 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]".

          '
        type: string
        enum:
        - nytd_geo
        - nytd_per
        - nytd_org
        - nytd_des
        required: true
      - 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
        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.

          '
        required: false
        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 &lt;specific_concept_name&gt;, Search Query will take the required parameters listed above (&lt;concept_type&gt;, &lt;concept_uri&gt;, &lt;article_uri&gt;) as an optional_parameter in addition to the query=&lt;query_term&gt;.
        required: true
        type: string
      responses:
        '200':
          description: An array of Concepts
          schema:
            type: object
            properties:
              status:
                type: string
              copyright:
                type: string
              num_results:
                type: integer
              results:
                type: array
                items:
                  $ref: '#/definitions/Concept'
      tags:
      - Name
definitions:
  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: '#/definitions/ConceptRelation'
      descendants:
        type: array
        items:
          $ref: '#/definitions/ConceptRelation'
securityDefinitions:
  apikey:
    type: apiKey
    name: api-key
    in: query
The New York Times Company Name API

Documentation

Specifications

Schemas & Data

Other Resources

OpenAPI Specification
