Complete reference for all API endpoints. Access 70,000+ names with meanings, origins, and cultural information.
https://namverse-api.vercel.app/api/v1
Rate Limit: 100 requests/day per IP | Authentication: None required
Check API and database health status. No parameters required.
GET /api/v1/health
{ "status": "ok", "database": "connected", "timestamp": "2024-12-26T10:30:00.000Z", "version": "1.0.0" }Get paginated list of names with optional filters by religion, gender, origin, and more.
GET /api/v1/names
| Parameter | Type | Default | Description |
|---|---|---|---|
religion | string | islamic | islamic | christian | hindu |
page | number | 1 | Page number |
limit | number | 50 | Items per page (max: 100) |
gender | string | - | male | female |
origin | string | - | Filter by origin |
startsWith | string | - | Filter by starting letter |
sort | string | asc | asc | desc |
curl "https://namverse-api.vercel.app/api/v1/names?religion=islamic&gender=male&limit=10"Search names across all religions or filter by specific religion. Minimum 2 characters required.
GET /api/v1/names/search
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | Yes | Search query (min: 2 chars) |
religion | string | No | islamic | christian | hindu |
limit | number | No | Results limit (default: 20, max: 50) |
curl "https://namverse-api.vercel.app/api/v1/names/search?q=ali&limit=10"Get available filter options for a religion including genders and available letters.
GET /api/v1/names/:religion/filters
| Parameter | Type | Description |
|---|---|---|
religion | string | islamic | christian | hindu |
curl "https://namverse-api.vercel.app/api/v1/names/islamic/filters"Get names starting with a specific letter for a religion.
GET /api/v1/names/:religion/letter/:letter
| Parameter | Type | Description |
|---|---|---|
religion | string | islamic | christian | hindu |
letter | string | Starting letter (A-Z) |
curl "https://namverse-api.vercel.app/api/v1/names/islamic/letter/A?limit=20"Get detailed information about a specific name including meaning, origin, lucky day, personality traits, and more.
GET /api/v1/names/:religion/:slug
| Parameter | Type | Description |
|---|---|---|
religion | string | islamic | christian | hindu |
slug | string | Name slug (lowercase, e.g., "muhammad") |
curl "https://namverse-api.vercel.app/api/v1/names/islamic/muhammad"Get phonetically similar names based on sound patterns.
GET /api/v1/names/:religion/:slug/similar
| Parameter | Type | Description |
|---|---|---|
religion | string | islamic | christian | hindu |
slug | string | Name slug |
curl "https://namverse-api.vercel.app/api/v1/names/islamic/ahmad/similar?limit=10"Get paginated list of articles with optional filters by category and status.
GET /api/v1/articles
| Parameter | Type | Default | Description |
|---|---|---|---|
page | number | 1 | Page number |
limit | number | 10 | Items per page (max: 50) |
category | string | - | Filter by category |
sort | string | newest | newest | oldest | popular |
curl "https://namverse-api.vercel.app/api/v1/articles?page=1&limit=10"Get the most recently published articles.
GET /api/v1/articles/latest
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | number | 10 | Number of articles (max: 50) |
curl "https://namverse-api.vercel.app/api/v1/articles/latest?limit=5"Get all article categories with the count of articles in each category. No parameters required.
GET /api/v1/articles/categories
curl "https://namverse-api.vercel.app/api/v1/articles/categories"Search articles by keyword with full-text search. Minimum 2 characters required.
GET /api/v1/articles/search
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | Yes | Search query (min: 2 chars) |
page | number | No | Page number (default: 1) |
limit | number | No | Results per page (default: 10) |
curl "https://namverse-api.vercel.app/api/v1/articles/search?q=baby+names&limit=10"Get a single article with full content by its slug identifier.
GET /api/v1/articles/:slug
| Parameter | Type | Description |
|---|---|---|
slug | string | Article slug (lowercase, hyphenated) |
curl "https://namverse-api.vercel.app/api/v1/articles/modern-noahkwvrin"