Plus234Feed API V2

Version: 2.0.0 | Total Endpoints: 167 | Base URL: https://plus234feed-api.onrender.com
API Documentation

Articles

GET/v2/articles/homepage GET/v2/articles/category-home/politics GET/v2/articles/category-home/business GET/v2/articles/category-home/sports GET/v2/articles/category-home/entertainment GET/v2/articles/category-home/tech GET/v2/articles/category-home/lifestyle

GET/v2/articles/{article_id}

GET/v2/articles/{article_id}/related

Meta & Feeds

GET/v2/meta/feed?page=1&per_page=20 GET/v2/meta/homepage-feed?page=1&per_page=20 GET/v2/meta/category-feed/politics?page=1&per_page=20 GET/v2/meta/category-feed/business?page=1&per_page=20 GET/v2/meta/sources GET/v2/meta/top-sources?limit=10 GET/v2/meta/trending-keywords?limit=20 GET/v2/meta/categories

Search

GET/v2/search/relevant?q=nigeria&page=1&per_page=20 GET/v2/search/recent7?q=election&page=1&per_page=20 GET/v2/search/recent30?q=budget&page=1&per_page=20 GET/v2/search/older?q=covid&page=1&per_page=20

Music Charts

CBN Data

Exchange Rates

GET/v2/cbn/exchange/usd GET/v2/cbn/exchange/all GET/v2/cbn/exchange/priority GET/v2/cbn/exchange/analysis?currency=US DOLLAR&days=30 GET/v2/cbn/exchange/health

Inflation Metrics

GET/v2/cbn/inflation/latest GET/v2/cbn/inflation/month/{year}/{month} GET/v2/cbn/inflation/history?months=12

Interest Rates

GET/v2/cbn/rates/latest GET/v2/cbn/rates/month/{year}/{month} GET/v2/cbn/rates/history?months=12

Treasury Bill Auctions (NTB)

GET/v2/cbn/ntb-auctions/latest GET/v2/cbn/ntb-auctions/by-date?auction_date={date} GET/v2/cbn/ntb-auctions/tenor/{tenor} GET/v2/cbn/ntb-auctions/history?months=6

Aggregated Data

GET/v2/cbn/snapshot?period=1M GET/v2/cbn/history?metric=inflation&months=12 GET/v2/cbn/merged-monthly?limit=12

Commodities

Oil Prices

GET/v2/commodities/oil/latest GET/v2/commodities/oil/analysis GET/v2/commodities/oil/health

Stocks (NGX)

GET/v2/stocks/indices GET/v2/stocks/gainers GET/v2/stocks/losers GET/v2/stocks/traders GET/v2/stocks/summary

NGX Market Data (Direct API)

Market Overview

GET/v2/ngx/snapshot GET/v2/ngx/snapshot/history GET/v2/ngx/summary GET/v2/ngx/summary/history

Top Movers

GET/v2/ngx/movers GET/v2/ngx/gainers GET/v2/ngx/losers

Tickers

GET/v2/ngx/tickers GET/v2/ngx/tickers?search={query} GET/v2/ngx/tickers/{symbol}

Bonds & ETFs

GET/v2/ngx/bonds GET/v2/ngx/etfs

Corporate Filings

GET/v2/ngx/filings GET/v2/ngx/filings?company={symbol} GET/v2/ngx/filings/types

Exchange Rates (Parallel Market)

GET/v2/exchange/parallel/latest GET/v2/exchange/parallel/history GET/v2/exchange/parallel/trends/{currency} GET/v2/exchange/parallel/date/{date} GET/v2/exchange/parallel/currencies

Events

GET/v2/events GET/v2/events/category/{category} GET/v2/events/categories GET/v2/events/search GET/v2/events/all

Daily Brief

Banner

GET/v2/daily-brief/banner/latest GET/v2/daily-brief/banner/by-date/{date} GET/v2/daily-brief/banner/history

Page

GET/v2/daily-brief/page/latest GET/v2/daily-brief/page/by-date/{date} GET/v2/daily-brief/page/history GET/v2/daily-brief/page/top-stories GET/v2/daily-brief/page/market-data

Feedback

POST/v2/feedback/submit

GET/v2/feedback/admin/list GET/v2/feedback/admin/stats GET/v2/feedback/admin/search GET/v2/feedback/admin/recent

GET/v2/feedback/admin/{id}

PATCH/v2/feedback/admin/{id}/status

Syndication (RSS & Sitemaps)

GET/v2/rss/feed GET/v2/rss/feed/category/{category} GET/v2/sitemap.xml GET/v2/sitemap/static.xml GET/v2/sitemap/articles.xml

Movies

GET/v2/movies/now-showing/preview GET/v2/movies/now-showing/all GET/v2/movies/coming-soon/preview GET/v2/movies/coming-soon/all

GET/v2/movies/movie/{id}

GET/v2/movies/stats

POST/v2/newsletter/subscribe

POST/v2/newsletter/unsubscribe

GET/v2/newsletter/stats GET/v2/newsletter/count

NPFL (Nigerian Premier League)

GET/v2/npfl/current-season GET/v2/npfl/standings/{season} GET/v2/npfl/fixtures/upcoming GET/v2/npfl/fixtures/recent GET/v2/npfl/fixtures/latest-round GET/v2/npfl/teams GET/v2/npfl/teams/all GET/v2/npfl/teams/search

GET/v2/npfl/team/{team_name}/profile

GET/v2/npfl/team/{team_name}/stats

GET/v2/npfl/team/{team_name}/fixtures

GET/v2/npfl/team/{team_name}/form

GET/v2/npfl/head-to-head/{team1}/{team2}

GET/v2/npfl/season-stats GET/v2/npfl/teams/in-form GET/v2/npfl/teams/out-of-form GET/v2/npfl/teams/goal-stats GET/v2/npfl/debug/team-names

User Engagement

Notifications

POST/v2/user-engagement/notifications (Admin Create)

GET/v2/user-engagement/notifications?user_id={uuid}

PATCH/v2/user-engagement/notifications/{id}/read

PATCH/v2/user-engagement/notifications/{id}/archive

GET/v2/user-engagement/notifications/stats?user_id={uuid}

Bookmarks

POST/v2/user-engagement/bookmarks?user_id={uuid}

GET/v2/user-engagement/bookmarks?user_id={uuid}

GET/v2/user-engagement/bookmarks/{id}?user_id={uuid}

PATCH/v2/user-engagement/bookmarks/{id}?user_id={uuid}

DELETE/v2/user-engagement/bookmarks/{id}?user_id={uuid}

GET/v2/user-engagement/bookmarks/stats/summary?user_id={uuid}

Follows

POST/v2/user-engagement/follows?user_id={uuid}

DELETE/v2/user-engagement/follows/{publisher}?user_id={uuid}

GET/v2/user-engagement/follows?user_id={uuid}

PATCH/v2/user-engagement/follows/{publisher}?user_id={uuid}

GET/v2/user-engagement/follows/{publisher}/is-following?user_id={uuid}

GET/v2/user-engagement/publishers/{publisher}/followers

GET/v2/user-engagement/follows/stats/summary?user_id={uuid}

Authentication

GET/v2/auth/health

POST/v2/auth/register

POST/v2/auth/login

POST/v2/auth/logout

POST/v2/auth/refresh

GET/v2/auth/me

POST/v2/auth/password-reset

POST/v2/auth/reset-password

PUT/v2/auth/password

POST/v2/auth/verify-email

PUT/v2/auth/email

POST/v2/auth/resend-verification

PUT/v2/auth/profile

PUT/v2/auth/notification-settings

DELETE/v2/auth/account