# The Verge API: List headlines

> Lists The Verge story headlines, including quick posts, in the order shown on a section page. Archive pages are added when more stories are needed.

Unofficial. Not affiliated with or endorsed by The Verge.

- Page: https://fous.com/methods/theverge.com/list-headlines
- Method: `theverge.com/list_headlines`, version 1
- Website: theverge.com
- Returns: headline, summary, published time, authors, section, image, article URL
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `section` | string | no | `"tech"` | News section to browse, for example tech. One of "latest", "tech", "reviews", "science", "entertainment", "ai", "policy". Default "latest". |
| `max_results` | integer | no | `20` | Maximum number of stories, for example 20. Default 20. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

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

Its output:

```json
{
  "stories": [
    {
      "authors": [
        "Jay Peters"
      ],
      "section": "Tech",
      "summary": "Etsy’s new AI policies, among other changes, require that a listing’s first photo is unedited.",
      "headline": "Etsy is cracking down on AI slop listings",
      "image_url": "https://platform.theverge.com/wp-content/uploads/sites/2/2026/10/Screenshot-2026-10-22-at-5.03.44-PM.png?quality=90&strip=all&crop=1.4741620111732,0,97.051675977654,82.725656291205",
      "article_url": "https://www.theverge.com/tech/1017261/etsy-ai-rules-policies-restrictions-listing",
      "published_at": "2026-10-23T00:09:58+00:00"
    },
    {
      "authors": [
        "Sean Hollister"
      ],
      "section": "Gaming",
      "summary": "Didn’t Microsoft say the next Xbox needed to be affordable?",
      "headline": "The next-gen Xbox won’t cost you $1,800. It can’t. Can it?",
      "image_url": "https://platform.theverge.com/wp-content/uploads/sites/2/chorus/uploads/chorus_asset/file/23516635/adbenedetto_220508_5192_0047.jpg?quality=90&strip=all&crop=0,0,100,100",
      "article_url": "https://www.theverge.com/games/1016134/xbox-helix-price-1800-isnt-affordable-editorial",
      "published_at": "2026-10-22T23:00:00+00:00"
    },
    {
      "authors": [
        "Jess Weatherbed"
      ],
      "section": "Tech",
      "summary": null,
      "headline": "The Duo makes its Apple Store debut.",
      "image_url": null,
      "article_url": "https://www.theverge.com/tech/1017316/the-duo-makes-its-apple-store-debut",
      "published_at": "2026-10-23T08:39:23+00:00"
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"theverge.com/list_headlines","input":{"section":"tech","max_results":20}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Show me the latest 15 headlines from the AI section with their summaries and authors
- What are the newest 20 stories in the policy section, with publish times and article links?
- Give me 10 headlines from the reviews section including images and bylines
- List the most recent science stories on theverge.com, up to 25 of them, in page order
- I need the top 8 tech headlines right now with short summaries and when each was published

## Input schema

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

## Output schema

```json
{
  "type": "object",
  "required": [
    "stories"
  ],
  "properties": {
    "stories": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "headline",
          "authors",
          "article_url"
        ],
        "properties": {
          "authors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "section": {
            "type": [
              "string",
              "null"
            ]
          },
          "summary": {
            "type": [
              "string",
              "null"
            ]
          },
          "headline": {
            "type": "string"
          },
          "image_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "article_url": {
            "type": "string"
          },
          "published_at": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    }
  }
}
```

## See more

- [The Verge API: Search news](https://fous.com/methods/theverge.com/search-news.md): Searches The Verge articles by keyword, with optional date filters, sorting and pagination. Only the first 100 matches from The Verge search are used.
- [TechCrunch API: List headlines](https://fous.com/methods/techcrunch.com/list-headlines.md): Lists the latest TechCrunch story headlines in a section, in page order. Skips video, podcast and event promotion cards.
- [BBC News API: List headlines](https://fous.com/methods/bbc.com/list-headlines.md): Lists the article headlines shown on a BBC News section page, in page order, with summary, publish time, authors, image and link.
- [The Guardian API: List headlines](https://fous.com/methods/theguardian.com/list-headlines.md): Lists the stories on a Guardian section front (top stories, world, UK, US, business, environment, technology, sport or culture) in page order, with the summary and image shown on the front, the publication time (as displayed, else from the story page), and each story's section and authors from its page.
- [NPR API: List headlines](https://fous.com/methods/npr.org/list-headlines.md): Lists the headlines on an NPR section page in page order, with summaries, publication times, authors, images and article links.
- [CNN API: List headlines by section](https://fous.com/methods/cnn.com/list-headlines.md): Lists CNN headlines in the order shown on a chosen news section page (top stories, US, world, politics, business, health, entertainment or science), with each story's summary, publication time, authors and image when available. Promotions and video-only items are left out.
- [Fox News API: List headlines](https://fous.com/methods/foxnews.com/list-headlines.md): Lists Fox News article headlines in the order shown on a news section page. Video-only items, ads and promotions are left out.
- [wsj.com API: List Wall Street Journal section headlines](https://fous.com/methods/wsj.com/list-headlines.md): Lists the headlines shown in a Wall Street Journal news section (top stories, business, markets, tech, economy, world, politics or personal finance) with summaries, bylines, dates, images and story links.
- [All The Verge methods](https://fous.com/methods/theverge.com.md)
