multi_source_search

Run a single unified Valyu-style search across Oman companies, government procurement awards, Oman property comparables, and optional live web pages, returning relevance-ranked, citation-backed results.

When to use

Use when an agent wants cross-vertical evidence (companies, tenders, real estate, and web) in one call with responseLength context control and explicit primary-source grounding tiers.

Selection guidance

Role: supporting. Use when an agent wants cross-vertical evidence (companies, tenders, real estate, and web) in one call with responseLength context control and explicit primary-source grounding tiers.

Use cases

Access

Price: $0.35 USD per call. Payment options are deployment-configured; inspect /api/v1/payment-methods. Prices and payment semantics are unchanged from the canonical registry.

Get the full result

0.35 USD per call

Save with Monthly Plans & API Key Billing: Pay $0.35 per call, or get an instant API key at https://api.rafidsystem.com/get-started and save with monthly plans starting at $10/mo (1,000 calls) and Growth $50/mo (10,000 calls). See https://api.rafidsystem.com/api/v1/subscription-plans. View monthly plans · Payment methods
Pay with USDC · request an x402 challenge
curl -X POST 'https://api.rafidsystem.com/api/v1/x402/intelligence/multi-source-search' -H 'Content-Type: application/json' --data '{"query":"Al Noor Trading","sources":["oman_companies","oman_procurement"],"responseLength":"medium","maxResults":5}'
Authorized x402 client · signed retry request
curl -X POST 'https://api.rafidsystem.com/api/v1/x402/intelligence/multi-source-search' -H 'Content-Type: application/json' -H 'PAYMENT-SIGNATURE: <PAYMENT_SIGNATURE_FROM_AUTHORIZED_CLIENT>' -H 'X-Rafid-Payment-Journey: <PAYMENT_JOURNEY_FROM_CHALLENGE>' -H 'Idempotency-Key: <UNIQUE_REQUEST_ID>' --data '{"query":"Al Noor Trading","sources":["oman_companies","oman_procurement"],"responseLength":"medium","maxResults":5}'

Use an x402-compatible client to parse PAYMENT-REQUIRED and authorize payment before retrying the same input with PAYMENT-SIGNATURE. Copying a request does not pay.

No crypto wallet? Use Rafid Credits
curl -X POST 'https://api.rafidsystem.com/api/v1/intelligence/multi-source-search' -H 'Content-Type: application/json' -H 'Authorization: Bearer <RAFID_API_KEY>' -H 'X-Rafid-Payment-Method: credits' -H 'Idempotency-Key: <UNIQUE_REQUEST_ID>' -H 'X-Rafid-Payment-Journey: <PAYMENT_JOURNEY_FROM_CHALLENGE>' --data '{"query":"Al Noor Trading","sources":["oman_companies","oman_procurement"],"responseLength":"medium","maxResults":5}'

Create an API key instantly via POST https://api.rafidsystem.com/api/v1/account/signup or at https://api.rafidsystem.com/get-started, then fund by card (Stripe) or USDC and save with monthly plans ($10–$500/mo).

Existing account balance: GET https://api.rafidsystem.com/api/v1/account/balance.

MCP Credits integration
POST https://api.rafidsystem.com/mcp/credits
Authorization: Bearer <OAUTH_ACCESS_TOKEN>
Idempotency-Key: <UNIQUE_REQUEST_ID>
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "multi_source_search",
    "arguments": {
      "query": "Al Noor Trading",
      "sources": [
        "oman_companies",
        "oman_procurement"
      ],
      "responseLength": "medium",
      "maxResults": 5
    }
  }
}

OAuth metadata: authorization server · protected resource. Operator authorization and an existing funded account are required; OAuth does not grant credits.

Payment instructions and onboarding · API docs and schemas

These are copyable API integration requests. They do not open a checkout or execute a paid tool.

Related tools

Example input

{
  "query": "Al Noor Trading",
  "sources": [
    "oman_companies",
    "oman_procurement"
  ],
  "responseLength": "medium",
  "maxResults": 5
}

Example output

{
  "query": "Al Noor Trading",
  "sourcesQueried": [
    "oman_companies",
    "oman_procurement"
  ],
  "responseLength": "medium",
  "totalResults": 1,
  "results": [
    {
      "id": "company:demo-co-1",
      "source": "oman_companies",
      "title": "Al Noor Trading & Contracting LLC",
      "summary": "Al Noor Trading & Contracting LLC (active) — Muscat.",
      "relevanceScore": 0.94,
      "confidence": 0.94,
      "groundingTier": "demo_dataset",
      "citation": {
        "sourceName": "rafid-demo",
        "sourceType": "demo",
        "sourceUrl": null,
        "observedAt": "2026-01-01T00:00:00.000Z"
      }
    }
  ]
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300
    },
    "sources": {
      "minItems": 1,
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "oman_companies",
          "oman_procurement",
          "oman_property",
          "web"
        ]
      }
    },
    "responseLength": {
      "type": "string",
      "enum": [
        "short",
        "medium",
        "large"
      ]
    },
    "maxResults": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    },
    "governorate": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "propertyType": {
      "type": "string",
      "enum": [
        "apartment",
        "villa",
        "townhouse"
      ]
    },
    "webUrl": {
      "type": "string",
      "maxLength": 2048,
      "format": "uri"
    },
    "fields": {
      "minItems": 1,
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 120
      }
    },
    "outputSchema": {
      "type": "object",
      "propertyNames": {
        "type": "string",
        "minLength": 1,
        "maxLength": 80
      },
      "additionalProperties": {
        "type": "string",
        "minLength": 1,
        "maxLength": 120
      }
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "sourcesQueried": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "oman_companies",
          "oman_procurement",
          "oman_property",
          "web"
        ]
      }
    },
    "responseLength": {
      "type": "string",
      "enum": [
        "short",
        "medium",
        "large"
      ]
    },
    "totalResults": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "source": {
            "type": "string",
            "enum": [
              "oman_companies",
              "oman_procurement",
              "oman_property",
              "web"
            ]
          },
          "title": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "relevanceScore": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          },
          "confidence": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          },
          "groundingTier": {
            "type": "string",
            "enum": [
              "verified_primary_source",
              "market_comparable",
              "web_extract",
              "demo_dataset"
            ]
          },
          "citation": {
            "type": "object",
            "properties": {
              "sourceName": {
                "type": "string"
              },
              "sourceType": {
                "type": "string"
              },
              "sourceUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "observedAt": {
                "type": "string"
              }
            },
            "required": [
              "sourceName",
              "sourceType",
              "sourceUrl",
              "observedAt"
            ],
            "additionalProperties": false
          },
          "data": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {}
          }
        },
        "required": [
          "id",
          "source",
          "title",
          "summary",
          "relevanceScore",
          "confidence",
          "groundingTier",
          "citation"
        ],
        "additionalProperties": false
      }
    },
    "tableRows": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    }
  },
  "required": [
    "query",
    "sourcesQueried",
    "responseLength",
    "totalResults",
    "results"
  ],
  "additionalProperties": false
}

Category: Company & Risk Intelligence · hierarchy: supporting · idempotent: yes · side effects: no