Story Search

{
    "id": "ursy.news:story-search",
    "summary": "story search over publisher-attributed feed metadata",
    "url": "https://ursy.news/api/v2/search",
    "method": "GET",
    "read_only": true,
    "status": "live",
    "rest_operation": "newsV2search",
    "mcp_tool": "search_news",
    "input_schema": {
        "type": "object",
        "properties": {
            "q": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "x-maxUtf8Bytes": 200,
                "description": "At most 200 UTF-8 bytes after trimming. maxLength is only a character ceiling, not byte validation. Matches retained headline and feed excerpt, not article bodies."
            },
            "limit": {
                "type": "integer",
                "minimum": 1,
                "maximum": 50,
                "default": 20
            },
            "source": {
                "type": "string",
                "enum": [
                    "bbc",
                    "guardian",
                    "sky-news",
                    "financial-times",
                    "bbc-kent",
                    "bbc-sport",
                    "bbc-london",
                    "bbc-manchester",
                    "bbc-scotland",
                    "bbc-wales",
                    "carbon-brief",
                    "mit-tech",
                    "ars",
                    "rest-of-world",
                    "quietus",
                    "positive-news",
                    "nasa",
                    "the-conversation"
                ],
                "maxLength": 80
            },
            "topic": {
                "type": "string",
                "enum": [
                    "business",
                    "climate",
                    "culture",
                    "local",
                    "science",
                    "sport",
                    "technology",
                    "united-kingdom",
                    "world"
                ],
                "maxLength": 80
            },
            "from": {
                "type": "string",
                "format": "date",
                "maxLength": 10,
                "description": "UTC date; from inclusive, to exclusive. Story publication date or event last observation date."
            },
            "to": {
                "type": "string",
                "format": "date",
                "maxLength": 10,
                "description": "UTC date; from inclusive, to exclusive. Story publication date or event last observation date."
            }
        },
        "required": [
            "q"
        ],
        "additionalProperties": false
    },
    "output_schema": {
        "$ref": "https://ursy.news/api/v2/openapi#/components/schemas/Search"
    },
    "content_class": "publisher_feed_metadata",
    "service_id": "ursy.news:news",
    "parent_id": "",
    "name": "Story Search",
    "source_url": "https://ursy.news/.well-known/ursy-capabilities.json",
    "source_type": "capability_manifest",
    "verified_at": "2026-10-15 09:31:56",
    "revision": "f4b8879d308fbee63f4d8d3bcb08ee98be4c2d81e42eee46d017485d2d59eb2c",
    "type": "capabilities",
    "source": {
        "url": "https://ursy.news/.well-known/ursy-capabilities.json",
        "type": "capability_manifest"
    },
    "last_verified_at": "2026-10-15 09:31:56",
    "stale": false
}