Skip to main content
GET
/
blog
/
posts
Paginated blog post list
curl --request GET \
  --url https://api.ngnmarket.com/v1/blog/posts \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "data": [
      {
        "slug": "fgn-bond-market-outlook-2026",
        "title": "FGN Bond Market Outlook for 2026",
        "excerpt": "An in-depth look at Federal Government bond yields and what investors can expect through the rest of 2026.",
        "cover_image": "https://ngnmarket.com/images/blog/fgn-bond-outlook.jpg",
        "published_date": "2026-04-10",
        "categories": [
          "economy",
          "fixed-income"
        ],
        "tags": [
          "bonds",
          "fg"
        ],
        "companies": [],
        "url": "https://ngnmarket.com/blog/fgn-bond-market-outlook-2026"
      },
      {
        "slug": "dangote-cement-q1-analysis",
        "title": "Dangote Cement Q1 2026 Results: What the Numbers Say",
        "excerpt": "A breakdown of Dangote Cement's Q1 2026 financial results and what they mean for shareholders.",
        "cover_image": "https://ngnmarket.com/images/blog/dangote-cement-q1.jpg",
        "published_date": "2026-04-07",
        "categories": [
          "corporate-news"
        ],
        "tags": [
          "earnings"
        ],
        "companies": [
          "DANGCEM"
        ],
        "url": "https://ngnmarket.com/blog/dangote-cement-q1-analysis"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 42,
      "pages": 3,
      "has_next": true,
      "has_prev": false
    }
  },
  "meta": {
    "plan": "free",
    "calls_used": 312,
    "calls_remaining": 9688,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}
Returns a paginated, date-descending feed of published posts. Each page contains up to 20 posts, and each post includes a canonical url linking to the full article on ngnmarket.com/blog. You can filter the feed using any combination of category, company, and tag. For example, ?category=markets&company=DANGCEM returns posts in the markets category that are also tagged to DANGCEM. For the rich author profile, named taxonomies, and content preview, call GET /blog/posts/{slug}.

​
Available categories

Pass one of these slugs to the category query param.
SlugName
marketsMarkets
corporate-newsCorporate News
economyEconomy
industriesIndustries
technologyTechnology
personal-financePersonal Finance
product-updatesProduct Updates

​
Available tags

Pass one of these slugs to the tag query param.
SlugName
stocksStocks
cryptoCrypto
exchange-rateExchange Rate
inflationInflation
cbnCBN
earningsEarnings
energyEnergy
bankingBanking
fintechFintech
t-billsT-Bills
fgFG
dividendsDividends
ngn-marketNGN Market

​
Filtering by company

The company param takes the NGX stock ticker symbol of a listed company. For example, use DANGCEM for Dangote Cement, MTNN for MTN Nigeria, GTCO for Guaranty Trust, or BUACEMENT for BUA Cement. The lookup is case-insensitive, so dangcem and DANGCEM return the same posts. If you are not sure what a company’s ticker is, you can fetch the full list of valid symbols from GET /companies/identifiers.

​
Combining filters

Filters compose, so you can ask for posts in the markets category that are also tagged to DANGCEM: 
curl "https://api.ngnmarket.com/v1/blog/posts?category=markets&company=DANGCEM" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

Authorizations

​
Authorization
string
header
required

Pass your API key as a Bearer token: Authorization: Bearer ngm_live_YOUR_KEY. Generate keys at ngnmarket.com/dashboard/developer.

Query Parameters

​
page
integer
default:1

Page number. Defaults to 1.

Required range: x >= 1
​
category
enum<string>

Filter by category slug. One of: markets, corporate-news, economy, industries, technology, personal-finance, product-updates.

Available options:
markets,
corporate-news,
economy,
industries,
technology,
personal-finance,
product-updates
Example:

"markets"

​
company
string

Filter by an NGX-listed company's stock ticker symbol, for example DANGCEM for Dangote Cement, MTNN for MTN Nigeria, or GTCO for Guaranty Trust. The lookup is case-insensitive and matches the post's companies field exactly, so there is no fuzzy matching. You can fetch the full list of valid symbols from GET /companies/identifiers.

Example:

"DANGCEM"

​
tag
enum<string>

Filter by tag slug. One of: stocks, crypto, exchange-rate, inflation, cbn, earnings, energy, banking, fintech, t-bills, fg, dividends, ngn-market.

Available options:
stocks,
crypto,
exchange-rate,
inflation,
cbn,
earnings,
energy,
banking,
fintech,
t-bills,
fg,
dividends,
ngn-market
Example:

"banking"

Response

Blog posts retrieved successfully.

​
success
boolean
required
​
meta
object

Quota and plan metadata included on every authenticated response.

​
data
object