# 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/workflows/the-verge
- Handle: `@the-verge`
- Category: [News](https://fous.com/workflows/category/news)
- Source website: https://theverge.com
- Last verified: Sep 29, 2026
- Fous is not affiliated with The Verge.

## Methods

### List headlines

Operation `list_headlines`, version 1. 1 credit per call.

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 call.

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

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_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.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

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=120) 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.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_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);
```

Or describe the data in plain language: send `{"api":"@the-verge","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

## 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

### Is Fous affiliated with The Verge?

No. Fous is not affiliated with The Verge. This workflow reads the public theverge.com website and returns its data.

### How much does it cost?

Each run costs 1 credit. 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; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check 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/workflows/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/workflows/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/workflows/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/workflows/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/workflows/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/workflows/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/workflows/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/workflows/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 workflows](https://fous.com/workflows/category/news)