Skip to content
The API Specs (in OpenAPI/Swagger) for the APIs available from
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
archive_api Rename archive.yaml to archive_api.yaml Mar 6, 2019
article_search Rename article_search.yaml to article_search_v2.yaml Mar 6, 2019
community Rename community.yaml to community_api_v3.yaml Mar 6, 2019
most_popular_api Rename most_popular.yaml to most_popular_api_v2.yaml Mar 6, 2019
movie_reviews Rename movies.yaml to movie_reviews_v2.yaml Mar 6, 2019
semantic_api Rename semantic.yaml to semantic_api.yaml Mar 6, 2019
times_tags Rename times_tags.yaml to times_tags_v3.yaml Mar 6, 2019
timeswire Rename timeswire.yaml to timeswire_v3.yaml Mar 6, 2019
top_stories Rename top_stories.yaml to top_stories_v2.yaml Mar 6, 2019
.gitignore added .DS_Store Dec 14, 2016
LICENSE Add License & README Mar 17, 2016 Added links. May 6, 2016
community.yaml Add files via upload Mar 6, 2019

NYT Public API Specs

The API Specs (in OpenAPI format, formerly Swagger) for the APIs available from

Learn more about OpenAPI at

Checkout for all of the documentation about using NYTimes APIs and to signup for an API Key.

Questions? Email us at or open an issue.

If you notice any issues with the specs or want to contribute improvements, pull requests are welcome!

You can’t perform that action at this time.