afp.com APIafp.com ↗
Access AFP wire ticker headlines and AFP Factuel fact-check articles. Search, filter by region or topic, and retrieve full article content via 9 endpoints.
curl -X GET 'https://api.parse.bot/scraper/8f825f5d-d8ad-491e-9e99-729f3f4da791/get_homepage_news_ticker?lang=en' \ -H 'X-API-Key: $PARSE_API_KEY'
Scrape the live news ticker on afp.com homepage which shows real-time AFP wire dispatches including location, timestamp, and headline text.
| Param | Type | Description |
|---|---|---|
| lang | string | Language code: fr, en, es, pt, de, ar |
{
"type": "object",
"fields": {
"language": "string indicating the language used",
"ticker_items": "array of news ticker items with location, timestamp, and headline"
},
"sample": {
"data": {
"language": "en",
"ticker_items": [
{
"headline": "Iranian embassy denies armed forces struck South Korean ship in Hormuz",
"location": "Seoul (AFP)",
"timestamp": "07/05/2026 - 05:18:50"
}
]
},
"status": "success"
}
}About the afp.com API
The AFP API provides 9 endpoints covering two distinct data sources: the live AFP.com homepage news ticker and the AFP Factuel fact-checking archive. get_factcheck_article returns structured body blocks, authors, tags, and publication timestamps for individual fact-checks identified by document ID, while get_homepage_news_ticker delivers real-time wire dispatches across up to six languages including Arabic, French, and Spanish.
News Ticker and Wire Dispatches
The get_homepage_news_ticker endpoint accepts an optional lang parameter (fr, en, es, pt, de, ar) and returns an array of ticker_items, each containing a location string, a timestamp, and a headline. This is the same live dispatch feed displayed on the AFP corporate homepage, making it useful for monitoring breaking news across language editions.
AFP Factuel Fact-Check Content
Five endpoints cover AFP Factuel's fact-checking corpus. get_factcheck_homepage returns the latest articles as an array with title, url, doc_id, date, and tags. get_factcheck_article takes a doc_id (e.g. A9CW3NR) and returns the full article: a body array of typed content blocks (text or image), authors, tags, date, and title. get_factcheck_article_list_all paginates the complete archive by page number. search_factcheck_articles accepts a query string supporting single and multi-word terms and returns matching articles with the same metadata shape.
Filtering by Region and Topic
get_factcheck_by_region filters fact-checks by geography using a region parameter (Europe, Afrique, Amerique-du-Nord, Moyen-Orient, Amerique-Latine, Asie-Pacifique) with optional page pagination. get_factcheck_by_topic filters by numeric topic_id covering categories such as Santé (146), Environnement (135), Science (143), Politique (134), and Conflits (141). Both endpoints return the standard article array.
Discovery and Category Endpoints
get_factcheck_trending_topics returns an array of topic objects with name and url, reflecting the featured tags currently shown on the AFP Factuel homepage. get_afp_content_categories retrieves AFP's corporate content product categories from the main site, returning name and url per category — useful for mapping AFP's multimedia and specialized content offerings.
- Monitor breaking news in real time by polling
get_homepage_news_tickeracross multiple language editions - Build a misinformation research database by paginating
get_factcheck_article_list_alland storing full article body blocks - Search AFP Factuel by keyword (e.g. 'vaccin', 'Ukraine') using
search_factcheck_articlesto surface relevant fact-checks - Filter fact-check articles by geographic region (e.g. Afrique, Asie-Pacifique) for region-specific media monitoring dashboards
- Track health and science misinformation by querying
get_factcheck_by_topicwith topic IDs for Santé (146) and Science (143) - Aggregate trending fact-check topics via
get_factcheck_trending_topicsto identify currently contested narratives - Index AFP's content product categories from
get_afp_content_categoriesfor editorial partner directories
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does AFP have an official developer API?+
What exactly does `get_factcheck_article` return, and how is the body structured?+
doc_id string (such as A9CW3NR) and returns title, date, authors, tags, and a body array. Each element in body has a type field that is either text or image. Text blocks carry a content field; image blocks carry a url field. This lets you reconstruct the article's reading order programmatically without parsing HTML.Does the AFP Factuel coverage include languages other than French?+
get_factcheck_homepage, search_factcheck_articles, get_factcheck_by_region, get_factcheck_by_topic, get_factcheck_article_list_all) are scoped to factuel.afp.com, which publishes primarily in French. The lang parameter is available only on get_homepage_news_ticker for the wire feed, not on the fact-check endpoints. You can fork this API on Parse and revise it to target AFP's fact-checking sites in other language editions.Does the API return the full image assets embedded in a fact-check article?+
body array include a url field pointing to the image, but the API does not return binary image data or additional metadata such as captions, credits, or alt text. You can fork this API on Parse and revise it to extract those additional image attributes if your use case requires them.How fresh is the news ticker data returned by `get_homepage_news_ticker`?+
timestamp field so you can detect new items between successive calls. There is no webhook or push mechanism; freshness depends on your polling frequency within the plan's rate limits.