Search news - Autotouch AI

This page documents the canonical HTTP contract. Switch to the CLI example when you want the operator workflow.

Pricing: 1 credit per 25 returned news items. Credits are charged on actual returned results, not requested limit.

Use this for recent events and intent discovery, not for connected-account LinkedIn activity.

Body parameters

queryrequired
string
News search query.
days_back · optional
integer
Lookback window. Default: 7 days; range: 1–365.
limit · optional
integer
Maximum items to return. Default: 25. Range: 1–100.
page · optional
integer
Page number. Default: 1; must be at least 1.

Name	Type	Description
queryrequired	string	News search query.
days_back	integer	Lookback window. Default: 7 days; range: 1–365.
limit	integer	Maximum items to return. Default: 25. Range: 1–100.
page	integer	Page number. Default: 1; must be at least 1.

Errors

Status	Meaning
400	The search/provider rejected the request.
401	Invalid API key or missing auth.
403	Missing search:run scope.
422	The JSON request does not satisfy the typed request model.

Example

bash

curl -X POST "https://app.autotouch.ai/api/search/news" \
  -H "Authorization: Bearer stk_your_key_id.your_secret" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "device management funding remote teams",
    "limit": 25
  }'

Request body

json

{
  "query": "device management funding remote teams",
  "limit": 25
}

Response example

json

{
  "query": "device management funding remote teams",
  "items": [
    {
      "title": "Acme raises Series B for endpoint security",
      "url": "https://news.example.com/acme-series-b",
      "snippet": "Acme announced a new round focused on endpoint management.",
      "source": "News Example"
    }
  ],
  "total_found": 1,
  "billable_results": 1,
  "credits_used": 1,
  "pricing_rule": "1 credit per 25 results",
  "metadata": {"date_range": null, "date_filter": null, "provider_parameters": null, "page": 1, "requested_num_results": 25, "returned_articles": 1, "has_more": false}
}