@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Times Newswire API
@base http://api.nytimes.com/svc/news/v3
@version 3.0.0
@auth ApiKey api-key in query
@endpoints 3
@toc content(2), content.json(1)

@group content
@endpoint GET /content/{source}/{section}.json
@required {source: any # Limits the set of items by originating source  all = items from both The New York Times and The International New York Times nyt = New York Times items only iht = International New York Times items only, section: any # Limits the set of items by one or more sections all | One or more section names, separated by semicolons   To get all sections, specify all. To get a particular section or sections, use the section names returned by this request:  http://api.nytimes.com/svc/news/v3/content/section-list.json}
@optional {limit: any # Limits the number of results, between 1 and 20, offset: any # Sets the starting point of the result set}
@returns(200) An array of Articles

@endpoint GET /content/{source}/{section}/{time-period}.json
@required {source: any # Limits the set of items by originating source  all = items from both The New York Times and The International New York Times nyt = New York Times items only iht = International New York Times items only, section: any # Limits the set of items by one or more sections all | One or more section names, separated by semicolons   To get all sections, specify all. To get a particular section or sections, use the section names returned by this request:  http://api.nytimes.com/svc/news/v3/content/section-list.json, time-period: any # Limits the set of items by time published, integer in number of hours}
@optional {limit: any # Limits the number of results, between 1 and 20, offset: any # Sets the starting point of the result set}
@returns(200) An array of Articles

@endgroup

@group content.json
@endpoint GET /content.json
@required {url: any # The complete URL of a specific news item, URL-encoded or backslash-escaped}
@returns(200) An array of Articles

@endgroup

@end