Share via

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
Copilot Studio 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)
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   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)
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)
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.
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.