Skip to content
InsighthreadInsighthread News API
Esc
↑↓navigate↵open⌘Jpreview
Sign in

Fetch news

Returns a page of news articles, newest first. Filter by ticker, event type, or both, and page through results with a cursor.

GET/v1/news
Try it
GEThttps://newsapi.insighthread.com/api/v1/news
Server
Authorization
Parameters
Request
curl -X GET "https://newsapi.insighthread.com/api/v1/news" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
{
  "count": 0,
  "pagination": {
    "next_cursor": "string",
    "has_more": true
  },
  "data": [
    {
      "id": 0,
      "ticker": "string",
      "company_name": "string",
      "event_types": [
        "string"
      ],
      "headline": "string",
      "summary": "string",
      "published_at": "2019-08-24T14:15:22Z",
      "source": {
        "name": "string",
        "url": "string"
      },
      "impact": {
        "direction": "positive",
        "confidence": 0,
        "signal_strength": 0
      },
      "market": {
        "price": 0,
        "change": 0,
        "change_percentage": 0
      }
    }
  ]
}
Authorization
AuthorizationBearer token · headerrequired
An API key, e.g. `Authorization: Bearer ik_test_...` or `Authorization: Bearer ik_live_...`.
Query parameters
limitinteger
Articles per page. Clamped to a maximum of 50.
max 50 · default: 10
cursorstring
Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
event_typestring
Filter to one event category. Accepts a slug (`legal-action`) or the raw label (`Legal Action`). This list is a snapshot — `GET /v1/events` is the live source of truth if a new category isn't listed here yet.
Allowed:Corporate EarningsEarnings Revision GuidanceDividendsStock BuybacksEquity/Debt OfferingsMergers and AcquisitionsMinority Stakes DealsIPO NewsLoans/RevolversDeal TerminationBankruptcy/LiquidationDelistingLegal ActionRegulatory ActionCredit RatingsRestructuringShareholder ActivismTrading UpdateOperations UpdateNew Projects/VenturesDrug UpdatesFDA Approval/RejectionsESGGeopoliticsMarket NewsMining and ExplorationProperty TransactionC-Level ChangeName ChangeStaffing/Adds/CutsInsider Trades
tickerstring
Filter to one or more tickers. Comma-separated for multiple (`AAPL,MSFT`), case-insensitive.
sentimentstring
Filter to one or more impact directions. Comma-separated for multiple (`positive,negative`), case-insensitive.
Allowed:positivenegativeneutral
min_signal_strengthinteger
Filter to a minimum impact strength (the `impact.signal_strength` bar count).
min 1 · max 5
Responses
200A page of news articles.
countinteger
paginationobject
Show properties
next_cursorstring | null
has_moreboolean
dataNewsArticle[]
Show properties
Array of NewsArticle
idinteger
tickerstring | null
company_namestring | null
event_typesstring[]
headlinestring
summarystring | null
published_atstring<date-time>
sourceobject
Show properties
namestring | null
urlstring | null
impactobject
Show properties
directionstring
Allowed:positivenegativeneutral
confidenceinteger
signal_strengthinteger
marketobject
Show properties
pricenumber | null
changenumber | null
change_percentagenumber | null
400A query parameter failed validation (e.g. unknown `event_type`).
errorobject
Show properties
typestring
Allowed:unauthorizedinvalid_requestserver_error
messagestring
401Missing, malformed, or revoked API key.
errorobject
Show properties
typestring
Allowed:unauthorizedinvalid_requestserver_error
messagestring
502Upstream data fetch failed. Safe to retry with backoff.
errorobject
Show properties
typestring
Allowed:unauthorizedinvalid_requestserver_error
messagestring