Endpoints quick reference
Paths below are after the site prefix (e.g. fn/ for Fox News). Config paths are under src/apis/foxnews/ unless noted.
Mobile (high traffic)
| Endpoint |
Config / notes |
Description |
/mobile/home |
mobile/hometab/config.js |
Main mobile homepage |
/mobile/article |
mobile/type/article/config.js |
Article view |
/mobile/article/{id} |
same |
Article by ID |
/mobile/liveblog/{slug} |
mobile/type/liveblog/config.js |
Live blog |
/mobile/trending-topics |
— |
Trending topics |
/mobile/trending-videos |
— |
Trending videos |
/mobile/topic-nav |
— |
Topic navigation |
/mobile/listen |
mobile/tab/listen/config.js |
Listen / radio tab |
/mobile |
config/mobile/config.js |
Global mobile app config |
/mobile/ott/config/4.61 |
mobile/ott/config/version/4.61/config.js |
OTT (example version) |
/generated-playlist/{title} |
mobile/generated-playlist/config.js |
Generated playlists |
CMS
| Endpoint |
Description |
/homepage |
Main homepage data |
/homepage/{id} |
Homepage by ID |
/homepage/trending |
Trending |
/hp-top-ten |
Top 10 |
/hp-top-stories |
Top stories |
/section-fronts/{section} |
Section fronts |
/video |
Video homepage |
/video/shows/{show} |
Video by show |
/video/topics/{topic} |
Video by topic |
Shared content (Spark / Brightcove / etc.)
| Endpoint |
Description |
/articles, /articles/{id} |
Spark articles |
/videos, /videos/{id} |
Brightcove videos |
/playlists, /playlists/{id} |
Brightcove playlists |
/images/{id} |
Images |
/persons/{id} |
Persons / authors |
/sections/{id} |
Sections |
/shows/{id} |
Shows |
/sources/{id} |
Sources |
/tags/{id} |
Tags |
/content, /content/{id} |
Aggregated content |
/podcasts |
Podcasts |
/radio |
Radio |
| Partner |
Route pattern |
Example config area |
| Yahoo |
/yahoo/{category}.xml |
rss/yahoo/articles, rss/yahoo/videos |
| MSN |
/msn/{category}.xml |
rss/msn/articles, rss/msn/videos |
| Google Newsletter |
/google/newsletter/{category}.xml |
rss/google |
| Google Publisher |
/google-publisher/{category}.xml |
rss/google-publisher/... |
| Flipboard |
/flipboard/{category}.xml |
rss/flipboard/... |
| Twitter |
/twitter/{category}.xml |
rss/twitter |
| Snapchat |
/snapchat.xml |
rss/snapchat |
| NewsBreak |
/newsbreak.xml |
rss/newsbreak |
| Partner |
Route pattern |
| Verizon |
/verizon/{category}.xml |
| Feedburner |
/feedburner/{category}.xml |
| SmartNews |
/smartnews/latest.xml |
| Samsung |
/samsung/latest.xml |
| Apple TV |
/apple/{tv}.xml |
| Amazon |
/amazon-{category}.xml |
| Lite |
/rss/lite/{category}.xml |
OOH (out-of-home)
Providers include reachtv, cleartv, wovenmedia, moodmedia, gstv.
| Type |
Route |
| Summary |
/rss/{provider}/summary.xml |
| Full content |
/rss/{provider}/full-content.xml |
| Articles summary |
/rss/{provider}/summary-articles.xml |
| Articles full |
/rss/{provider}/full-content-articles.xml |
| Videos |
/rss/{provider}/videos.xml |
| Endpoint |
Description |
/video-player/{id} |
Video player embed |
/playlist/{id} |
Playlist data |
/podcast-articles |
Podcast section bucket |
/search/{platform} |
Search API |
/search/internal/{platform} |
Internal search |
/videos/{id}/preview.mp4 |
HolaSpark preview |
/articles/{id}/speech.mp3 |
SpeechKit audio |
/holaspark |
HolaSpark feed |
/roku/search |
Roku search |
/swagger/{route} |
Swagger / OpenAPI docs |
/hello, /hello/{name} |
Health / demo |
Common category tokens
- News: latest, us, world, politics, opinion, media, entertainment, sports, lifestyle, health, science, tech, travel
- Radio: current, up-next, schedule, legacy
- Search platforms: web, ios, android
Local examples
Server: http://localhost:3001 (with site prefix fn):
curl "http://localhost:3001/fn/mobile/home?platform=ios&device=phone&app_v=5.11"
curl "http://localhost:3001/fn/mobile/article/12345"
curl "http://localhost:3001/fn/yahoo/latest.xml"
curl "http://localhost:3001/fn/videos/6363943814112"
curl "http://localhost:3001/fn/search/web?q=breaking+news"
For deeper narrative docs, see Fox News APIs and Fox Weather APIs in this site.
