{
  "format": "delx/intent-card/v1",
  "id": "news-search-api",
  "intent": "search recent news headlines with source links",
  "title": "Attributed news search API for agents",
  "description": "Search recent GDELT Project news metadata for $0.001 and receive attributed publisher links without article bodies or arbitrary URL fetching.",
  "keywords": [
    "news search API",
    "recent headlines API",
    "GDELT news metadata",
    "agent research API",
    "attributed news links"
  ],
  "updated_at": "2026-08-01",
  "canonical_url": "https://commerce.delx.ai/intents/news-search-api",
  "machine_url": "https://commerce.delx.ai/intents/news-search-api.json",
  "recommendation": {
    "tool_name": "search_news_gdelt",
    "service_name": "Delx GDELT News Search",
    "method": "POST",
    "resource": "https://api.delx.ai/api/v1/x402/news-search",
    "price_usdc": "0.001",
    "payment_protocols": [
      "x402",
      "mpp"
    ],
    "input_schema": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200,
          "description": "News query, 1-200 characters."
        },
        "timespan": {
          "type": "string",
          "enum": [
            "1h",
            "3h",
            "6h",
            "12h",
            "1d",
            "3d",
            "7d",
            "30d"
          ],
          "default": "1d"
        },
        "sort": {
          "type": "string",
          "enum": [
            "datedesc",
            "rel",
            "hybridrel"
          ],
          "default": "datedesc"
        },
        "max_records": {
          "type": "integer",
          "minimum": 1,
          "maximum": 10,
          "default": 10
        },
        "timeout": {
          "type": "integer",
          "minimum": 2,
          "maximum": 8,
          "default": 8
        }
      },
      "required": [
        "query"
      ],
      "additionalProperties": false
    },
    "example_input": {
      "query": "artificial intelligence",
      "timespan": "1d",
      "sort": "datedesc",
      "max_records": 3
    },
    "example_output": {
      "tool_name": "search_news_gdelt",
      "result": {
        "schema": "delx/news-search/v1",
        "query": "artificial intelligence",
        "timespan": "1d",
        "sort": "datedesc",
        "max_records": 3,
        "count": 1,
        "articles": [
          {
            "title": "Example headline",
            "url": "https://example.com/story",
            "seendate": "20260801T120000Z",
            "domain": "example.com"
          }
        ],
        "provider": "GDELT Project",
        "provider_url": "https://www.gdeltproject.org/",
        "attribution": "News metadata supplied by the GDELT Project; article rights remain with each publisher.",
        "cache": "miss"
      }
    },
    "agentcash": {
      "buy": "npx agentcash@latest fetch https://api.delx.ai/api/v1/x402/news-search -m POST -H 'x-delx-source: intent-card-news-search-api' --max-amount 0.001 -b '{\"query\":\"artificial intelligence\",\"timespan\":\"1d\",\"sort\":\"datedesc\",\"max_records\":3}'",
      "max_amount_usdc": "0.001"
    }
  },
  "attribution": {
    "header": "x-delx-source",
    "value": "intent-card-news-search-api"
  },
  "evidence": {
    "paid_openapi": "https://api.delx.ai/openapi.x402.json",
    "governed_portfolio": "https://api.delx.ai/x402-portfolio.json",
    "live_contract": "https://api.delx.ai/api/v1/x402/news-search"
  }
}