ServerSearcher

Search dedicated, VPS, GPU and cloud server plans by specification, location, price and provider capability. Returns plans with on-site ServerSearcher URLs and affiliate checkout URLs.

{
  "type": "object",
  "properties": {
    "type": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "dedicated",
          "virtual",
          "cloud",
          "gpu"
        ]
      },
      "description": "Plan types to include. Omit for all types."
    },
    "minRam": {
      "type": "number",
      "description": "Minimum RAM in GB"
    },
    "minCpuCores": {
      "type": "number",
      "description": "Minimum CPU cores"
    },
    "minCpuThreads": {
      "type": "number",
      "description": "Minimum CPU threads"
    },
    "minBandwidth": {
      "type": "number",
      "description": "Minimum included bandwidth in TB per month"
    },
    "minPortSpeed": {
      "type": "number",
      "description": "Minimum network port speed in Mbps; matches either port"
    },
    "minDiskCapacity": {
      "type": "number",
      "description": "Minimum capacity of a single disk, in GB"
    },
    "diskTypes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Disk types, e.g. NVMe, SSD, HDD"
    },
    "gpuModel": {
      "type": "string",
      "description": "Exact GPU model name, e.g. \"NVIDIA H100\""
    },
    "minGpuCount": {
      "type": "number",
      "description": "Minimum number of GPUs"
    },
    "maxPrice": {
      "type": "number",
      "description": "Maximum listed monthly price, in the listed currency"
    },
    "currency": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "ISO 4217 currency codes to restrict prices to, e.g. [\"USD\",\"EUR\"]"
    },
    "location": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Locations: an ISO country code (\"DE\"), a country and city (\"DE-frankfurt\"), or a city id"
    },
    "provider": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Provider slugs (e.g. \"runpod\") or internal provider ids — slugs are what URLs and get_provider_info use and are resolved for you."
    },
    "cpuModel": {
      "type": "string",
      "description": "Substring of the CPU model, e.g. \"EPYC\". `*` and `?` are glob wildcards: \"EPYC*9004\" matches \"AMD EPYC 9004\"."
    },
    "minCpuFrequency": {
      "type": "number",
      "description": "Minimum CPU base frequency in GHz"
    },
    "cloudServices": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Restrict to providers offering any of these managed services, e.g. [\"OBJECT_STORAGE\",\"MANAGED_KUBERNETES\"]"
    },
    "hasTerraform": {
      "type": "boolean",
      "description": "Only providers with an official or community Terraform provider"
    },
    "sortConfig": {
      "type": "string",
      "enum": [
        "priceAsc",
        "priceDesc",
        "ramAsc",
        "ramDesc",
        "cpuAsc",
        "cpuDesc",
        "pricePerRam",
        "pricePerCpu",
        "pricePerRamCpu"
      ],
      "default": "priceAsc",
      "description": "Sort order. The pricePer* keys rank by USD price per unit of RAM or CPU."
    },
    "page": {
      "type": "number",
      "default": 1,
      "description": "Page number, 1-based"
    },
    "pageSize": {
      "type": "number",
      "default": 20,
      "description": "Results per page, maximum 150"
    }
  }
}

Get a hosting provider profile, plan counts, locations and on-site URLs from its ServerSearcher slug.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Provider slug, e.g. \"hetzner-cloud\""
    }
  },
  "required": [
    "slug"
  ]
}

Compare two hosting providers by slug, with the on-site comparison URL.

{
  "type": "object",
  "properties": {
    "slugA": {
      "type": "string",
      "description": "First provider slug"
    },
    "slugB": {
      "type": "string",
      "description": "Second provider slug"
    }
  },
  "required": [
    "slugA",
    "slugB"
  ]
}