Recent News Articles for a Stock

{
  "type": "object",
  "required": [
    "symbol"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max results to return."
    },
    "offset": {
      "type": "integer",
      "description": "Offset for pagination."
    },
    "symbol": {
      "type": "string",
      "description": "Stock symbol (e.g. AAPL)."
    },
    "asset_class": {
      "type": "string",
      "description": "Asset class: stocks, etf, mutualfunds, crypto."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "news": {
          "type": "object",
          "properties": {
            "articles": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "integer",
                    "description": "The provider's internal article id -- useful for deduplicating across paginated calls, not a customer-meaningful value on its own."
                  },
                  "ago": {
                    "type": "string",
                    "description": "Human-readable relative time since publication, e.g. '12 hours ago'."
                  },
                  "url": {
                    "type": "string",
                    "description": "Relative path to the full article, e.g. '/articles/...' -- not a complete, clickable link on its own."
                  },
                  "image": {
                    "type": "string",
                    "description": "Relative path to an article thumbnail image; frequently an empty string when no image is set."
                  },
                  "title": {
                    "type": "string",
                    "description": "The article headline."
                  },
                  "created": {
                    "type": "string",
                    "description": "Publish date as a human-readable string, e.g. 'Sep 6, 2026' -- not an ISO date."
                  },
                  "publisher": {
                    "type": "string",
                    "description": "e.g. 'The Motley Fool', 'MarketBeat', 'Zacks'."
                  },
                  "description": {
                    "type": "string",
                    "description": "A short summary of the article's contents."
                  },
                  "primaryTopic": {
                    "type": "string",
                    "description": "Topic category plus an internal numeric id, e.g. 'Markets|4006'."
                  },
                  "primarySymbol": {
                    "type": "string",
                    "description": "The ticker symbol this article is primarily about, lowercase (e.g. 'aapl'). Observed as an empty string on articles that cover a broader topic rather than one specific company."
                  },
                  "relatedSymbols": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Every ticker symbol the article touches on, including `primarySymbol`, as 'symbol|assetClass' pairs, e.g. 'aapl|stocks', 'btc|crypto'."
                  },
                  "primaryTopicUrl": {
                    "type": "string",
                    "description": "Relative site path for the topic page, e.g. '/topic/markets' -- not a full URL."
                  }
                },
                "additionalProperties": true
              },
              "description": "One entry per matching article, most recent first."
            },
            "totalRecords": {
              "type": "integer",
              "description": "Total number of articles matching the query across all pages, not just this page. Observed as 500 (an apparent unbounded/capped count) on both fixtures."
            }
          },
          "additionalProperties": true
        }
      },
      "additionalProperties": true
    },
    "status": {
      "type": "string",
      "description": "'success' on both fixtures observed."
    }
  },
  "description": "The news record, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": true
}