Skip to main content
POST
/
api
/
v1
/
news
/
global
Search global coverage for a topic.
finterm tool global_news_search --query "Apple earnings"
{
  "finterm": {
    "schema": "<string>",
    "tool": "<string>",
    "args": {},
    "request_id": "<string>",
    "cursor": "<string>"
  },
  "data": {
    "articles": [
      {
        "title": "<string>",
        "url": "<string>",
        "seen_at": "<string>"
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

A live account API key from FINTERM_API_KEY.

Body

application/json
query
string
required

Search query string

mode
enum<string>

Search mode

Available options:
ArtList,
TimelineVol,
TimelineTone,
TimelineSourceCountry
timespan
string

Search timespan, such as 7d or 24h

max_records
integer

Maximum records to return

Required range: 1 <= x <= 250
start_datetime
string

Start datetime in YYYYMMDDhhmmss format

end_datetime
string

End datetime in YYYYMMDDhhmmss format

Response

Success.

The two-key success envelope.

finterm
object
required

Canonical result meta header.

data
object
required