Overview

The Trend Seeker API gives you programmatic access to our database of validated business ideas. Each idea is extracted from real online discussions and scored by evidence strength, market metrics, and validation confidence.

Base URL: https://api.trend-seeker.app/v1

All responses are JSON. The API uses standard HTTP status codes and returns errors in a consistent format.

Authentication

Pass your API key via the Authorization header or the X-API-Key header:

curl https://api.trend-seeker.app/v1/ideas \
  -H "Authorization: Bearer tskr_your_api_key"

You can also make unauthenticated requests. These are treated as free tier with lower rate limits and reduced data.

Generate API keys from the API Keys section on your profile page. Pro subscribers get higher rate limits and full data access.

Rate Limits

Rate limits reset on a rolling 60-second window. Exceeding limits returns HTTP 429.

Endpoints

GET /v1/ideas

Returns a paginated list of business ideas, sorted by opportunity score.

Query Parameters

Example (Pro)

curl "https://api.trend-seeker.app/v1/ideas?limit=5&categories=saas" \
  -H "Authorization: Bearer tskr_your_key"

{
  "data": [
    {
      "id": 1234,
      "business_idea_id": "idea_abc123",
      "title": "AI-powered code review for small teams",
      "tagline": "Automated PR reviews that catch bugs before humans do",
      "evidence_strength": {
        "volume": 0.85,
        "urgency": 0.72,
        "specificity": 0.91
      },
      "market_metrics": {
        "competition_level": "medium",
        "monetization_potential": "high",
        "opportunity_score": 0.88
      },
      "validation_score": 0.82,
      "confidence_tier": "premium",
      "categories": ["saas", "developer-tools"],
      "created_at": "2026-03-01T12:00:00Z",
      "updated_at": "2026-03-05T08:30:00Z",
      "post_count": 47
    }
  ],
  "meta": {
    "total": 342,
    "limit": 5,
    "offset": 0,
    "has_more": true
  }
}

Example (Free)

curl "https://api.trend-seeker.app/v1/ideas?limit=5"

{
  "data": [
    {
      "business_idea_id": "idea_abc123",
      "title": "AI-powered code review for small teams",
      "tagline": "Automated PR reviews that catch bugs before humans do",
      "categories": ["saas", "developer-tools"],
      "confidence_tier": "premium",
      "created_at": "2026-03-01T12:00:00Z"
    }
  ],
  "meta": {
    "total": 342,
    "limit": 5,
    "offset": 0,
    "has_more": true
  }
}

GET /v1/ideas/search

Search business ideas by keyword. Supports full-text search across titles, taglines, and problem descriptions. Pro users can also use semantic (embedding-based) search for meaning-based matching.

Query Parameters

Text Search Example

curl "https://api.trend-seeker.app/v1/ideas/search?q=audio+cleanup&limit=5" \
  -H "Authorization: Bearer tskr_your_key"

{
  "data": [
    {
      "id": 5678,
      "business_idea_id": "idea_xyz789",
      "title": "Instant AI Audio Restoration & Cleanup Tool",
      "tagline": "One-click noise removal and audio enhancement",
      "relevance": 0.42,
      "evidence_strength": { "volume": 0.78, "urgency": 0.65, "specificity": 0.82 },
      "market_metrics": { "competition_level": "low", "monetization_potential": "high" },
      "validation_score": 0.79,
      "confidence_tier": "premium",
      "categories": ["saas", "audio"],
      "created_at": "2026-03-10T08:00:00Z",
      "updated_at": "2026-03-12T14:20:00Z",
      "post_count": 23
    }
  ],
  "meta": { "total": 12, "limit": 5, "offset": 0, "has_more": true }
}

Semantic Search Example (Pro only)

Finds ideas by meaning rather than exact keywords. Useful for exploratory queries like "tools for people who hate making phone calls".

curl "https://api.trend-seeker.app/v1/ideas/search?q=tools+for+people+who+hate+phone+calls&mode=semantic&limit=5" \
  -H "Authorization: Bearer tskr_your_key"

{
  "data": [
    {
      "id": 9012,
      "business_idea_id": "idea_def456",
      "title": "AI Receptionist for Small Businesses",
      "tagline": "Never miss a customer call again",
      "relevance": 0.71,
      "evidence_strength": { "volume": 0.90, "urgency": 0.80, "specificity": 0.75 },
      "market_metrics": { "competition_level": "medium", "monetization_potential": "high" },
      "validation_score": 0.85,
      "confidence_tier": "free",
      "categories": ["saas", "automation"],
      "created_at": "2026-02-15T10:00:00Z",
      "updated_at": "2026-03-01T09:00:00Z",
      "post_count": 56
    }
  ],
  "meta": { "total": 5, "limit": 5, "offset": 0, "has_more": false }
}

GET /v1/ideas/:id

Returns full details for a single business idea. Pro users get all fields. Free users see solution_approach and why_now redacted for premium-tier ideas.

curl "https://api.trend-seeker.app/v1/ideas/idea_abc123" \
  -H "Authorization: Bearer tskr_your_key"

GET /v1/ideas/:id/posts

Returns source posts (Reddit discussions, forum posts) that contributed to an idea's evidence score. Free tier returns up to 5 posts, pro up to 100.

Query Parameters

curl "https://api.trend-seeker.app/v1/ideas/idea_abc123/posts?limit=3" \
  -H "Authorization: Bearer tskr_your_key"

{
  "data": [
    {
      "id": "post_xyz",
      "title": "Need a better way to review PRs in my 3-person team",
      "content": "We spend hours on code review...",
      "platform": "reddit",
      "url": "https://reddit.com/r/webdev/...",
      "created_at": "2026-02-28T15:30:00"
    }
  ]
}

GET /v1/categories

Returns all categories with idea counts. Useful for building filters.

curl "https://api.trend-seeker.app/v1/categories"

{
  "data": [
    { "category": "saas", "count": 342 },
    { "category": "ai-ml", "count": 287 },
    { "category": "fintech", "count": 156 }
  ]
}

Error Responses

All errors follow the same format:

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  }
}