# AP News API: Read article

> Reads the full text and details of one public AP News article from its link or headline.

Unofficial. Not affiliated with or endorsed by AP News.

- Page: https://fous.com/methods/apnews.com/read-article
- Method: `apnews.com/read_article`, version 1
- Website: apnews.com
- Returns: headline, summary, authors, dates, section, tags, image, paragraphs, word count
- 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 |
|---|---|---|---|---|
| `article` | string | yes | `"https://apnews.com/live/top-25-college-football-poll-9-27-2026"` | AP News article link or headline, e.g. https://apnews.com/article/california-san-clemente-beach-erosion-rail-1843fb400da08a60aa6a9082279c04cf |

## Output

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

```json
{
  "article": "https://apnews.com/live/top-25-college-football-poll-9-27-2026"
}
```

Its output:

```json
{
  "tags": [
    "College football",
    "My Fan Picks",
    "Top 25"
  ],
  "authors": [
    "Maura Carey",
    "Luena Rodriguez-Feo Vileira",
    "Sharon L. Lynch"
  ],
  "section": "Sports",
  "summary": "The AP Top 25 poll moved Florida up to No. 8, Miami up to No. 4 and Ole Miss down to No. 9. Texas, Georgia and Notre Dame went 1-2-3 again. See the latest college football rankings.",
  "headline": "AP Top 25 highlights: Florida flies into the top 10 as four new teams join the rankings",
  "article_id": null,
  "paragraphs": [
    "WATCH: AP Top 25 Week 4 recap: College football is so back: AP's Top 25 Explained",
    "Jeremiah Smith becomes a Heisman favorite: One week after Jeremiah Smith became Ohio State’s all-time leading receiver, he takes over as a Heisman favorite after exploding for 12 receptions, 217 receiving yards and four touchdowns – that’s Jeremiah Smith for you. Smith’s odds jumped from +950 to +29…",
    "Ask a voter: Walk us through how you've voted No. 1 this season: Walk us through how you've voted No. 1 this season, from the preseason rankings to moving Georgia to the top spot this week. I opted to put ultra-talented Ohio State No. 1 on my preseason ballot for various reasons. The fall-from-ahead…"
  ],
  "updated_at": "2026-09-27T21:12:30.581000+00:00",
  "word_count": 2853,
  "article_url": "https://apnews.com/live/top-25-college-football-poll-9-27-2026",
  "published_at": "2026-09-27T15:09:04.240000+00:00",
  "main_image_url": "https://dims.apnews.com/dims4/default/35ef284/2147483647/strip/false/crop/1440x810+0+0/resize/1200x675!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F83%2F32%2F7c5c94ef4dbf97526593774d6f55%2F4-1.png",
  "main_image_caption": null,
  "full_text_available": true
}
```

## 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":"apnews.com/read_article","input":{"article":"https://apnews.com/live/top-25-college-football-poll-9-27-2026"}}'
```

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

- Pull up the full text of this AP article: https://apnews.com/article/california-san-clemente-beach-erosion-rail-1843fb400da08a60aa6a9082279c04cf and tell me who wrote it and when it was published.
- Can you open the AP story titled about the Senate passing a stopgap spending bill and give me its summary, tags, and word count?
- I need the byline, section, and paragraphs of the AP News piece on the Midwest flooding recovery efforts.
- Read the article at this link and list its headline, dates, and image caption: https://apnews.com/article/climate-heat-wave-urban-cooling-7f3a9c21
- Get the details of the AP report about a wildfire evacuation order in northern Oregon, including the section and tags.

## Input schema

```json
{
  "type": "object",
  "required": [
    "article"
  ],
  "properties": {
    "article": {
      "type": "string",
      "description": "AP News article link or headline, e.g. https://apnews.com/article/california-san-clemente-beach-erosion-rail-1843fb400da08a60aa6a9082279c04cf"
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "headline",
    "paragraphs",
    "full_text_available",
    "word_count",
    "article_url"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "authors": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "section": {
      "type": [
        "string",
        "null"
      ]
    },
    "summary": {
      "type": [
        "string",
        "null"
      ]
    },
    "headline": {
      "type": "string"
    },
    "article_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "paragraphs": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "updated_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "word_count": {
      "type": "integer"
    },
    "article_url": {
      "type": "string"
    },
    "published_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "main_image_url": {
      "type": [
        "string",
        "null"
      ]
    },
    "main_image_caption": {
      "type": [
        "string",
        "null"
      ]
    },
    "full_text_available": {
      "type": "boolean"
    }
  }
}
```

## See more

- [AP News API: List headlines](https://fous.com/methods/apnews.com/list-headlines.md): Lists AP News headlines in the order shown on a public section page, up to 50 stories. Author credits and the article section are added for the first 20 articles only.
- [NPR API: Read article](https://fous.com/methods/npr.org/read-article.md): Reads an NPR article by its link or headline and returns its text and publication details. For live blogs, returns the displayed updates.
- [BBC News API: Read article](https://fous.com/methods/bbc.com/read-article.md): Reads the text and details of a BBC News article from its link or headline. Live coverage pages return the latest entries available.
- [CNN API: Read an article](https://fous.com/methods/cnn.com/read-article.md): Reads a CNN article by link or headline and returns its headline, summary, authors, dates, section, tags, main image and public paragraphs. Subscriber stories return only a brief public preview; live blogs include their entries.
- [Yahoo API: Read article](https://fous.com/methods/yahoo.com/read-article.md): Reads a public Yahoo News article from its link or headline and returns its text and details. Headline matching uses Yahoo News search results.
- [The Guardian API: Read article](https://fous.com/methods/theguardian.com/read-article.md): Reads one public Guardian article by link or headline and returns its details and available full-text paragraphs. Live blogs return the latest entries shown on the page; some older articles may be unavailable.
- [Al Jazeera API: Read an article](https://fous.com/methods/aljazeera.com/read-article.md): Reads one public Al Jazeera article from its link, or from a headline (the best match of the site's own search), and returns its text and details; live blogs give their latest ten entries.
- [Daily Mail API: Read an article](https://fous.com/methods/dailymail.co.uk/read-article.md): Reads a public Daily Mail article from its link, or from a headline (the best-matching result of the site's search), and returns its text and details; live blogs give the latest entries shown on the page.
- [All AP News methods](https://fous.com/methods/apnews.com.md)