WebActive

News Search

Search recent news articles by keyword. Returns articles with title, url, source, published_at, and snippet. Sources: HackerNews Algolia (tech) + BBC RSS (general/world). Optional category filter: general/tech/business/science/health/politics. Limit max 30. Use for current events, topic monitoring, or market sentiment.

Endpointx402 Payment Required

POST

https://agentsvc.io/api/v1/proxy/news-search

Price

$0.003 USDC

Latency P99

~1.2s

Provider

agentsvc.io

Input Schema

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query (e.g. 'artificial intelligence', 'climate change 2026', 'Apple earnings')"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "description": "Number of articles to return (default: 10, max: 30)"
    },
    "category": {
      "type": "string",
      "enum": [
        "general",
        "tech",
        "business",
        "science",
        "health",
        "politics"
      ],
      "default": "general",
      "description": "News category filter. 'tech' searches HackerNews for developer/tech news. Others search BBC + general news feeds."
    }
  }
}

Output Schema

{
  "type": "object",
  "required": [
    "query",
    "articles",
    "total_found"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "The search query"
    },
    "articles": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "description": "Article headline"
          },
          "url": {
            "type": "string",
            "description": "Direct link to the article"
          },
          "source": {
            "type": "string",
            "description": "News source name (e.g. 'BBC News', 'Hacker News')"
          },
          "published_at": {
            "type": "string",
            "description": "Publication date/time (ISO 8601 or RFC 2822)"
          },
          "snippet": {
            "type": "string",
            "description": "Short excerpt or description (if available)"
          },
          "score": {
            "type": "integer",
            "description": "Community score/upvotes (HackerNews only)"
          }
        }
      }
    },
    "total_found": {
      "type": "integer",
      "description": "Total number of matching articles found (before limit)"
    },
    "sources_queried": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "News sources that were searched"
    }
  },
  "example": {
    "query": "artificial intelligence",
    "articles": [
      {
        "title": "OpenCode – Open source AI coding agent",
        "url": "https://github.com/opencode-ai/opencode",
        "source": "Hacker News",
        "published_at": "2026-04-10T08:32:00Z",
        "snippet": "",
        "score": 1274
      },
      {
        "title": "AI breakthroughs in 2026: what's next",
        "url": "https://www.bbc.co.uk/news/technology-67890123",
        "source": "BBC News",
        "published_at": "2026-04-10T06:15:00Z",
        "snippet": "Scientists and engineers are pushing the boundaries..."
      }
    ],
    "total_found": 48,
    "sources_queried": [
      "Hacker News",
      "BBC News"
    ]
  }
}

Code Examples

# Step 1: Call without payment → receive 402 with requirements
curl -X POST "https://agentsvc.io/api/v1/proxy/news-search" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "your_query",
  "limit": 10,
  "category": "general"
}'

# Step 2: Sign payment using x402 SDK, then retry
curl -X POST "https://agentsvc.io/api/v1/proxy/news-search" \
  -H "Content-Type: application/json" \
  -H "X-Payment: x402 usdc base <your-signed-payment>" \
  -d '{
  "query": "your_query",
  "limit": 10,
  "category": "general"
}'

News Search

Input Schema

Output Schema

Code Examples

Tags

Service Info