API Documentation

Base URL: https://nicheshunter.com

Authentication

All requests require a valid API key sent via the Authorization header.

Authorization: Bearer nh_live_your_key_here

Rate Limits & Credits

Rate limit: 30 requests per minute per API key

Credits: Each endpoint costs a specific number of credits (1 credit = $0.01)

Minimum top-up: $10 (1,000 credits)

Response headers include X-Credits-Remaining and X-Credits-Used after each call.

Error Codes

401Invalid or missing API key

402Insufficient credits - top up your balance

429Rate limit exceeded - wait 60 seconds

400Bad request - missing required parameters

404Resource not found

500Server error

Endpoints

GET/api/v1/niches20 credits

List all analyzed niches with pagination.

Parameters

pageintegerPage number (default: 1)

categorystringFilter by category name

min_scoreintegerMinimum niche score

searchstringSearch by keyword in title (costs 10 credits)

Example Response

{
  "data": [
    {
      "display_code": "0042",
      "title": "AI Meditation Timer",
      "category": "Health & Fitness",
      "tags": ["meditation", "ai", "wellness"],
      "score": 87,
      "opportunity": "...",
      "source_type": "app_store",
      "published_at": "2026-02-20T..."
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 160,
    "total_pages": 8
  }
}

GET/api/v1/niches/:code85 credits

Get full details for a specific niche including market analysis, risks, tech stack, and marketing strategies.

Parameters

codestringNiche display code (e.g. 0042)

Example Response

{
  "data": {
    "code": "0042",
    "title": "AI Meditation Timer",
    "category": "Health & Fitness",
    "score": 87,
    "stats": { "competition": "Low", ... },
    "market_analysis": { ... },
    "key_learnings": [...],
    "risks": [...],
    "tech_stack": [...],
    "marketing_strategies": [...],
    "monetization": { ... },
    ...
  }
}

GET/api/v1/opportunities20 credits

List App Store opportunities detected by our scraper. Ranked by score.

Parameters

pageintegerPage number (default: 1)

categorystringFilter by App Store category

min_scorenumberMinimum opportunity score

countrystringFilter by country code (e.g. US, FR)

searchstringSearch by keyword in app name (costs 10 credits)

Example Response

{
  "data": [
    {
      "app_id": "...",
      "name": "Example App",
      "developer": "Example Inc.",
      "category_name": "Health & Fitness",
      "best_rank": 3,
      "avg_rank": 12.5,
      "days_in_top": 14,
      "total_score": 92.3,
      ...
    }
  ],
  "pagination": { ... }
}

GET/api/v1/rankings3 credits

Query raw App Store rankings data. At least one filter (country or category) is required.

Parameters

countrystringCountry code (e.g. US, FR, GB)

categorystringApp Store category name

datestringFilter by date (YYYY-MM-DD)

limitintegerMax results (default: 50, max: 100)

searchstringSearch by keyword in app name (costs 10 credits)

Example Response

{
  "data": [
    {
      "app_id": "...",
      "name": "Top App",
      "rank": 1,
      "country": "US",
      "category": "Productivity",
      "run_date": "2026-02-24",
      ...
    }
  ],
  "count": 50
}

GET/api/v1/categories1 credit

List all tracked App Store categories with their opportunity bonus scores.

Example Response

{
  "data": [
    {
      "category_name": "Health & Fitness",
      "bonus": 15,
      "tier": "gold"
    }
  ]
}