x402.professorsausages.com

{
  "properties": {
    "articles": {
      "description": "The matched articles themselves (title + url, newest first, capped at 50) — so a timeline hit is reachable, not just a count.",
      "items": {
        "properties": {
          "categories": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "country": {
            "type": [
              "string",
              "null"
            ]
          },
          "domain": {
            "type": "string"
          },
          "feed": {
            "description": "Human feed label, e.g. \"BBC World\", \"Hacker News\", \"GDELT: technology\".",
            "type": "string"
          },
          "id": {
            "description": "sha1(normalized url) hex, first 16 chars — the dedupe key.",
            "type": "string"
          },
          "lang": {
            "description": "ISO-639-1 language, best-effort.",
            "type": [
              "string",
              "null"
            ]
          },
          "published": {
            "description": "ISO-8601 publish time (best-effort).",
            "type": "string"
          },
          "seen_at": {
            "type": "string"
          },
          "source": {
            "enum": [
              "gdelt",
              "hn",
              "rss",
              "gnews",
              "sitemap"
            ],
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "tone": {
            "description": "GDELT article tone; null for every non-GDELT source.",
            "type": [
              "number",
              "null"
            ]
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "url",
          "domain",
          "source",
          "feed",
          "published",
          "categories",
          "seen_at"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "bucket": {
      "enum": [
        "hour",
        "day"
      ],
      "type": "string"
    },
    "buckets": {
      "items": {
        "properties": {
          "avg_tone": {
            "description": "Mean GDELT tone of matching articles in the bucket, or null.",
            "type": [
              "number",
              "null"
            ]
          },
          "count": {
            "type": "integer"
          },
          "t": {
            "description": "Bucket start (ISO date or ISO hour).",
            "type": "string"
          }
        },
        "required": [
          "t",
          "count"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "freshness": {
      "properties": {
        "as_of": {
          "description": "updated_at of the corpus this response was served from.",
          "type": "string"
        },
        "source_count": {
          "description": "Number of sources with ≥1 article in the current pile.",
          "type": "integer"
        },
        "window_hours": {
          "type": "integer"
        }
      },
      "required": [
        "as_of",
        "window_hours",
        "source_count"
      ],
      "type": "object"
    },
    "query": {
      "type": "string"
    },
    "returned": {
      "description": "How many matched articles are included in `articles` (capped at 50).",
      "type": "integer"
    },
    "terms": {
      "additionalProperties": {
        "type": "integer"
      },
      "description": "How many articles contain each individual query term/phrase — explains why an AND of several terms returns few/none.",
      "type": "object"
    },
    "total": {
      "description": "Total matched articles (the true count the buckets sum to).",
      "type": "integer"
    }
  },
  "required": [
    "query",
    "bucket",
    "total",
    "returned",
    "buckets",
    "articles",
    "terms",
    "freshness"
  ],
  "type": "object"
}