Back to catalog

Newsdata Io · News

NewsData.io API / Register a real-time query

Registers a standing query for the real-time WebSocket stream and returns its registrationid. Use that id to connect to the stream at wss://ws.newsdata.io/ws/event and to manage the registration with /1/websocket/fetch and /1/websocket/delete. Available on plans with WebSocket access. At least one of the following parameters is required: q, qInTitle, qInMeta, country, category, language, domain, domainurl, prioritydomain, image, video, fullcontent. Registering the exact same set of parameters again returns 409 with the existing registration_id. Each account can keep a limited number of active registrations at a time (set by your plan); requests beyond the limit return 429. Registering consumes no API credits, but requires at least 1 API credit remaining. Each article later delivered over the WebSocket stream consumes 1 API credit per connected device.

Private Gateway connection

Data below comes from the configured private Gateway. Provider activation remains governed by its evidence and policy gates.

unverifiedRequest shape unavailableUnverified
Published API evidence
Public metadata only. Response bodies, credentials, and internal review notes are never displayed.

No verification date is claimed. No response capture is claimed.

Request parameters

  • category query · optional
  • country query · optional
  • creator query · optional
  • datatype query · optional
  • domain query · optional
  • domainurl query · optional
  • excludecategory query · optional
  • excludecountry query · optional
  • excludedomain query · optional
  • excludefield query · optional
  • excludelanguage query · optional
  • full_content query · optional
  • image query · optional
  • language query · optional
  • organization query · optional
  • prioritydomain query · optional
  • q query · optional
  • qInMeta query · optional
  • qInTitle query · optional
  • region query · optional
  • removeduplicate query · optional
  • sentiment query · optional
  • sentiment_score query · optional
  • tag query · optional
  • timezone query · optional
  • video query · optional
Provider docs How to run it

Sign in to run this operation, inspect live eligibility, and see governed execution and audit evidence. Sign in.

NewsData.io API / Register a real-time query · looot