Foreign affairs monitoring
Use Foreign Policy endpoints to turn foreign affairs monitoring into repeatable API requests with documented inputs and JSON responses.
Turn Foreign Policy's public feed, topic archives, and articles into normalized JSON for monitoring and research.
Get Foreign Policy headlines, category or tag archives, and full article content as structured JSON.
Endpoint families
6
Documented params
17
Examples
8
Live catalog snapshot
Active endpoints
8
Methods
GET
Required params
12
Schema refs
8
{
"platform": "Foreign Policy",
"endpoint": "foreignpolicy-article",
"method": "GET",
"path": "/foreignpolicy/article",
"auth": "apiKey"
}Use cases
Get Foreign Policy headlines, category or tag archives, and full article content as structured JSON.
Use Foreign Policy endpoints to turn foreign affairs monitoring into repeatable API requests with documented inputs and JSON responses.
Use Foreign Policy endpoints to turn policy research into repeatable API requests with documented inputs and JSON responses.
Use Foreign Policy endpoints to turn content aggregation into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live Foreign Policy endpoint catalog — 8 endpoints, 17 documented request parameters, and 8 published response schemas — the same catalog Docs and Playground run against.
8 documented Foreign Policy endpoints, grouped into 8 request families — Article, Author and Headlines, plus 5 more.
17 request parameters are documented across those Foreign Policy endpoints, 12 of them required — the full input contract is public before you write any integration code.
8 of the 8 Foreign Policy endpoints ship a recorded example response, and 8 carry a documented response schema — you can code against the real JSON before the first request.
Foreign Policy endpoints document their error responses (400, 404, 429 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
8 hosted MCP tools back the Foreign Policy endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
These cards are generated from the active endpoint catalog, so the landing page reflects the same API surface used by Docs and Playground.
/foreignpolicy/article
/foreignpolicy/author
/foreignpolicy/headlines
/foreignpolicy/live
/foreignpolicy/live-detail
/foreignpolicy/project
Endpoint catalog
/foreignpolicy/articleReturns a public Foreign Policy article's metadata and full body paragraphs from a canonical article URL. is_gated reports the site's own content-tier marker; the full body is always returned regardless, since Foreign Policy serves it in full to anonymous requests either way.
MCP tool foreignpolicy_article
/foreignpolicy/authorReturns one Foreign Policy contributor's public profile: name, bio, and their recent articles. Further articles load behind a client-side control this endpoint does not follow, so this is the author page's initial recent-article list, not the contributor's full history.
MCP tool foreignpolicy_author
/foreignpolicy/headlinesReturns fresh headlines from Foreign Policy's public, site-wide RSS feed. There is no section parameter: use foreignpolicy-topic to scope to one category or tag.
MCP tool foreignpolicy_headlines
/foreignpolicy/liveReturns Foreign Policy's public FP Live conversation directory. The upstream renders the complete all-conversations list and applies year filtering in the browser.
MCP tool foreignpolicy_live
/foreignpolicy/live-detailReturns one public FP Live conversation by the slug returned by foreignpolicy-live, including its description and any embedded video highlight metadata.
MCP tool foreignpolicy_live_detail
/foreignpolicy/projectReturns a public Foreign Policy curated project hub and its current article cards. Use foreignpolicy-projects to discover live project slugs.
MCP tool foreignpolicy_project
/foreignpolicy/projectsReturns one page of Foreign Policy's live public project directory. Follow next_page until it is zero to enumerate the current project slug space, then pass a slug to foreignpolicy-project.
MCP tool foreignpolicy_projects
/foreignpolicy/topicReturns one page of a public Foreign Policy category or tag archive (newest first). type selects the archive namespace and defaults to category; topic is the slug within it; page is 1-based.
MCP tool foreignpolicy_topic
Related APIs
Media & Streaming
Browse Sportskeeda's sports and entertainment coverage, community wikis, quizzes, and fan games with the catalog's current slugs and filter limits.
Media & Streaming
Research streaming catalogs, title availability, providers, offers, seasons, episodes, and release changes from JustWatch with normalized JSON.
Media & Streaming
Turn Apple Books ebook and audiobook pages into structured data — search, catalog detail, paginated customer reviews, similar titles, author bibliographies, series listings, and chart rankings as normalized JSON. Credential-free.
How to scrape Foreign Policy
Foreign Policy, a Graham Holdings title since The Washington Post Company acquired it in 2000, mixes a site-wide feed, category and tag archives, curated project hubs, and FP Live conversation replays. Crawlora's eight endpoints return all of it as normalized JSON, with FP's own is_gated flag passed through on headlines and articles. The FP Live directory alone held 266 conversations when pulled on 2026-09-24.
Call /foreignpolicy/headlines for the site-wide feed. A 2026-09-24 pull returned 25 items, is_gated true on most but false on several World Brief and Q&A pieces.
Use /foreignpolicy/topic with type=category or type=tag and a real archive slug. Guessing one, such as china, returned a resource-not-found error in testing — pull slugs from a headline's or article's own category data instead.
Pass a canonical Foreign Policy URL to /foreignpolicy/article for its title, byline, categories, and body paragraphs. A 2026-09-24 analysis piece returned 16 paragraphs along with FP's is_gated flag.
Pass a slug or URL to /foreignpolicy/author for a contributor's bio and recent articles. Many bylines are outside analysts, not staff — one contributor's list on 2026-09-24 ran from a 2019 piece through a 2026 one.
Page /foreignpolicy/projects until next_page is zero, then pass a discovered slug to /foreignpolicy/project for that hub's cards. The Trump-Xi Summit hub's cards on 2026-09-24 stretched back to an April 27 piece, five months earlier.
Call /foreignpolicy/live for the conversation directory (266 entries on 2026-09-24), then pass a slug to /foreignpolicy/live-detail for that conversation's air date, description, and Vimeo highlight clips.
FAQ
/foreignpolicy/topic needs the exact category or tag slug from Foreign Policy's own URLs — a guessed value like china returned a resource-not-found error in testing on 2026-09-24, so pull real slugs from a headline's or article's own category data instead.
It is Foreign Policy's own marker for pieces that count toward its subscription meter, copied through as metadata. Most items in the 2026-09-24 headline pull carried is_gated:true, while several World Brief and Q&A pieces were marked false.
A biography and that contributor's recent articles — but many bylines belong to outside analysts, not staff. One contributor's list on 2026-09-24 spanned a 2019 article and a 2022 one alongside a fresh 2026 piece.
No — /foreignpolicy/project's cards cover the topic's full run. The Trump-Xi Summit hub's 20 cards on 2026-09-24 stretched back to an April 27 piece, five months before that week's summit.
No. Headlines, topic archives, project hubs, FP Live pages, and articles are read from Foreign Policy's public web pages; no FP subscriber session is used.