Public API Documentation
Access platform statistics and analytics via our public API
Overview
The nextappideas public API provides read-only access to platform statistics and trends. All endpoints are free to use and do not require authentication.
Base URL
https://nextappideas.com/api
Rate Limit
100 requests per hourFormat
JSONCORS
EnabledGET
/api/public/stats
Get public platform statistics including total users, ideas, and engagement metrics
Example Request
curl https://nextappideas.com/api/public/stats
Response
{
"stats": {
"totalUsers": 1250,
"totalIdeas": 450,
"totalVotes": 3200,
"totalComments": 890,
"launchedIdeas": 12,
"activeCategories": 15
},
"metrics": {
"avgVotesPerIdea": 7.11,
"avgCommentsPerIdea": 1.98,
"launchSuccessRate": 2.67
},
"topCategories": [
{
"category": "Social Media",
"count": 85
},
{
"category": "Productivity",
"count": 72
},
{
"category": "E-commerce",
"count": 54
}
],
"generatedAt": "2025-10-16T12:00:00.000Z",
"version": "1.0"
}
GET
/api/analytics/trending
Get trending ideas based on engagement
Query Parameters
period
24h | 7d | 30d | 90d (default: 7d)category
Filter by category (optional)limit
Number of results (default: 20, max: 100)Example Request
curl https://nextappideas.com/api/analytics/trending?period=7d&limit=10
GET
/api/analytics/categories
Get analytics broken down by category
Query Parameters
period
24h | 7d | 30d | 90d | all (default: 30d)Example Request
curl https://nextappideas.com/api/analytics/categories?period=30d
GET
/api/analytics/export
Export analytics data in CSV or JSON format
Query Parameters
format
json | csv (default: json)type
overview | ideas | users | categoriesperiod
24h | 7d | 30d | 90d | all (default: 30d)Example Request
curl https://nextappideas.com/api/analytics/export?format=csv&type=ideas&period=30d
Rate Limiting
To ensure fair usage, the API is rate limited to 100 requests per hour per IP address. Rate limit information is included in response headers:
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1634567890
Error Responses
400
Bad Request - Invalid parameters429
Too Many Requests - Rate limit exceeded500
Internal Server ErrorError Response Format
{
"error": "Rate limit exceeded",
"message": "You have exceeded the rate limit of 100 requests per hour"
}