# The Verge API

> The Verge returns story headlines and searchable articles as a workflow and API.

List headlines returns stories in selected section order and needs a section and maximum result count. Search news returns keyword-matched articles and needs search words; date filters, sorting, and pagination are optional.

- Page: https://fous.com/tools/the-verge
- Handle: `@the-verge`
- Category: [News](https://fous.com/tools/category/news)
- Source website: https://theverge.com
- Last verified: Sep 29, 2026

## Methods

### List headlines

Operation `list_headlines`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

List The Verge story headlines in the order shown on the selected section page, including quick posts. Older archive pages are included when needed for the requested count; only public The Verge stories are returned.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `section` | string | no | `"tech"` | News section to browse, for example tech. |
| `max_results` | integer | no | `20` | Maximum number of stories, for example 20. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "section": {
      "enum": [
        "latest",
        "tech",
        "reviews",
        "science",
        "entertainment",
        "ai",
        "policy"
      ],
      "type": "string",
      "default": "latest",
      "description": "News section to browse, for example tech.",
      "examples": [
        "tech",
        "latest",
        "ai"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum number of stories, for example 20.",
      "x-fous-developer": true,
      "examples": [
        20,
        50,
        12
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "section": "tech",
      "max_results": 20
    },
    {
      "section": "latest",
      "max_results": 50
    },
    {
      "section": "ai",
      "max_results": 12
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `stories` | array |  | Stories in the order displayed on the section page. |
| `stories[].authors` | array |  | Story authors. |
| `stories[].section` | string or null | `"Tech"` | Story section. |
| `stories[].summary` | string or null | `"Alongside solid ANC, the Nothing Headphone 1 Pro include a triple-driver design and a unique switch for studios pros."` | Displayed story summary, if any. |
| `stories[].headline` | string | `"Nothing’s new flagship Headphone 1 Pro put you in the studio"` | Displayed story headline. |
| `stories[].image_url` | string or null | `"https://platform.theverge.com/wp-content/uploads/sites/2/2026/09/268785_Nothing_pro_1_headphones_JHIGGINS_1.jpg?quality` | Story image link, if shown. |
| `stories[].article_url` | string | `"https://www.theverge.com/tech/1001797/nothings-headphone-1-pro-review"` | The Verge article link. |
| `stories[].published_at` | string or null | `"2026-09-29T01:00:00+00:00"` | Published date and time with UTC offset, if shown. |

**Example input**

```json
{
  "section": "tech",
  "max_results": 20
}
```

**Example output**

```json
{
  "stories": [
    {
      "authors": [
        "John Higgins"
      ],
      "section": "Tech",
      "summary": "Alongside solid ANC, the Nothing Headphone 1 Pro include a triple-driver design and a unique switch for studios pros.",
      "headline": "Nothing’s new flagship Headphone 1 Pro put you in the studio",
      "image_url": "https://platform.theverge.com/wp-content/uploads/sites/2/2026/09/268785_Nothing_pro_1_headphones_JHIGGINS_1.jpg?quality=90&strip=all&crop=0,0,100,100",
      "article_url": "https://www.theverge.com/tech/1001797/nothings-headphone-1-pro-review",
      "published_at": "2026-09-29T01:00:00+00:00"
    },
    {
      "authors": [
        "Jay Peters"
      ],
      "section": "Tech",
      "summary": "World Labs’ co-founder and CEO will become AMD’s chief scientist.",
      "headline": "AMD is acquiring AI company World Labs in a deal worth more than $8 billion",
      "image_url": "https://platform.theverge.com/wp-content/uploads/sites/2/2026/09/gettyimages-2279092788.jpg?quality=90&strip=all&crop=0.012500000000003,0,99.975,100",
      "article_url": "https://www.theverge.com/tech/1001749/amd-world-labs-ai-acquisition-deal",
      "published_at": "2026-09-28T21:31:35+00:00"
    },
    {
      "authors": [
        "Emma Roth"
      ],
      "section": "AI",
      "summary": null,
      "headline": "Mozilla targets tech CEOs in NYC ad campaign.",
      "image_url": null,
      "article_url": "https://www.theverge.com/ai-artificial-intelligence/1001760/mozilla-targets-tech-ceos-in-nyc-ad-campaign",
      "published_at": "2026-09-28T22:14:25+00:00"
    }
  ]
}
```

### Search news

Operation `search_news`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Search The Verge articles by keyword, with date filters, sorting and pagination. Results are limited to the first 100 matches available from The Verge search; date filters and newest sorting apply within those matches.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `page` | integer | no | `2` | Page of the filtered and sorted results, for example 2. |
| `sort` | string | no | `"most_relevant"` | Order results by publication date or search relevance, for example newest. |
| `query` | string | yes | `"Tesla"` | Words to search in The Verge articles, for example Tesla. |
| `to_date` | string | no | `"2026-09-29"` | Latest publication date to include, for example 2026-09-29. |
| `from_date` | string | no | `"2026-01-01"` | Earliest publication date to include, for example 2026-01-01. |
| `max_results` | integer | no | `5` | Number of articles per page, for example 20. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page of the filtered and sorted results, for example 2.",
      "x-fous-developer": true,
      "examples": [
        2
      ]
    },
    "sort": {
      "enum": [
        "newest",
        "most_relevant"
      ],
      "type": "string",
      "default": "newest",
      "description": "Order results by publication date or search relevance, for example newest.",
      "examples": [
        "most_relevant"
      ]
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Words to search in The Verge articles, for example Tesla.",
      "examples": [
        "Tesla",
        "Apple"
      ]
    },
    "to_date": {
      "type": "string",
      "format": "date",
      "description": "Latest publication date to include, for example 2026-09-29.",
      "examples": [
        "2026-09-29"
      ]
    },
    "from_date": {
      "type": "string",
      "format": "date",
      "description": "Earliest publication date to include, for example 2026-01-01.",
      "examples": [
        "2026-01-01"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Number of articles per page, for example 20.",
      "x-fous-developer": true,
      "examples": [
        5
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "page": 2,
      "sort": "most_relevant",
      "query": "Tesla",
      "max_results": 5
    },
    {
      "query": "Tesla"
    },
    {
      "query": "Apple",
      "to_date": "2026-09-29",
      "from_date": "2026-01-01",
      "max_results": 5
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `articles` | array |  |  |
| `articles[].link` | string | `"https://www.theverge.com/2017/9/22/16347986/kid-reviews-tesla-model-x"` |  |
| `articles[].authors` | string or null | `"Benicio Quinones"` |  |
| `articles[].section` | string or null | `"Transportation"` |  |
| `articles[].summary` | string or null | `"‘Try to beg your parents to let you go fast in the car’"` |  |
| `articles[].headline` | string | `"A nine-year-old reviews the Tesla Model X"` |  |
| `articles[].published_at` | string | `"2017-09-22T16:00:17+00:00"` |  |

**Example input**

```json
{
  "page": 2,
  "sort": "most_relevant",
  "query": "Tesla",
  "max_results": 5
}
```

**Example output**

```json
{
  "articles": [
    {
      "link": "https://www.theverge.com/2017/9/22/16347986/kid-reviews-tesla-model-x",
      "authors": "Benicio Quinones",
      "section": "Transportation",
      "summary": "‘Try to beg your parents to let you go fast in the car’",
      "headline": "A nine-year-old reviews the Tesla Model X",
      "published_at": "2017-09-22T16:00:17+00:00"
    },
    {
      "link": "https://www.theverge.com/transportation/992014/tesla-cybercab-hands-on-test-robotaxi-austin",
      "authors": "Mack DeGeurin",
      "section": "Transportation",
      "summary": "Would you ride in a Tesla Cybercab?",
      "headline": "I spent an hour riding inside Tesla’s steering-wheel-free Cybercab",
      "published_at": "2026-09-09T14:41:07+00:00"
    },
    {
      "link": "https://www.theverge.com/2021/10/20/22736859/tesla-q3-earnings-profit-chip-shortage-sales-elon-musk",
      "authors": "Sean O'Kane",
      "section": "Tesla",
      "summary": "The company netted $1.6 billion in the third quarter.",
      "headline": "Tesla bucks chip shortage woes with another profitable quarter",
      "published_at": "2021-10-20T20:17:54+00:00"
    }
  ]
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@the-verge",
  "visibility": "public",
  "operation": "list_headlines",
  "version": 1,
  "input": {
    "section": "tech",
    "max_results": 20
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@the-verge\",\n  \"visibility\": \"public\",\n  \"operation\": \"list_headlines\",\n  \"version\": 1,\n  \"input\": {\n    \"section\": \"tech\",\n    \"max_results\": 20\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@the-verge",
  "visibility": "public",
  "operation": "list_headlines",
  "version": 1,
  "input": {
    "section": "tech",
    "max_results": 20
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/the-verge`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `list_headlines`: List headlines. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `search_news`: Search news. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-the-verge https://api.fous.com/mcp/tools/the-verge --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Track headlines across selected news sections
- Find articles about a company or topic
- Review articles published within a date range
- Compare story headlines, authors, and sections

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this The Verge tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a The Verge account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from theverge.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

### What headlines appear in a particular section?

List headlines returns stories in the selected section's displayed order. Provide a section and maximum result count.

### Which articles mention a particular keyword?

Search news finds articles matching the required search words. You can also set date filters, sorting, and pagination.

### Who wrote an article, and when was it published?

Search news returns article authors and publication dates. List headlines also includes authors and publication dates when shown.

## Related

- [The Wall Street Journal API](https://fous.com/tools/the-wall-street-journal.md): The Wall Street Journal provides news-section headlines and searchable public article headlines and summaries, with available story details and publication dates for search filtering.
- [The New York Times API](https://fous.com/tools/the-new-york-times.md): The New York Times provides current section headlines and summaries, keyword-matched public listings with dates, authors, sections and links, and Best Sellers lists for the latest issue or dates within a week.
- [CNN API](https://fous.com/tools/cnn.md): CNN provides section-page headlines and searchable public articles, plus article text; subscriber stories show only a brief public preview, and live blogs include entries.
- [NPR API](https://fous.com/tools/npr.md): NPR returns displayed section headlines, searchable articles with summaries and publication details, and available article text; date-filtered searches may miss older stories edited much later.
- [The Guardian API](https://fous.com/tools/the-guardian.md): The Guardian provides news, sport, culture and opinion, ordered headlines, keyword-search results that may omit older or less prominent stories, and article details with available text; live blogs show the latest entries.
- [TechCrunch API](https://fous.com/tools/techcrunch.md): TechCrunch returns latest section headlines, keyword search results of up to 50 articles per page, public article text with available live updates, and recent startup funding stories with clearly announced amounts.
- [AP News API](https://fous.com/tools/ap-news.md): AP News provides reporting, up to 50 public-page headlines, searchable articles visible in its search, and full text when accessible.
- [Fox News API](https://fous.com/tools/fox-news.md): Fox News returns section-page headlines, keyword-matched articles among up to 100 available results, and readable article text, including the latest live-blog updates.
- [All News tools](https://fous.com/tools/category/news)