11 APIs across 2 product groups. All share one credential.
What agents get from Jentic-routed access to this vendor.
Setup
You create one New York Times developer key, enable the Times APIs you want on it, and register it once with Jentic. From then on an agent reaches every enabled Times API through the same search, load, and execute calls, without per-API wiring.
Permission scoping
You decide which Times APIs the key can reach by enabling them in the developer portal, and which operations your agent is allowed to call through Jentic, so a research agent can be limited to read-only article search without touching anything else.
Credential isolation
Your single New York Times developer key is stored encrypted by your own Jentic One instance and injected at execution time. The agent receives results, never the raw key, and the one key covers all 11 Times APIs.
Specific to using The New York Times APIs through Jentic.
Can AI agents use New York Times APIs?
Yes. All 11 New York Times APIs have OpenAPI specifications in the Jentic API Directory, so an agent can discover and call them by intent. Through Jentic the agent searches for an operation, loads its schema, and executes, without reading the Times documentation first. Install Jentic One (self-hosted) from https://github.com/jentic/jentic-one to get started.
Do I need a separate key for each New York Times API?
No. The Times uses one developer key across all of its APIs. You create the key once and enable each API on it. Through Jentic the key is stored encrypted and injected at execution time, so it never enters the agent's context.
Does The New York Times publish OpenAPI specs?
The specifications in the Jentic API Directory for the Times APIs are vendor-official, sourced from the Times developer portal. The operations, parameters, and responses match what the Times documents itself.
How do I connect my agent to the New York Times APIs?
Install Jentic One on your own infrastructure from its GitHub repo, register your New York Times developer key with it once, and add the Times APIs from the Jentic API Directory. Your agent then searches by intent, for example 'search New York Times articles', and Jentic returns the matching operation across the Times APIs with its input schema.
BOOK A DEMO
Browse thousands of APIs and connect them all to your agent with Jentic One. One layer, one credential — every API your agent needs.
For Agents
Read New York Times journalism programmatically: search the full article archive, pull bestseller and movie-review lists, track the most-shared stories, and follow a real-time newswire across 11 APIs with one key.
The Times exposes its newsroom as data, not just a website. Where a generic news API returns an undifferentiated feed, these return the same editorially curated lists, tags, and reviews the Times publishes itself. One developer key covers all 11 APIs, so an agent moves from search to archive to tags without re-authenticating.
Use for: New York Times editorial content and its metadata
Not supported: Subscriptions, Account billing, Payments, Ad buying
Credentials: Every New York Times API uses one developer key, passed as the api-key query parameter. You create the key once in the developer portal and enable each API on it. The same key works across all 11 APIs.
All 11 New York Times OpenAPI specs are vendor-official and indexed by Jentic, kept validated and agent-ready.
The New York Times publishes a family of read-only APIs over its journalism and its editorial metadata. An agent can search the article archive back to 1851, pull current bestseller and movie-review lists, see which stories readers are sharing, and follow a live wire of newly published articles. Every API is read-only and shares one developer key. The specifications are the Times's own.
| I want to... | Use | Why |
|---|---|---|
| Find specific articles by keyword, date, or filter | Article Search API | Full-text query over current and recent coverage with facets and date ranges. |
| Pull historical article metadata in bulk for a whole month | Archive API | Returns every article's metadata for a given year and month in one call. |
| See what readers are reading right now | Most Popular API | Most viewed, most emailed, and most shared, ranked by the Times's own counts. |
| Follow the live feed of newly published articles | Times Newswire API | Real-time stream of articles as they go live, by section. |
| Get the current curated headlines by section | Top Stories API | Editor-picked front-page and section lineups, not a search result. |
| Get bestseller lists and book reviews | Books API | The published bestseller lists by category and date, plus book reviews. |
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the New York Times APIs, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fnytimes.com" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fnytimes.com" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Once connected, ask your agent something like: “search New York Times articles”.
Each workflow spans multiple New York Times APIs. Jentic routes each operation to the right API automatically.
Morning editorial briefing
Build a morning brief that pairs the curated front page with what readers are actually reading and the latest wire. The agent reads Top Stories for the editor-picked headlines, Most Popular for the most-emailed and most-viewed pieces of the day, and the Times Newswire for articles published in the last hour. The result is one digest that reflects both editorial judgment and reader behavior.
Fetch the 'home' Top Stories section, the most emailed articles for the last day, and the latest Newswire items, then assemble a 10-item briefing grouped by section.
Top Stories API + Most Popular API + Times Newswire API
Research a topic across the Times corpus
Research how the Times has covered a topic over time. The agent searches current and recent coverage with Article Search, pulls month-by-month metadata from the Archive for the historical record, and resolves the people, places, and organizations involved through the Semantic API. Together they turn one query into a sourced timeline with tagged entities.
Search Article Search for 'climate policy' in 2024, pull the Archive metadata for the three months with the most hits, and resolve the top three tagged people via the Semantic API.
Article Search API + Archive API + Semantic API
Culture recommendations
Recommend what to read and watch from Times editorial sources. The agent pulls the current bestseller lists from the Books API and cross-references critics' picks from the Movie Reviews API, so each recommendation cites the Times rather than a generic rating. Useful for a culture concierge or a weekly newsletter agent.
Get this week's 'hardcover-fiction' bestseller list and the latest critics' picks, then return five paired book-and-film recommendations.
Books API + Movie Reviews API
Intent-based discovery
An agent searches by intent, for example 'find the most emailed articles', and Jentic returns the matching operation from across the 11 Times APIs with its input schema, so the agent calls the right API without knowing which one it is.
Which New York Times API should I use to find articles?
Use Article Search for keyword and filter queries over current and recent coverage, the Archive API for bulk month-by-month metadata, and the Times Newswire for articles as they are published. Most Popular returns what readers are reading rather than a search.
What can I build by combining New York Times APIs?
Common patterns pair editorial and behavioral signals: a morning briefing from Top Stories, Most Popular, and the Newswire, or a research timeline from Article Search, the Archive, and the Semantic API. One key covers every API a workflow touches.
Both are in the Jentic catalogue with the same one-credential, intent-search pattern.