POST
/
news
curl --request POST \
  --url https://api.search1api.com/news \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "query": "<string>",
  "search_service": "google",
  "max_results": 50,
  "crawl_results": 5,
  "image": true,
  "include_sites": [
    "<string>"
  ],
  "exclude_sites": [
    "<string>"
  ],
  "language": "<string>",
  "time_range": "day"
}'
{
  "searchParameters": {
    "query": "<string>",
    "search_service": "google",
    "max_results": 5,
    "crawl_results": 0,
    "image": false,
    "include_sites": [],
    "exclude_sites": [],
    "language": "<string>",
    "time_range": "day"
  },
  "results": [
    {
      "title": "<string>",
      "link": "<string>",
      "snippet": "<string>",
      "content": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
News search parameters

Send a single news search request

​
query
string
required

The query you want to ask

​
search_service
enum<string>

The search service you want to choose

Available options:
google,
bing,
duckduckgo,
yahoo,
hackernews
​
max_results
integer
default:5

The results you want to have

Required range: 1 <= x <= 100
​
crawl_results
integer
default:0

The results you want to crawl

Required range: 0 <= x <= 10
​
image
boolean
default:false

Search including image urls

​
include_sites
string[]

List of websites to include in search results

​
exclude_sites
string[]

List of websites to exclude from search results

​
language
string

The language preference for search results (e.g., 'en', 'zh-CN', 'fr'). Uses standard language codes.

​
time_range
enum<string>

Limit search results to a specific time range

Available options:
day,
month,
year

Response

200
application/json
Successful Response
​
searchParameters
object
​
results
object[]