API Documentation

Integrate Solvur's problem-solving engine directly into your own products, workflows, and internal tools.

API access is coming soon

The Solvur API is currently available to select Enterprise customers. Contact us to get early access and we'll set you up with an API key.

Request API Access

Overview

The Solvur API gives you programmatic access to the same strategic problem-solving engine that powers solvur.ai. Submit a problem, choose a focus mode, and receive structured recommendations you can use anywhere.

The API is REST-based, returns JSON, and uses API key authentication. All requests are made over HTTPS.

Base URL: https://solvur.ai/api/v1

Authentication

All API requests require an API key passed in the request header. You can generate an API key from your Enterprise account dashboard once access is granted.

# Include this header in every request
X-API-Key: your_api_key_here

Endpoint

POST/api/v1/solve

Submit a problem and receive strategic recommendations. This is the core endpoint of the Solvur API.

Request

Headers

Content-Type: application/json
X-API-Key: your_api_key_here

Body Parameters

{
  "goal": "I'm losing clients to cheaper competitors and can't justify my pricing.",
  "focus_mode": "creative",     // "creative" | "practical" | "safe"
  "num_paths": 3               // 1-5, default 3
}

Example Request

curl -X POST https://solvur.ai/api/v1/solve \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{
    "goal": "My SaaS sign-up flow has a 70% drop-off rate.",
    "focus_mode": "practical",
    "num_paths": 3
  }'

Response

A successful request returns a JSON object with an array of recommendations.

{
  "session_id": "rmle028b8mosjknem",
  "feed_summary": "Founder trying to reduce sign-up drop-off without a UX budget.",
  "recommendations": [
    {
      "tag": "Remove the Form",
      "summary": "Replace the sign-up form with a single email field.",
      "strategy": "Ask only for an email on sign-up...",
      "why_it_works": "Every additional field reduces completion by ~10%.",
      "steps": [
        "Remove all fields except email",
        "Send a magic link to complete setup",
        "Collect remaining info progressively"
      ]
    }
  ]
}

Errors

The API uses standard HTTP status codes.

OK              - Success
Bad Request     - Missing or invalid parameters
Unauthorized    - Invalid or missing API key
Too Many Requests - Rate limit exceeded
Server Error    - Something went wrong on our end

Rate Limits

API rate limits are based on your Enterprise plan. Limits reset every 24 hours. Your current usage and remaining quota are returned in the response headers:

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 287
X-RateLimit-Reset: 1746489600

Get Access

API access is available on the Enterprise plan. To get started, email us at sales@solvur.ai with a brief description of your use case and we'll set you up with an API key within 24 hours.