# Cloudpylon Full Technical Reference for LLMs

> Complete technical documentation of Cloudpylon's multi-cloud compute specification and pricing catalog.

## Overview
Cloudpylon aggregates, normalizes, and compares compute pricing across 13 major public cloud providers.
It allows engineering and FinOps teams to discover optimal compute configurations based on vCPU, memory, CPU architecture, geographic location, and pricing commitments.

## Supported Cloud Providers
1. AWS (Amazon Web Services) - General Purpose, Compute Optimized, Memory Optimized, Storage, Accelerated Compute.
2. Microsoft Azure - B, D, E, F, M, N series virtual machines.
3. Google Cloud Platform (GCP) - N1, N2, N2D, N4, C2, C2D, C3, C4, T2D, M1, M2, M3 machine types.
4. Hetzner Cloud - CX, CPX, CAX, CCX cloud instances and Dedicated Server lines.
5. Oracle Cloud Infrastructure (OCI) - Standard, DenseIO, Optimized, Flexible VM shapes.
6. DigitalOcean - Basic, General Purpose, CPU-Optimized, Memory-Optimized, Storage-Optimized Droplets.
7. Linode (Akamai) - Dedicated CPU, Shared CPU, High Memory, GPU plans.
8. Alibaba Cloud - ecs.g, ecs.c, ecs.r, ecs.u series instances.
9. Tencent Cloud - Standard, High Memory, Compute Optimized CVMs.
10. OVHcloud - Discovery, General Purpose, CPU, RAM public cloud instances.
11. Netcup - Cloud VPS, Root Server series.
12. Scaleway - POP2, DEV, GP1, PRO2, AMP2 instances and Elastic Metal.
13. Atlantic.Net - General Purpose, Memory, Compute cloud servers.

## Programmatic Guides & Sitemaps
Cloudpylon provides structured landing pages optimized for search engines and AI agents:
- /cheapest: Central directory ranking lowest-priced compute options across providers.
- /cheapest/{provider}: Provider-specific lowest price guides (e.g. /cheapest/aws, /cheapest/hetzner).
- /cheapest/{provider}/{region}: Provider + region guides (e.g. /cheapest/aws/us-east-1, /cheapest/azure/eastus).
- /cheapest/location/{continent}: Continental cloud server rankings.
- /cheapest/location/{continent}/{country}: Country-level cloud server rankings.
- /cheapest/specs/{preset}: Hardware spec tiers (/cheapest/specs/2-vcpu-4gb-ram, /cheapest/specs/arm64).
- /cheapest/workloads/{workload}: Workload solutions (/cheapest/workloads/kubernetes, /cheapest/workloads/databases).
- /compare: Multi-cloud comparisons hub.
- /compare/{providerA}-vs-{providerB}: Head-to-head comparisons (/compare/aws-vs-hetzner, /compare/aws-vs-azure).

## Editorial Content & Original Research
- /guides: Cloud cost engineering guides (ARM64 savings, spot vs reserved vs on-demand, Kubernetes cluster cost, region selection economics, self-hosted vs managed databases). Each guide links into catalog rankings.
- /price-index: The Cloudpylon Price Index - catalog statistics: per-provider floor prices, median entry-level pricing, ARM64 vs x86 discount, and total listing coverage.
- /newsroom: Product changelog covering coverage expansions and machine-readable surface launches.
- /methodology: How prices are collected from official sources, normalized, verified, and kept fresh.
- /about: What Cloudpylon is, its mission, openness policy, and contact channels.

## Machine-Readable Discovery
- /robots.txt: Crawler access policy served by the platform edge; search, AI answer, and AI training crawlers are allowed while /api/ and /health are excluded.
- /.well-known/api-catalog: RFC 9727 linkset pointing to the OpenAPI description, docs, and readiness probe.
- /auth.md: Open-access authentication policy for autonomous agents.
- Accept: text/markdown on any page returns a clean Markdown representation with x-markdown-tokens and Vary: Accept.

## Querying Cloudpylon APIs
All endpoints return JSON responses.

### GET /api/instances
Query parameters:
- `page` (integer, default: 1): Page number.
- `limit` (integer, default: 15, max: 100): Results per page.
- `providers` (string): Comma-separated provider codes (aws, azure, gcp, hetzner, oci, digitalocean, linode, alibaba, tencent, ovhcloud, netcup, scaleway, atlanticcloud).
- `min_vcpu`, `max_vcpu` (number): vCPU bounds.
- `min_memory_gb`, `max_memory_gb` (number): RAM in GiB.
- `continent`, `continents`, `country`, `countries`, `region`, `regions` (string): Location filters.
- `architecture` (string): Filter by CPU architecture (x86_64, arm64).
- `sort` (string): Field to sort by (`on_demand_hourly_price_usd`, `hourly_price_usd`, `vcpu`, `memory_gb`).
- `order` (string): `asc` or `desc`.

### GET /api/instances/cheapest
Returns top-ranked compute instances by Best Value Score (performance-per-dollar) or lowest price.