UNPKG

openapi-directory

Version:

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

1 lines 3.25 kB
{"openapi":"3.0.0","servers":[{"url":"http://api.nytimes.com/svc/archive/v1"},{"url":"https://api.nytimes.com/svc/archive/v1"}],"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":"Archive API","version":"1.0.0","x-apiClientRegistration":{"url":"http://developer.nytimes.com/signup"},"x-apisguru-categories":["media","open_data"],"x-logo":{"url":"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"},"externalDocs":{"url":"http://developer.nytimes.com/"},"security":[{"apikey":[]}],"paths":{"/{year}/{month}.json":{"get":{"description":"The Archive API provides lists of NYT articles by month going back to 1851. Simply pass in the year and month you want and it returns a JSON object with all articles for that month.\n","parameters":[{"description":"The year (e.g. 2016).","in":"path","name":"year","required":true,"schema":{"default":"2016","format":"int32","maximum":2030,"minimum":1851,"type":"integer"},"x-consoleDefault":"2016"},{"description":"The month number (e.g. 1 for January).","in":"path","name":"month","required":true,"schema":{"default":"1","format":"int32","maximum":12,"minimum":1,"type":"integer"},"x-consoleDefault":"1"}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"response":{"properties":{"docs":{"items":{"$ref":"#/components/schemas/Doc"},"type":"array"},"meta":{"properties":{"hits":{"type":"integer"},"offset":{"type":"integer"},"time":{"type":"integer"}},"type":"object"}},"type":"object"}},"type":"object"}}},"description":"The docs requested."}},"summary":"Archive API","tags":["Archive"]}}},"components":{"schemas":{"Doc":{"properties":{"_id":{"type":"string"},"abstract":{"type":"string"},"blog":{"items":{},"type":"array"},"byline":{"properties":{"organization":{"type":"string"},"original":{"type":"string"},"person":{"items":{},"type":"array"}},"type":"object"},"document_type":{"type":"string"},"headline":{"properties":{"kicker":{"type":"string"},"main":{"type":"string"}},"type":"object"},"keywords":{"properties":{"name":{"type":"string"},"rank":{"type":"string"},"value":{"type":"string"}},"type":"object"},"lead_paragraph":{"type":"string"},"multimedia":{"items":{"properties":{"caption":{"type":"string"},"copyright":{"type":"string"},"format":{"type":"string"},"height":{"type":"integer"},"subtype":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"},"width":{"type":"integer"}},"type":"object"},"type":"array"},"news_desk":{"type":"string"},"print_page":{"type":"string"},"pub_date":{"type":"string"},"section_name":{"type":"string"},"slideshow_credits":{"type":"string"},"snippet":{"type":"string"},"source":{"type":"string"},"subsection_name":{"type":"string"},"type_of_material":{"type":"string"},"web_url":{"type":"string"},"word_count":{"type":"string"}},"type":"object"}},"securitySchemes":{"apikey":{"in":"query","name":"api-key","type":"apiKey"}}}}