New York Times (Independent Publisher)

The New York Times allows anyone to search articles by keyword, date, section, and popularity. This connector allows a user to pull this data into their app, flow, or report.

This connector is available in the following products and regions:

Service	Class	Regions
Logic Apps	Standard	All Logic Apps regions except the following:      -   Azure Government regions      -   Azure China regions      -   US Department of Defense (DoD)
Power Automate	Premium	All Power Automate regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)
Power Apps	Premium	All Power Apps regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)

Contact
Name	Roy Paar
Email	roypaar@microsoft.com

Connector Metadata
Publisher	Roy Paar
Website	https://nytimes.com
Privacy policy	https://www.nytimes.com/privacy/privacy-policy
Categories	Lifestyle and Entertainment

Creating a connection

The connector supports the following authentication types:

Default	Parameters for creating connection.	All regions	Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name	Type	Description	Required
apikey	securestring	The apikey for this api	True

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds

Actions

Returns a list of articles based on keyword search	Search for NYT articles by keywords.
Returns a list of most viewed articles on NYTimes.com by time period	Returns an array of the most viewed articles on NYTimes.com for specified period of time (1 day, 7 days, or 30 days).
Returns a list of top stories by section	The Top Stories service returns an array of articles currently on the specified section.

Returns a list of articles based on keyword search

Operation ID:

ArticleSearch

Search for NYT articles by keywords.

Parameters

Name	Key	Required	Type	Description
Keyword	q	True	string	Query
Begin date (e.d. 20120101)	begin_date		string	Begin date (e.g. 20120101)
End date (e.g. 20121231)	end_date		string	End date (e.g. 20121231)

Returns

Name	Path	Type	Description
status	status	string
copyright	copyright	string
docs	response.docs	array of Article
meta	response.meta	object

Returns a list of most viewed articles on NYTimes.com by time period

Operation ID:

MostViewed

Returns an array of the most viewed articles on NYTimes.com for specified period of time (1 day, 7 days, or 30 days).

Parameters

Name	Key	Required	Type	Description
Time period of 1, 7, or 30 days.	period	True	integer	Time period of 1, 7, or 30 days.

Returns

Name	Path	Type	Description
status	status	string	API response status (e.g. OK).
copyright	copyright	string	Copyright message.
results	results	array of ViewedArticle	Array of articles.

Returns a list of top stories by section

Operation ID:

TopStories

The Top Stories service returns an array of articles currently on the specified section.

Parameters

Name	Key	Required	Type	Description
The section the store appears in.	section	True	string	The section the story appears in.

Returns

Name	Path	Type	Description
status	status	string
copyright	copyright	string
section	section	string
last_updated	last_updated	string
results	results	array of Article

Definitions

Article

Name	Path	Type	Description
web_url	web_url	string
snippet	snippet	string
print_page	print_page	string
source	source	string
headline	headline	Headline
keywords	keywords	array of Keyword
pub_date	pub_date	string
document_type	document_type	string
news_desk	news_desk	string
type_of_material	type_of_material	string
_id	_id	string
score	score	integer
uri	uri	string

Headline

Name	Path	Type	Description
main	main	string
kicker	kicker	string
content_kicker	content_kicker	string
print_headline	print_headline	string
name	name	string
seo	seo	string
sub	sub	string

Keyword

Name	Path	Type	Description
name	name	string
value	value	string
major	major	string

ViewedArticle

Name	Path	Type	Description
url	url	string	Article's URL.
adx_keywords	adx_keywords	string	Semicolon separated list of keywords.
column	column	string	Deprecated. Set to null.
section	section	string	Article's section (e.g. Sports).
byline	byline	string	Article's byline (e.g. By Thomas L. Friedman).
type	type	string	Asset type (e.g. Article, Interactive, ...).
title	title	string	Article's headline (e.g. When the Cellos Play, the Cows Come Home).
abstract	abstract	string	Brief summary of the article.
published_date	published_date	string	When the article was published on the web (e.g. 2021-04-19).
source	source	string	Publisher (e.g. New York Times).
des_facet	des_facet	array of string	Array of description facets (e.g. Quarantine (Life and Culture)).
org_facet	org_facet	array of string	Array of organization facets (e.g. Sullivan Street Bakery).
per_facet	per_facet	array of string	Array of person facets (e.g. Bittman, Mark).
geo_facet	geo_facet	array of string	Array of geographic facets (e.g. Canada).
media	media	array of Media	Array of images.
uri	uri	string	An article's globally unique identifier.

Media

Name	Path	Type	Description
type	type	string	Asset type (e.g. image).
subtype	subtype	string	Asset subtype (e.g. photo).
caption	caption	string	Media caption.
copyright	copyright	string	Media credit.
media-metadata	media-metadata	array of MediaMetadata	Media metadata (url, width, height, ...).

MediaMetadata

Name	Path	Type	Description
url	url	string	Image's URL.
format	format	string	Image's crop name.