The Search API allows you to directly access our powerful news and content search engine in real-time.
https://api.newswireapi.com/search
All available options and settings for the Search API are listed in the table below.
| Param Name | Param Notes | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
API Key
Your API Key from NewswireAPI.
Usage:
apikey=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Type:
string
Options:
Default:
[none]
Example:
apikey=
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Search Query
The topics, sources, feeds and keywords you want to search for in NewswireAPI.
Usage:
q={#topic|@source.com|.feed-com|keywords|_words|~strings} .. ** Must be URL encoded! **
Type:
string
Options:
Default:
[none]
Example:
q=%23technology+web+development
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Include Only Specified Fields
Allows you to specify which fields you want returned from the search results. If no fields are specified, the default fields are returned.
Usage:
fields={fieldname1}{,fieldname2}{,...}
Type:
string .. (comma separated)
Options:
Default:
title,url,author,source,content,date,time
Example:
fields=title,content,url,date,time
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Return Results in Specified Format
Allows you to set which format to use with returned data.
Usage:
format={json|rss|csv|tab|html}
Type:
string
Options:
Default:
json
Example:
format=json
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Return Results Using Specified Timezone
Allows you to set the timezone that will be used to adjust the dates and times in all results returned.
Use the API Search Wizard to see available timezone identifiers. Usage:
timezone={America/New_york|Europe/London|Asia/Hong_Kong|...}
Type:
string
Options:
Default:
0
Example:
timezone=America/New_york
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Define date format to return in 'date' field
Allows you to specify which date format you want returned in the 'date' field in search results.
Usage:
dateformat={dateformat}
Type:
string
Options:
Default:
date_rfc2822
Example:
date=date_formal_weekday_long
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Define date format to return in 'date' field
Allows you to specify which date format you want returned in the 'date' field in search results.
Usage:
timeformat={timeformat}
Type:
string
Options:
Default:
time_24_short
Example:
time=time_age_short
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Include Results Starting at Specified Row
Allows you to set the starting row for results returned.
Usage:
start={0..499}
Type:
integer
Options:
Default:
0
Example:
start=20
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Include up to Specified Rows
Allows you to set how many rows of results you would like returned.
Usage:
rows={number_of_results}
Type:
integer
Options:
Default:
10
Example:
rows=20
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Limit Results by Topic
Allows you to bypass the normal search query and directly limit results only from the #topic search topic.
Use Discover Topics to search for a specific topic. Usage:
topic={topic}
Type:
string
Options:
Default:
[none]
Example:
topic=technology
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Limit Results by Source
Allows you to bypass the normal search query and directly limit results only from the @source.com source.
Use Discover Sources to search for a specific source. Usage:
source={domain.com}
Type:
string
Options:
Default:
[none]
Example:
source=theverge.com
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Limit Results by Feed
Allows you to bypass the normal search query and directly limit results only from the .feed-com feed.
Use Discover Feeds to search for a specific feed. Usage:
feed={feed-name}
Type:
string
Options:
Default:
[none]
Example:
feed=theverge-com-tech
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Limit Results by Location
Allows you to include only content flagged from a specific location if supported by NewswireAPI. A location requires three components including city, state/province/territory and country.
Use Locations or API Search Wizard to search for a specific location. Usage:
location={city,state/province/territory,country} .. ** Must be URL encoded! **
Type:
string
Options:
Default:
[none]
Example:
location=Boston%2CMassachusetts%2CUnited%20States
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Exclude Known Left or Right Biased Sources
Allows you to exclude content from all known left-baised or right-biased flagged sources.
** The list of biased sources is subjectively determined by the political leanings of each source's recently published content. Sources are reviewed regularly and their bias status can change over time. Usage:
nobias={0|1}
Type:
integer
Options:
Default:
0
Example:
nobias=1
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Exclude Known Left Biased Sources
Allows you to exclude content from all known left-biased flagged sources.
** The list of biased sources is subjectively determined by the political leanings of each source's recently published content. Sources are reviewed regularly and their bias status can change over time. Usage:
nobiasleft={0|1}
Type:
integer
Options:
Default:
0
Example:
nobiasleft=1
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Exclude Known Right Biased Sources
Allows you to exclude content from all known right-biased flagged sources.
** The list of biased sources is subjectively determined by the political leanings of each source's recently published content. Sources are reviewed regularly and their bias status can change over time. Usage:
nobiasright={0|1}
Type:
integer
Options:
Default:
0
Example:
nobiasright=1
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Exclude Duplicate Content
Allows you to exclude duplicate content from multiple sources such as syndicated content.
Usage:
noduplicates={0|1}
Type:
integer
Options:
Default:
0
Example:
noduplicates=1
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Exclude Fields with Empty Values
Allows you to exclude empty fields to reduce the amount of data returned. This can help reduce bandwidth usage and improve speed in some situations.
Usage:
noempty={0|1|2}
Type:
integer
Options:
Default:
0
Example:
noempty=1
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Exclude Imageless Content
Allows you to exclude content that does not contain an image.
Usage:
noimageless={0|1}
Type:
integer
Options:
Default:
0
Example:
noimageless=1
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Exclude Local Sources
Allows you to exclude content from known local content sources. The list of sources flagged as local is under constant review and does not include some sources that may cover larger markets.
Usage:
nolocal={0|1}
Type:
integer
Options:
Default:
0
Example:
nolocal=1
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Exclude Known Paywall Sources
Allows you to exclude content from all known paywalled sources, including sources with only partial paywalled content.
Usage:
nopaywall={0|1}
Type:
integer
Options:
Default:
0
Example:
nopaywall=1
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Exclude Known Political Sources and Content
Allows you to exclude all content detected and flagged as political.
Usage:
nopolitics={0|1}
Type:
integer
Options:
Default:
0
Example:
nopolitics=1
|