{
  "title": "Commerce.gov News Article Structure",
  "description": "Documentation of the data structure for news articles returned by the Commerce.gov Content API",
  "type": "object",
  "fields": [
    {
      "name": "id",
      "type": "string",
      "required": true,
      "description": "Unique identifier of the news article assigned by the CMS",
      "example": "12345"
    },
    {
      "name": "title",
      "type": "string",
      "required": true,
      "description": "Full title of the news article as published on Commerce.gov",
      "example": "Commerce Department Announces New Trade Partnership"
    },
    {
      "name": "body",
      "type": "string",
      "required": false,
      "description": "Full HTML body content of the article including all paragraphs, links, and formatting",
      "example": "<p>The U.S. Department of Commerce announced today...</p>"
    },
    {
      "name": "summary",
      "type": "string",
      "required": false,
      "description": "Short teaser summary for display in article listings",
      "example": "The Commerce Department announced a new bilateral trade partnership."
    },
    {
      "name": "created",
      "type": "string",
      "format": "date-time",
      "required": true,
      "description": "ISO 8601 timestamp when the article was originally published",
      "example": "2026-04-28T14:30:00Z"
    },
    {
      "name": "changed",
      "type": "string",
      "format": "date-time",
      "required": false,
      "description": "ISO 8601 timestamp when the article was last modified",
      "example": "2026-04-28T16:00:00Z"
    },
    {
      "name": "url",
      "type": "string",
      "required": false,
      "description": "Relative URL path to the full article on Commerce.gov",
      "example": "/news/2026/04/commerce-department-announces-new-trade-partnership"
    },
    {
      "name": "field_image",
      "type": "string",
      "required": false,
      "description": "Absolute URL to the featured image for the article",
      "example": "https://www.commerce.gov/sites/default/files/trade-partnership.jpg"
    },
    {
      "name": "tags",
      "type": "array",
      "items": "string",
      "required": false,
      "description": "List of topic tags categorizing the article's subject matter",
      "example": ["Trade", "International", "Exports"]
    }
  ],
  "pagination": {
    "description": "List responses wrap article arrays in a data object with pagination metadata",
    "fields": [
      {
        "name": "total",
        "type": "integer",
        "description": "Total number of articles available"
      },
      {
        "name": "page",
        "type": "integer",
        "description": "Current page number (0-indexed)"
      },
      {
        "name": "items_per_page",
        "type": "integer",
        "description": "Number of items returned per page"
      }
    ]
  }
}