New York Times

The New York Times provides official developer access to its editorial content, covering top stories, article search, most popular articles, books bestseller lists, and movie reviews.

MoEngage <> New York Times

The MoEngage <> New York Times integration allows you to pull authoritative editorial content into your campaigns at send time via Content APIs. Common use cases include surfacing top stories in a content-led email newsletter, enriching B2B campaigns with relevant news, or personalising in-app messages with articles matching a user's interests.

Integration

library_add_check

Prerequisites

Ensure you have a New York Times developer account with an active API key. Keys are free and available at developer.nytimes.com/get-started.

Step 1: Get your New York Times API key

Navigate to developer.nytimes.com/get-started and sign in or create an account.
Go to My Apps and create a new app. Enable the APIs you need for campaign personalisation, for example enable Top Stories and Article Search.
Copy the API key from your app dashboard.
Note the rate limit: 500 requests per day and 5 requests per minute on the free tier.

Step 2: Set up the Content API on MoEngage

Navigate to Dashboard > Settings > APIs and open the Content API tab.
Click Add Content API.
Fill in the details using the table below as a reference.

Key Value

Name Choose a descriptive name, for example NYT Top Stories.

Method GET

API URL

https://api.nytimes.com/svc/topstories/v2/home.json

Replace home with a section name such as technology, sports, business, or arts to filter by topic. Refer to the Top Stories API documentation for the full list of sections.

Key Value Parameters

Parameter	Example value	Notes
`api-key`	Your API key	Required for every request.

Click Validate to confirm the platform returns a response, then click Save.

Once saved, refer to the MoEngage documentation on using Content APIs in campaigns to learn how to reference response fields inside your campaign templates.

Understanding the API response

The response contains a results array. Each object represents one article.

Response field	Template variable example	Description
`results[0].title`	`{{ContentApi.results[0].title}}`	The article headline.
`results[0].abstract`	`{{ContentApi.results[0].abstract}}`	A short summary of the article.
`results[0].url`	`{{ContentApi.results[0].url}}`	The full NYT article URL.
`results[0].multimedia[0].url`	`{{ContentApi.results[0].multimedia[0].url}}`	Thumbnail image URL for the article.
`results[0].section`	`{{ContentApi.results[0].section}}`	The editorial section, for example "Technology".
`results[0].published_date`	`{{ContentApi.results[0].published_date}}`	Publication date in ISO 8601 format.