Search Blog Posts - NGN Market API

AI-powered blog post search

curl --request GET \
  --url https://api.ngnmarket.com/v1/blog/search \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": {
    "data": [
      {
        "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.",
        "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",
        "relevance_score": 12
      },
      {
        "slug": "ngx-cement-sector-outlook",
        "title": "NGX Cement Sector: Competitive Dynamics in 2026",
        "excerpt": "How DANGCEM, WAPCO, and BUA Cement are positioning.",
        "cover_image": "https://ngnmarket.com/images/blog/cement-sector.jpg",
        "published_date": "2026-03-15",
        "categories": [
          "markets"
        ],
        "tags": [
          "stocks"
        ],
        "companies": [
          "DANGCEM",
          "WAPCO"
        ],
        "url": "https://ngnmarket.com/blog/ngx-cement-sector-outlook",
        "relevance_score": 8
      }
    ],
    "total": 2,
    "query": "Dangote Cement",
    "expanded_terms": [
      "dangote",
      "cement",
      "dangcem",
      "dcp",
      "bua",
      "wapco"
    ]
  },
  "meta": {
    "plan": "free",
    "calls_used": 314,
    "calls_remaining": 9686,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}

GET

blog

AI-powered blog post search

curl --request GET \
  --url https://api.ngnmarket.com/v1/blog/search \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": {
    "data": [
      {
        "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.",
        "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",
        "relevance_score": 12
      },
      {
        "slug": "ngx-cement-sector-outlook",
        "title": "NGX Cement Sector: Competitive Dynamics in 2026",
        "excerpt": "How DANGCEM, WAPCO, and BUA Cement are positioning.",
        "cover_image": "https://ngnmarket.com/images/blog/cement-sector.jpg",
        "published_date": "2026-03-15",
        "categories": [
          "markets"
        ],
        "tags": [
          "stocks"
        ],
        "companies": [
          "DANGCEM",
          "WAPCO"
        ],
        "url": "https://ngnmarket.com/blog/ngx-cement-sector-outlook",
        "relevance_score": 8
      }
    ],
    "total": 2,
    "query": "Dangote Cement",
    "expanded_terms": [
      "dangote",
      "cement",
      "dangcem",
      "dcp",
      "bua",
      "wapco"
    ]
  },
  "meta": {
    "plan": "free",
    "calls_used": 314,
    "calls_remaining": 9686,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}

Searches all published posts by keyword. Queries are automatically expanded using AI, so searching "MTNN" will find articles about “MTN Nigeria”, and "gtbank" will surface “Guaranty Trust” results. Each result includes a relevanceScore and a canonical url linking to the full article on ngnmarket.com/blog. Narrow results to a date window with fromDate and toDate, and cap the number of hits with limit (max 10):

curl "https://api.ngnmarket.com/v1/blog/search?q=Dangote%20Cement&fromDate=2026-01-01&limit=10" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

If you want posts for a specific NGX-listed stock, use GET /blog/posts?company=SYMBOL instead. It’s a direct lookup on the companies field and doesn’t require a search query.

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

string

required

Search query. Must be a non-empty string.

Example:

"Dangote Cement"

limit

integer

default:5

Maximum number of results (1–10). Defaults to 5.

Required range: 1 <= x <= 10

from

string<date>

Filter posts published on or after this date (e.g. 2026-01-01).

string<date>

Filter posts published on or before this date.

Response

Search results retrieved successfully.

success

boolean

required