Documentation

Whether you're building AI agents or providing APIs, find everything you need to succeed with Solariz.

Documentation

Need help?

Contact Support
DocsAgentsSpecify Cluster Request

Specify Cluster Request

Harness the power of Solariz by targeting specific SOLARIZ cluster. Send natural language requests to grouped APIs and receive intelligent responses tailored to your needs.

What's a Cluster?

Cluster = Connected APIs + Solariz Intelligence

A cluster is a collection of related APIs grouped together. With the POWER OF SOLARIZ, you can send natural language requests to these clusters, and our AI will intelligently route your request to the right APIs and combine their responses to give you exactly what you need.

Instead of manually calling individual APIs and combining results, Solariz does the heavy lifting for you:

Focused API Selection

Target specific groups of related APIs for more precise results

💡 Travel cluster includes flights, hotels, weather, and activities

Faster Processing

Reduced search space means quicker responses and better performance

💡 Sub-second responses for domain-specific queries

Higher Accuracy

Context-aware routing within related APIs improves result quality

💡 99% accuracy for specialized domain queries

Request Types

Solariz handles two types of requests within clusters:

Simple Requests

Single API response for straightforward queries

Example

"What's the weather like in London?"

Uses only the Weather API to get current conditions

Weather API

Complex Requests

Multi-API orchestration for comprehensive solutions

Example

"Help me organise a 1 week trip from London to Barcelona for 2 adults include: flights, activities, weather and holidays during the stay"

Combines multiple APIs to create a complete travel plan

Flights APIWeather APIActivities APIHolidays API

Types of Clusters

Solariz offers three types of clusters to meet different needs and access levels:

Private Clusters

Exclusive clusters for organizations and developers with proprietary APIs

✨ Maximum security, custom integrations, full control

Public Clusters (Monetized)

Clusters created by you or your organization, shared publicly via the marketplace. Earn money based on usage by others.

✨ Monetization opportunities, visibility on marketplace, usage-based earnings

Marketplace Clusters

Community-shared clusters available to everyone

✨ Easy integration, community support, shared development

Example Cluster Request

Here's how to make a request to a specific cluster:

Request

curl -X POST https://api.solariz.ai/v1/public/cluster/query/<CLUSTER_ID> \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <YOUR_API_KEY>" \
  -d '{
    "query": "What is the weather like in London?",
    "queryType": "SIMPLE"
  }'

Response

{
  "success": true,
  "cluster_id": "<CLUSTER_ID>",
  "data": {
    "formatted_response": "The weather in London on June 9, 2025, is partly cloudy with a temperature of 16°C. The wind is coming from the west-southwest at 13 km/h. The humidity is 72%, and there is no precipitation. The air quality index indicates moderate levels of pollutants. Sunrise was at 4:44 AM, and sunset will be at 9:16 PM.",
    "raw_response": [
      {
            "status_code": 200,
            "body": {
                  "request": {
                        "type": "City",
                        "query": "London, United Kingdom",
                        "language": "en",
                        "unit": "m"
                  },
                  "location": {
                        "name": "London",
                        "country": "United Kingdom",
                        "region": "City of London, Greater London",
                        "lat": "51.517",
                        "lon": "-0.106",
                        "timezone_id": "Europe/London",
                        "localtime": "2025-06-09 10:06",
                        "localtime_epoch": 1749463560,
                        "utc_offset": "1.0"
                  },
                  "current": {
                        "observation_time": "09:06 AM",
                        "temperature": 16,
                        "weather_code": 116,
                        "weather_icons": [
                              "https://cdn.worldweatheronline.com/images/wsymbols01_png_64/wsymbol_0002_sunny_intervals.png"
                        ],
                        "weather_descriptions": [
                              "Partly cloudy"
                        ],
                        "astro": {
                              "sunrise": "04:44 AM",
                              "sunset": "09:16 PM",
                              "moonrise": "08:09 PM",
                              "moonset": "03:00 AM",
                              "moon_phase": "Waxing Gibbous",
                              "moon_illumination": 95
                        },
                        "air_quality": {
                              "co": "370",
                              "no2": "25.715",
                              "o3": "65",
                              "so2": "2.405",
                              "pm2_5": "24.42",
                              "pm10": "30.71",
                              "us-epa-index": "2",
                              "gb-defra-index": "2"
                        },
                        "wind_speed": 13,
                        "wind_degree": 243,
                        "wind_dir": "WSW",
                        "pressure": 1022,
                        "precip": 0,
                        "humidity": 72,
                        "cloudcover": 50,
                        "feelslike": 16,
                        "uv_index": 3,
                        "visibility": 10,
                        "is_day": "yes"
                  }
            },
            "endpoint": "/current"
      }
],
    "api_used": "Weather API",
    "endpoints_used": "/current",
    "status_code": 200,
    "success": true
  },
  "message": "Weather information for London retrieved successfully from the Weather cluster."
}

🎯 Targeted Intelligence

By specifying a cluster ID, Solariz focuses only on the relevant APIs within that domain, resulting in faster responses and more accurate results tailored to your specific use case.

Cluster vs Universal Gateway

Universal Gateway

  • Best for exploration and general queries
  • Searches across all available APIs
  • Slower response times

Cluster Requests

  • Faster, more accurate responses
  • Cost-effective for focused use cases

Ready to Use Cluster Requests?

Explore our marketplace to find the perfect clusters for your use case, or create your own private clusters for enhanced performance and security.

Browse Cluster Marketplace
Next
API Provider Introduction