Skip to main content
POST
/nytimes/articles/search

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
count
integer
required
Required range: 1 <= x <= 1100
timeout
integer
default:300
Required range: 20 <= x <= 1500
keyword
string
default:""
types
enum<string>[]
Available options:
article,
athleticarticle,
audio,
carddeck,
interactive,
legacycollection,
paidpost,
recipe,
slideshow,
video,
wirecutterarticle
sort
enum<string>
default:best
Available options:
best,
newest,
oldest
language
enum<string>
default:en
Available options:
en,
es,
zh
section
enum<string> | null
Available options:
archives,
arts,
automobiles,
blogs,
books,
briefing,
business,
climate,
crosswords,
dining,
education,
fashion,
garden,
health,
insider,
learning,
magazine,
movies,
nyregion,
nytnow,
obituaries,
opinion,
pageoneplus,
podcasts,
reader-center,
realestate,
science,
smarter-living,
sports,
style,
t-magazine,
technology,
theater,
travel,
upshot,
us,
weather,
weekinreview,
world,
your-money
start_date
string | null
end_date
string | null

Response

Successful Response

uri
string
required
asset_type
string
required
document_title
string
required
@type
string
default:NytimesAsset
document_type
string | null
web_url
string | null
alias
string | null
seo_title
string | null
sub_headline
string | null
kicker
string | null
summary
string | null
promotional_headline
string | null
promotional_summary
string | null
published_at
integer | null
updated_at
integer | null
word_count
integer | null
tone
string | null
desk
string | null
language
string | null
section
object | null
subsection
object | null
authors
object[]
byline
string | null
image
object | null
tags
object[]
duration_seconds
integer | null