API Documentation

Online

Free access to Stock Quant AI research reports. Get recent reports, filter by ticker, or retrieve full analysis data.

Free to Use: This API is completely free. Just please credit stockquantai.com when using our data. Thank you!

Rate Limits

To ensure fair access for all users, the API enforces the following rate limits:

  • 60 requests per 60 seconds per IP address

If you exceed these limits, you'll receive a 429 Too Many Requests response. Please retry after the rate limit resets.

Endpoints

GET/api/recent

Returns a list of recent research reports, up to 100.

Query Parameters

limit(optional)

Number of reports to return. Default: 20, Max: 100

Example Request

curl "https://stockquantai.com/api/recent?limit=10"

Example Response

{
  "reports": [
    {
      "slug": "aapl-2026-02-07",
      "ticker": "AAPL",
      "company_name": "Apple Inc.",
      "analysis_date": "2026-02-07"
    },
    ...
  ],
  "count": 10
}
GET/api/ticker

Returns all research reports for a specific stock ticker.

Query Parameters

ticker(required)

Stock ticker symbol (e.g., AAPL, TSLA)

Example Request

curl "https://stockquantai.com/api/ticker?ticker=AAPL"

Example Response

{
  "reports": [
    {
      "slug": "aapl-2026-02-07",
      "ticker": "AAPL",
      "company_name": "Apple Inc.",
      "analysis_date": "2026-02-07"
    }
  ],
  "count": 1
}
GET/api/research

Returns the full research report for a specific slug.

Query Parameters

slug(required)

Report slug identifier (e.g., aapl-2026-02-08). Get slugs from /api/recent or /api/ticker.

Example Request

curl "https://stockquantai.com/api/research?slug=aapl-2026-02-08"

Example Response

{
  "report": {
    "id": 1,
    "ticker": "AAPL",
    "company_name": "Apple Inc.",
    "slug": "aapl-2026-02-07",
    "current_price": "278.12",
    "analysis_date": "2026-02-07",
    "seo_title": "Apple Inc. (AAPL) Stock Analysis",
    "seo_description": "AI-powered equity research...",
    "content": {
      "verdict": "bull",
      "executive_summary": "...",
      "price_targets": { ... },
      "cases": { ... },
      "key_metrics": { ... },
      "micro_analysis": [ ... ],
      "macro_analysis": [ ... ],
      "revenue_opportunities": [ ... ],
      "headwinds": [ ... ],
      "tailwinds": [ ... ],
      "technical_snapshot": { ... }
    },
    "summary": "...",
    "status": "published",
    "error_message": null,
    "created_at": "2026-02-08T10:00:00Z",
    "updated_at": "2026-02-08T10:00:00Z"
  }
}

Error Responses

400 Bad Request

Missing or invalid parameters.

404 Not Found

Report not found for the given slug.

429 Too Many Requests

Rate limit exceeded. Retry after the limit resets.

500 Internal Server Error

Server error. Please try again later.

Need Help?

Questions or feedback about the API? Reach out at /support. We'd love to hear what you're building!