Community API

Name: Community API API
Brand: Community API
Availability: InStock

✓ Official Vendor SpecMediaContent DeliveryapiKey4 EndpointsREST

For Agents

Read NYT user comments by article URL, by user, by date, or as a recent feed across the site.

Quickstart

Get started with Community API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"get NYT article comments"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Community API API.

Pull the most recent comments posted across all NYT articles

Retrieve every comment thread attached to a specific article URL

Fetch a single user's full comment history by display name

Filter comments to a specific publication date range

Surface NYT-picked comments via the editors_selection flag in responses

GET STARTED

Start building with Community API API

Explore with Jentic

View OpenAPI Document

The New York Times Community API provides read access to comments left by registered users on NYT articles. Agents can pull recent comments site-wide, filter by article URL, retrieve a specific user's comment history, or fetch comments posted within a date range. Each comment record includes the author's display name, comment body, recommendation count, NYT pick flag, and the article URL it was posted on. The API is officially marked deprecated by NYT, but the endpoints continue to respond and remain useful for archival research and sentiment analysis on legacy NYT comment threads.

Use Cases

Patterns agents use Community API API for, with concrete tasks.

★ Comment Thread Archival

Pull and store the full comment thread for a NYT article for archival or research purposes. The /user-content/url.json endpoint accepts the article URL and returns every comment with body text, author display name, recommendation count, and the editors_selection flag identifying NYT picks. Pagination via the offset parameter handles threads with hundreds of entries.

Call /user-content/url.json?url=https://www.nytimes.com/2023/01/01/opinion/example.html with offset 0, then page through with offset increments of 25 until results are empty.

Sentiment Analysis on Recent Coverage

Feed recent NYT comments into a downstream sentiment classifier. The /user-content/recent.json endpoint returns the latest comments site-wide so an agent can sample the current discussion volume and tone. Combined with article URL filtering, this supports near-real-time analysis of reader response to fresh coverage.

Fetch /user-content/recent.json with offset 0, extract the commentBody field for each entry, and pipe to a sentiment classifier returning per-article averages.

User Comment History Research

Retrieve the full comment history of a specific NYT user by display name to study contribution patterns, frequency, and topic clustering. The /user-content/user.json endpoint accepts a userDisplayName parameter and pages through the user's published comments.

Call /user-content/user.json?userDisplayName='Jane Smith'&offset=0 and continue paging in 25-comment increments until the response array is empty.

Agent-Driven Comment Lookup via Jentic

An AI research assistant uses Jentic to call the deprecated NYT Community API at runtime when a user asks for comment context on a story. The agent searches Jentic by intent, loads the operation schema, and executes the call without manually wiring auth or pagination.

Search Jentic for 'get NYT article comments', load the /user-content/url.json operation, and execute with the target article URL.

Key Endpoints

4 endpoints — the new york times community api provides read access to comments left by registered users on nyt articles.

METHOD

PATH

DESCRIPTION

GET

/user-content/recent.json

List recent comments across all NYT articles

GET

/user-content/url.json

Get comments for a specific article URL

GET

/user-content/user.json

Get all comments by a specific NYT user

GET

/user-content/by-date.json

Get comments posted on a specific date

GET

/user-content/recent.json

List recent comments across all NYT articles

GET

/user-content/url.json

Get comments for a specific article URL

GET

/user-content/user.json

Get all comments by a specific NYT user

GET

/user-content/by-date.json

Get comments posted on a specific date

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The NYT api-key is stored encrypted in the Jentic vault and injected into the api-key query parameter at execution time. The same credential covers all NYT developer APIs registered to a workspace, so a single rotation updates Books, Community, Top Stories, and the others together.

Intent-based discovery

Agents search Jentic for 'get NYT article comments' or 'look up reader comment history' and Jentic returns the matching /user-content endpoint with its parameter schema, removing the need to read the deprecated NYT documentation.

Time to first call

Direct integration: a few hours to wire the api-key, paginate the offset parameter, and parse the comment payload. Through Jentic: under 15 minutes.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

NYT Top Stories API

Surfaces the article URLs whose comment threads can then be loaded via the Community API.

Use Top Stories first to find article URLs by section, then pass those URLs into the Community API to read comment threads.

Complementary

NYT Times Newswire API

Streams freshly published article URLs that can be paired with Community comments.

Pair with Times Newswire to monitor new articles and immediately fetch any comments as they appear.

Complementary

NYT Most Popular API

Returns the most-emailed and most-shared NYT articles whose comment threads are typically active.

Use to identify high-engagement articles before pulling their full comment threads.

FAQs

Specific to using Community API API through Jentic.

What authentication does the NYT Community API use?

The Community API uses an API key passed as the api-key query parameter. Provision a key at developer.nytimes.com. Through Jentic, the key is held in the vault and injected at request time, so it never appears in the agent's context.

Is the NYT Community API still active?

NYT marks this API as deprecated in their developer portal, meaning no new features will land and SLA is not guaranteed. The 4 endpoints continue to respond as of this writing, so the API remains usable for archival lookups and historical research, but production systems should plan for eventual sunset.

Can I retrieve every comment on a specific article?

Yes. Call GET /user-content/url.json with the article URL and page using the offset parameter in increments of 25 until the results array is empty. Each response includes commentBody, userDisplayName, recommendations, and the editorsSelection flag.

What are the rate limits for the NYT Community API?

NYT enforces 500 requests per day and 5 requests per minute per API key across all NYT developer APIs combined. Build in retry-after handling when reading large comment threads.

How do I pull recent NYT comments through Jentic?

Search Jentic for 'get recent NYT comments', load the /user-content/recent.json operation, and execute it. The response returns the latest site-wide comments with article URL, body, and recommendation count.

Can I post or moderate comments through this API?

No. The Community API is read-only. There are no endpoints for creating, editing, deleting, or recommending comments, so it cannot be used for moderation or community management workflows.