OIoilpriceapi
Market Brief

Poll source-evidenced energy news (preview)

Changed on

Preview RSS article feed with source excerpts, revision links and collection health. Page queries use publication windows; since/cursor queries deliver insertion-sequence revisions, including late or undated articles. Source health describes collection, not article completeness. Collection is rollout-gated and may be uninitialized. Event and facility tags are mentions, not measured disruptions or price predictions.

get/v1/context/market/news

Request

  • Base URL
    https://api.oilpriceapi.com
  • Auth
    API key in header Authorization

Query parameters

hoursinteger

Publication window for page queries; ignored during insertion-based polling.

per_pageinteger

Maximum items per page.

pageinteger

One-based page for window queries; incompatible with polling.

commoditystring

Explicit commodity mention code.

regionstring

Explicit region mention.

facilitystring

Explicit facility mention; does not establish operational conditions.

event_type'storage_update' | 'pipeline_constraint' | 'lng_operations' | 'production_update' | 'market_update'

Keyword-classified article topic; does not establish an outage.

sentiment'positive' | 'negative' | 'neutral'

Legacy sentiment filter; incompatible with polling.

summarized'true' | 'false'

Filter for completed or pending summaries; incompatible with polling.

sincestring

Start polling by insertion time. ISO 8601 with timezone; cannot be future or combined with cursor.

cursorstring

Opaque signed continuation from meta.next_cursor. Retain the same filters; incompatible with since.

Response

News evidence and source collection health.

status'success' required

Changes