vanguardngr APIvanguardngr.com ↗
Access latest news, full article content, and keyword search from Vanguard Nigeria via a structured API. Covers politics, sports, business, and more.
What is the vanguardngr API?
The Vanguard Nigeria API provides 3 endpoints to retrieve articles from vanguardngr.com, one of Nigeria's major daily newspapers. Use get_latest_news to pull paginated article feeds filtered by category, search_news to find articles by keyword, and get_article to fetch full HTML content, tags, and modification timestamps for any individual article by its numeric ID.
curl -X GET 'https://api.parse.bot/scraper/7f3fdae9-285e-43f4-aebc-13116a8ea1d5/get_latest_news?page=1&category=politics&per_page=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace vanguardngr-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.vanguard_nigeria_news_api import VanguardNews, Article, ArticleSummary
client = VanguardNews()
# Search for articles about elections
results = client.articlesummaries.search(query="election results", limit=5)
for summary in results:
print(summary.title, summary.date, summary.link)
# Get full article details from a summary
first = next(iter(client.articlesummaries.list(category="politics", limit=3)))
full_article = first.details()
print(full_article.title, full_article.date, full_article.content, full_article.author_id)
Get the latest news articles from Vanguard Nigeria, ordered by date (newest first). Optionally filter by category slug. Returns a paginated list of article summaries. Categories map to editorial sections (politics, sports, business, metro, editorial). Omitting category returns articles across all sections.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| category | string | Category slug to filter by. Common values include: politics, sports, business, metro, editorial. Omitting returns articles from all categories. |
| per_page | integer | Number of articles per page, between 1 and 100. |
{
"type": "object",
"fields": {
"page": "integer - current page number",
"articles": "array of article summary objects with id, title, excerpt, date, link, author_id, categories, featured_image",
"per_page": "integer - articles per page"
},
"sample": {
"data": {
"page": 1,
"articles": [
{
"id": 2899116,
"date": "2026-06-10T23:18:24",
"link": "https://www.vanguardngr.com/2026/06/sad-our-children-now-pawn-in-deadly-ransom-economy-peter-obi/",
"title": "Sad our children now pawn in deadly ransom economy – Peter Obi",
"excerpt": "The Presidential Candidate of the Nigeria Democratic Congress...",
"author_id": 558,
"categories": [
6
],
"featured_image": "https://cdn.vanguardngr.com/wp-content/uploads/2025/12/Peter-Obi-2.webp"
}
],
"per_page": 5
},
"status": "success"
}
}About the vanguardngr API
Endpoints and Data Coverage
The API exposes three endpoints covering the core editorial content of Vanguard Nigeria. get_latest_news returns a paginated list of articles ordered newest-first, with optional filtering by category slug — accepted values include politics, sports, business, metro, and editorial. Each article object in the response includes id, title, excerpt, date, link, author_id, categories (array of category IDs), and featured_image. The per_page parameter accepts values between 1 and 100, giving control over response size.
Search and Full-Text Retrieval
search_news accepts a required query string (for example, "Nigeria economy" or "election results") and returns results ordered by relevance rather than date, with the same article object shape as get_latest_news. Once you have an article id from either listing endpoint, pass it to get_article to retrieve the complete article: content contains the full article HTML, and the response also includes modified (ISO datetime of last edit), tags (array of tag IDs), and excerpt. This two-step pattern — list or search, then fetch — covers most content pipeline needs.
Response Shape Notes
Dates are returned as ISO 8601 datetime strings in both listing and single-article responses. The author_id and categories fields return numeric identifiers, not resolved names or slugs. The featured_image field is present in listing responses but not explicitly listed in the single-article response shape, so image handling should be done at the listing stage. Article IDs are numeric strings (for example, '2891414') and are consistent across all three endpoints.
The vanguardngr API is a managed, monitored endpoint for vanguardngr.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when vanguardngr.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official vanguardngr.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor Nigerian political news in real time by polling
get_latest_newswith thepoliticscategory slug - Build a Nigeria-focused news aggregator that surfaces articles across
business,sports, andmetrocategories - Track coverage of a specific topic or entity over time using
search_newswith recurring keyword queries - Pipe full article HTML from
get_articleinto an NLP pipeline for sentiment or topic analysis on Nigerian media - Archive Vanguard articles by iterating paginated
get_latest_newsresults and storingid,date,link, andexcerpt - Display contextually relevant Nigerian news in a fintech or business dashboard by querying the
businesscategory - Detect when an existing article is updated by comparing the
dateandmodifiedfields returned byget_article
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Vanguard Nigeria have an official developer API?+
What does the `get_latest_news` endpoint return, and how do I filter by topic?+
id, title, excerpt, date, link, author_id, categories, and featured_image. To filter by topic, pass a category slug such as politics, sports, business, metro, or editorial via the category parameter. Omitting it returns articles across all categories.Does `search_news` return the same fields as `get_latest_news`?+
search_news returns the same article object shape (id, title, excerpt, date, link, author_id, categories, featured_image), but results are ordered by relevance to the query string rather than by publication date.Are author names or category names returned directly?+
get_article return author_id as a numeric integer and categories as an array of numeric category IDs, not resolved display names or slugs. The API does not currently include a separate endpoint to resolve these IDs to names. You can fork this API on Parse and revise it to add an author or category lookup endpoint.