Skip to main content
GET
/
v1
/
blog
/
category
/
{slug}
Posts by category
curl --request GET \
  --url https://api.ngnmarket.com/v1/blog/category/{slug} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "category": {
      "name": "Markets",
      "slug": "markets"
    },
    "data": [
      {
        "slug": "ngx-asi-april-review",
        "title": "NGX All Share Index — April 2026 Review",
        "excerpt": "How the ASI performed in April and what to watch going into May.",
        "coverImage": "https://ngnmarket.com/images/blog/asi-april.jpg",
        "publishedDate": "2026-04-03T08:00:00.000Z",
        "categories": [
          "markets"
        ],
        "tags": [
          "NGX",
          "ASI",
          "equities"
        ],
        "companies": [],
        "url": "https://ngnmarket.com/blog/ngx-asi-april-review"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 11,
      "pages": 1,
      "hasNext": false,
      "hasPrev": false
    }
  },
  "meta": {
    "plan": "free",
    "calls_used": 316,
    "calls_remaining": 9684,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.ngnmarket.com/llms.txt

Use this file to discover all available pages before exploring further.

Returns paginated posts in a given category. The category object in the response confirms the matched category name and slug. Available categories: markets, corporate-news, economy, industries, technology, personal-finance, product-updates. Use the categories array on any post object to discover which slugs apply.

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.

Path Parameters

​
slug
string
required

Category slug (e.g. markets, corporate-news). Lowercase, hyphen-separated.

Example:

"markets"

Query Parameters

​
page
integer
default:1

Page number. Defaults to 1.

Required range: x >= 1

Response

Category posts retrieved successfully.

​
success
boolean
required
​
meta
object

Quota and plan metadata included on every authenticated response.

​
data
object