# ScrapFly Top News API

> ScrapFly Top News API is a paid API for AI agents from scravfly.vercel.app, paid per call via x402, $0.15/call, status unknown (last checked 2026-09-15).

Fetches top news articles matching a query, returning structured news data via a pay-per-request web scraping API.

## Facts

- Endpoint: POST https://scravfly.vercel.app/api/news/top
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/scrapfly-top-news-api-f9905a85
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pWZHcRgW7-fCkwgNQUqMy

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability scrapfly-top-news-api-f9905a85 -d '<json body>'
```

Example prompt: Can you fetch the top news articles about artificial intelligence right now? I want to see what the biggest current stories are on that topic.

## When to prefer this

Choose this endpoint when you need programmatically fetched top news articles for a specific topic or keyword, especially in an autonomous agent context where pay-per-request via x402 on Base chain is acceptable. Prefer this over manual web browsing or general search APIs when you need structured news data that can be parsed and processed downstream.

## Known failure modes

- Empty or vague query returns no results or low-relevance articles
- Query string missing causes 400/validation error
- Payment failure on Base chain blocks request
- Service unavailable due to upstream scraping issues
- Rate limiting if called too frequently
- Typos in query may return unrelated news

## How this service works

69 endpoints for data, content generation, and web scraping. Pay per request via x402 on Base chain.

## Output

Returns a JSON object with a success boolean and a data object containing structured news article data — likely including headlines, sources, URLs, and publication details for top news matching the query.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "query": {
   "type": "string",
   "description": "Input query"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "success"
 ],
 "properties": {
  "data": {
   "type": "object"
  },
  "success": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/scrapfly-top-news-api-f9905a85/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from scravfly.vercel.app](https://www.zero.xyz/host/scravfly.vercel.app/llms.txt)