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
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.

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

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

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.