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 hour
Format
JSON
CORS
Enabled
GET

/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

period24h | 7d | 30d | 90d (default: 7d)
categoryFilter by category (optional)
limitNumber 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

period24h | 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

formatjson | csv (default: json)
typeoverview | ideas | users | categories
period24h | 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 parameters
429
Too Many Requests - Rate limit exceeded
500
Internal Server Error

Error Response Format

{
  "error": "Rate limit exceeded",
  "message": "You have exceeded the rate limit of 100 requests per hour"
}