@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Semantic API
@base http://api.nytimes.com/svc/semantic/v2/concept
@version 2.0.0
@auth ApiKey api-key in query
@endpoints 2
@toc name(1), search.json(1)

@group name
@endpoint GET /name/{concept-type}/{specific-concept}.json
@required {concept-type: any, specific-concept: any, query: any}
@optional {fields: any}
@returns(200)

@endgroup

@group search.json
@endpoint GET /search.json
@required {query: any}
@optional {offset: any, fields: any}
@returns(200)

@endgroup

@end