CloudObjects / Directory / The New York Times / TimesTags API
Sign in

TimesTags API

a wa:WebAPI in The New York Times

With the TimesTags API, you can mine the riches of the New York Times tag set. The TimesTags service matches your query to the controlled vocabularies that fuel NYTimes.com metadata. You supply a string of characters, and the service returns a ranked list of suggested terms.

Base URL

The API endpoint is located at the following URL:
https://api.nytimes.com/svc/suggest/v1

Authentication
API Methods

These are the methods supported by the API:

  • GET /timestags.json
    Required parameters:
    query Your search query
    Optional parameters:
    filter 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.
    max Sets the maximum number of results
    Success response:

    An array of tags

    Status Code 200
    
    
Meta
URI / COID
coid://nytimes.cloudobjects.io/TimesTagsAPI/V1
Revision
1-9c2f58babe364f20c2a27a08b14badb7
Created at
2017-05-28 15:47 (UTC)
Usage permission
co:Public