# AP News API

> AP News returns headlines, search results, and article details, available as a workflow and API.

AP News (AP) returns section headlines, summaries, and story details with List headlines; provide a section and optional result limit. Search news returns matching articles; provide search words and optionally publication dates, sort order, result page, and page size. Read article returns text and details for one public story; provide its article link or headline.

- Page: https://fous.com/workflows/ap-news
- Handle: `@ap-news`
- Category: [News](https://fous.com/workflows/category/news)
- Source website: https://apnews.com
- Last verified: Sep 28, 2026
- Fous is not affiliated with AP News.

## Methods

### List headlines

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

List AP News headlines in the order shown on a public news section page, up to 50 stories. Article credits may be unavailable for later stories in long lists.

**Input**

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

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "section": {
      "enum": [
        "top stories",
        "U.S. news",
        "world",
        "politics",
        "business",
        "sports",
        "entertainment",
        "science",
        "health"
      ],
      "type": "string",
      "default": "top stories",
      "description": "News section to list, for example world.",
      "examples": [
        "world",
        "top stories",
        "sports"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum number of stories to return, for example 20.",
      "x-fous-developer": true,
      "examples": [
        5,
        4,
        3
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "section": "world",
      "max_results": 5
    },
    {
      "section": "top stories",
      "max_results": 4
    },
    {
      "section": "sports",
      "max_results": 3
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `stories` | array |  | AP News stories in the order displayed on the section page. |
| `stories[].authors` | array |  | Credited author names, if available. |
| `stories[].section` | string | `"World News"` | Article news section. |
| `stories[].summary` | string or null | `"Police are holding five men and examining suspected explosives found near a U.S.-operated air force base in England."` | Short summary shown on the section page, if any. |
| `stories[].headline` | string | `"British police investigate whether arrests near US-run air base foiled an Iran-linked attack"` | Headline as shown on the section page. |
| `stories[].image_url` | string or null | `"https://dims.apnews.com/dims4/default/85538a0/2147483647/strip/true/crop/7151x4767+0+0/resize/727x485!/quality/90/?url=` | Image link shown in the story card, if any. |
| `stories[].article_url` | string | `"https://apnews.com/article/uk-fairford-us-air-base-arrests-investigation-4b6fb8b4636c0c360bd7d3d2c44e8075"` | Link to the AP News article. |
| `stories[].published_at` | string or null | `"2026-09-28T08:11:42+00:00"` | Publication date and time with time zone when displayed on the section page. |

**Example input**

```json
{
  "section": "world",
  "max_results": 5
}
```

**Example output**

```json
{
  "stories": [
    {
      "authors": [
        "Alastair Grant"
      ],
      "section": "World News",
      "summary": "Police are holding five men and examining suspected explosives found near a U.S.-operated air force base in England.",
      "headline": "British police investigate whether arrests near US-run air base foiled an Iran-linked attack",
      "image_url": "https://dims.apnews.com/dims4/default/85538a0/2147483647/strip/true/crop/7151x4767+0+0/resize/727x485!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F4f%2Fd7%2F77426b7eb1c04113a1aeeee36e71%2Fe39a70…",
      "article_url": "https://apnews.com/article/uk-fairford-us-air-base-arrests-investigation-4b6fb8b4636c0c360bd7d3d2c44e8075",
      "published_at": "2026-09-28T08:11:42+00:00"
    },
    {
      "authors": [
        "Claudia Ciobanu",
        "Rafal Niedzielski"
      ],
      "section": "World News",
      "summary": null,
      "headline": "Residents brace for a possible Russian hybrid attack on Poland’s border with Ukraine",
      "image_url": "https://dims.apnews.com/dims4/default/6afedee/2147483647/strip/true/crop/1592x1062+0+0/resize/599x400!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F27%2F1f%2F281ef1b4f8975a6e7a52fa70c266%2F72ba61…",
      "article_url": "https://apnews.com/article/poland-russia-hybrid-war-attack-civil-defense-border-9430977473b06c8d6285fe95608e6f9b",
      "published_at": "2026-09-28T08:15:10+00:00"
    }
  ]
}
```

### Read article

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

Read the full text and details of one public AP News article from its link or headline. Headline searches use the closest visible AP News result; articles without accessible text may have no paragraphs.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `article` | string | yes | `"https://apnews.com/article/california-san-clemente-beach-erosion-rail-1843fb400da08a60aa6a9082279c04cf"` | AP News article link or headline, for example https://apnews.com/article/california-san-clemente-beach-erosion-rail-1843fb400da08a60aa6a9082279c04cf. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "article"
  ],
  "properties": {
    "article": {
      "type": "string",
      "description": "AP News article link or headline, for example https://apnews.com/article/california-san-clemente-beach-erosion-rail-1843fb400da08a60aa6a9082279c04cf.",
      "examples": [
        "https://apnews.com/article/california-san-clemente-beach-erosion-rail-1843fb400da08a60aa6a9082279c04cf",
        "https://apnews.com/live/top-25-college-football-poll-9-27-2026",
        "Police arrest 5 men near UK air base on suspicion of terrorism offences"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "article": "https://apnews.com/article/california-san-clemente-beach-erosion-rail-1843fb400da08a60aa6a9082279c04cf"
    },
    {
      "article": "https://apnews.com/live/top-25-college-football-poll-9-27-2026"
    },
    {
      "article": "Police arrest 5 men near UK air base on suspicion of terrorism offences"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `tags` | array |  |  |
| `authors` | array |  |  |
| `section` | string or null | `"U.S. News"` |  |
| `summary` | string or null |  |  |
| `headline` | string | `"Sea level rise is reshaping a California beach town and threatening a key rail line"` |  |
| `article_id` | string or null | `"1843fb400da08a60aa6a9082279c04cf"` |  |
| `paragraphs` | array |  |  |
| `updated_at` | string or null | `"2026-09-27T12:29:20+00:00"` | Last-updated date and time in ISO 8601 with offset. |
| `word_count` | integer | `879` |  |
| `article_url` | string | `"https://apnews.com/article/california-san-clemente-beach-erosion-rail-1843fb400da08a60aa6a9082279c04cf"` |  |
| `published_at` | string or null | `"2026-09-27T10:06:00+00:00"` | Publication date and time in ISO 8601 with offset. |
| `main_image_url` | string or null | `"https://dims.apnews.com/dims4/default/d9fc0f1/2147483647/strip/false/crop/5616x3744+0+0/resize/980x653!/quality/90/?url` |  |
| `main_image_caption` | string or null | `"A couple hug at North Beach as crumbling seaside bluffs are seen behind them in San Clemente, Calif., Friday, Sept. 18,` |  |
| `full_text_available` | boolean | `true` |  |

**Example input**

```json
{
  "article": "https://apnews.com/article/california-san-clemente-beach-erosion-rail-1843fb400da08a60aa6a9082279c04cf"
}
```

**Example output**

```json
{
  "tags": [
    "Oceans",
    "General news",
    "AP Top News"
  ],
  "authors": [
    "Amy Taxin"
  ],
  "section": "U.S. News",
  "summary": "The beach in this small Southern California community has been shrinking due to rising ocean waters. San Clemente's North Beach is now split and officials have used rocks to shore up a seaside rail li…",
  "headline": "Sea level rise is reshaping a California beach town and threatening a key rail line",
  "article_id": "1843fb400da08a60aa6a9082279c04cf",
  "paragraphs": [
    "SAN CLEMENTE, Calif. (AP) — For years, residents of this Southern California beach town could walk a mile along a stretch of cream-colored sand and dip their toes in the waves lapping ashore.",
    "That trip has been cut short.",
    "Coastal erosion has been eating away at the beach in San Clemente, known for nearly a century as a “Spanish village by the sea.” The rising sea and crashing waves have pushed the shoreline landward, s…"
  ],
  "updated_at": "2026-09-27T12:29:20+00:00",
  "word_count": 879,
  "article_url": "https://apnews.com/article/california-san-clemente-beach-erosion-rail-1843fb400da08a60aa6a9082279c04cf",
  "published_at": "2026-09-27T10:06:00+00:00",
  "main_image_url": "https://dims.apnews.com/dims4/default/d9fc0f1/2147483647/strip/false/crop/5616x3744+0+0/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F0f%2F28%2Fccead5f7ad9f311f6329cc0454a4%2F8c36c…",
  "main_image_caption": "A couple hug at North Beach as crumbling seaside bluffs are seen behind them in San Clemente, Calif., Friday, Sept. 18, 2026. (AP Photo/Jae C. Hong)",
  "full_text_available": true
}
```

### Search news

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

Search AP News articles by keyword, with optional publication dates, sort order, and result page. Results are limited to articles visible in AP News search.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `page` | integer | no | `2` | Result page number starting at 1, for example 2. |
| `sort` | string | no | `"most_relevant"` | Order results by newest publication or search relevance; for example newest. |
| `query` | string | yes | `"Microsoft"` | Words to search for, for example Tesla. |
| `to_date` | string | no | `"2026-09-28"` | Latest publication date, inclusive, for example 2026-09-28. |
| `from_date` | string | no | `"2026-09-01"` | Earliest publication date, inclusive, for example 2026-09-01. |
| `max_results` | integer | no | `3` | Maximum articles on each result page, for example 20. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Result page number starting at 1, for example 2.",
      "x-fous-developer": true,
      "examples": [
        2
      ]
    },
    "sort": {
      "enum": [
        "newest",
        "most_relevant"
      ],
      "type": "string",
      "default": "newest",
      "description": "Order results by newest publication or search relevance; for example newest.",
      "examples": [
        "most_relevant"
      ]
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Words to search for, for example Tesla.",
      "examples": [
        "Microsoft",
        "Tesla"
      ]
    },
    "to_date": {
      "type": "string",
      "format": "date",
      "description": "Latest publication date, inclusive, for example 2026-09-28.",
      "examples": [
        "2026-09-28"
      ]
    },
    "from_date": {
      "type": "string",
      "format": "date",
      "description": "Earliest publication date, inclusive, for example 2026-09-01.",
      "examples": [
        "2026-09-01"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum articles on each result page, for example 20.",
      "x-fous-developer": true,
      "examples": [
        3
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "page": 2,
      "sort": "most_relevant",
      "query": "Microsoft",
      "max_results": 3
    },
    {
      "query": "Tesla",
      "max_results": 3
    },
    {
      "query": "Tesla",
      "to_date": "2026-09-28",
      "from_date": "2026-09-01",
      "max_results": 3
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `articles` | array |  | Matching AP News articles. |
| `articles[].link` | string | `"https://apnews.com/article/stock-markets-rates-korea-ai-oil-99b5702d93a2b5c6e513fb952ccdcc92"` | AP News article link. |
| `articles[].authors` | array |  | Article authors. |
| `articles[].section` | string or null | `"Business"` | News section, when available. |
| `articles[].summary` | string or null | `"A monster day for Microsoft following signals that its big spending on AI is translating into profits led a powerful re` | Article summary, when available. |
| `articles[].headline` | string | `"Microsoft’s best day since 2008 leads US stocks, while inflation worries remain in the bond market"` | Article headline. |
| `articles[].published_at` | string | `"2026-07-30T05:09:50+00:00"` | Publication date and time with offset. |

**Example input**

```json
{
  "page": 2,
  "sort": "most_relevant",
  "query": "Microsoft",
  "max_results": 3
}
```

**Example output**

```json
{
  "articles": [
    {
      "link": "https://apnews.com/article/stock-markets-rates-korea-ai-oil-99b5702d93a2b5c6e513fb952ccdcc92",
      "authors": [
        "Stan Choe"
      ],
      "section": "Business",
      "summary": "A monster day for Microsoft following signals that its big spending on AI is translating into profits led a powerful rebound on Wall Street, while AI stocks regained some of their sharp recent losses.",
      "headline": "Microsoft’s best day since 2008 leads US stocks, while inflation worries remain in the bond market",
      "published_at": "2026-07-30T05:09:50+00:00"
    },
    {
      "link": "https://apnews.com/article/microsoft-manager-murder-trial-florida-e7e170cf1959c532152e6026d3d8bfdd",
      "authors": [
        "Ed White"
      ],
      "section": "U.S. News",
      "summary": "Lawyers have given opening statements in Florida in the trial of a man charged with arranging the murder of a Microsoft design manager.",
      "headline": "Florida trial starts in the ambush killing of a Microsoft manager. A tire ‘blew the case open’",
      "published_at": "2026-08-17T04:08:05+00:00"
    },
    {
      "link": "https://apnews.com/article/openai-microsoft-chatgpt-copilot-ai-2a44fa94da6913074f97f916332b33f6",
      "authors": [],
      "section": "Business",
      "summary": "Microsoft said Monday it will no longer pay a share of its revenue to ChatGPT maker OpenAI, the latest move to untether a close partnership that helped unleash an artificial intelligence boom.",
      "headline": "Microsoft cuts OpenAI revenue share in a fresh step to loosen their AI alliance",
      "published_at": "2026-04-27T14:35:37+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": "@ap-news",
  "visibility": "public",
  "operation": "list_headlines",
  "version": 1,
  "input": {
    "section": "world",
    "max_results": 5
  },
  "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\": \"@ap-news\",\n  \"visibility\": \"public\",\n  \"operation\": \"list_headlines\",\n  \"version\": 1,\n  \"input\": {\n    \"section\": \"world\",\n    \"max_results\": 5\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": "@ap-news",
  "visibility": "public",
  "operation": "list_headlines",
  "version": 1,
  "input": {
    "section": "world",
    "max_results": 5
  },
  "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":"@ap-news","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 by news section
- Find articles about a company or topic
- Review article authors and publication dates
- Read story text and summaries
- Collect article details for research

## FAQ

### Is Fous affiliated with AP News?

No. Fous is not affiliated with AP News. This workflow reads the public apnews.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 AP News account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from apnews.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 28, 2026.

### What are the latest headlines in a section?

Use List headlines with a section, such as world, and an optional result limit.

### Which articles mention a topic?

Use Search news with required search words and optional publication dates and sort order.

### What is the full text of an article?

Use Read article with the article link or headline. Articles without accessible text may have no paragraphs.

## Related

- [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.
- [Yahoo News API](https://fous.com/workflows/yahoo-news.md): Yahoo News provides section headlines and searchable articles, plus public article text and details; health has no public stories, and search covers a limited results window.
- [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.
- [Reuters API](https://fous.com/workflows/reuters.md): Reuters provides international news and reporting, with latest section headlines and keyword search; coverage and article details may be limited by access restrictions and news indexing.
- [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.
- [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.
- [CNBC API](https://fous.com/workflows/cnbc.md): CNBC provides business news, page-view headlines, searchable CNBC articles excluding videos, wire stories and press releases, and potentially delayed major index and U.S. futures quotes.
- [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.
- [All News workflows](https://fous.com/workflows/category/news)