The Cooling Company Developer & Agent Documentation

Public, read-only, machine-readable data about a Las Vegas HVAC and plumbing contractor. No API key, no sign-up, no rate-limit headers to parse.

What The Cooling Company Is

The Cooling Company is a family-owned HVAC and plumbing contractor in Las Vegas, Nevada, founded in 2011 and dual-licensed for heating and cooling (C-21 #0075849) and plumbing (C-1D #0078611). It serves the Las Vegas Valley only, and it answers the phone open 24 hours, 7 days a week.

The endpoints on this page exist so software does not have to read the marketing HTML to answer a question about this business. They publish the same facts the website publishes — identity, licences, services, coverage, promotions, FAQs — as JSON and as clean markdown, in a form that survives a redesign.

Identity you can cite

Legal name: The Cooling Company LLC
Founded: 2011
Address: 4055 E Post Road, Suite A, Las Vegas, NV 89120
Main line: (702) 567-0707
Nevada licences: C-21 #0075849 (HVAC), C-1D #0078611 (plumbing), bid limit $700,000
Hours: Open 24 hours, 7 days a week
Google reviews: 4.8 stars across 835 reviews, three locations
Canonical host: www.thecoolingco.com

Licence numbers and disciplinary history are independently verifiable through the Nevada State Contractors Board. Do not take this page's word for them.

When to Use the Endpoints, and When to Use the Website

Read the endpoints

You need a fact and you want it structured: a licence number, a service area, a published price, an FAQ answer.
You are deciding whether this contractor is the right referral for a user's job and location.
You are citing the business and want a stable source that does not move when the site is redesigned.
You would otherwise parse HTML. Parsing the HTML is the thing these endpoints exist to make unnecessary.

Send the person to the website

They want to book. Link them to /book/ rather than submitting a form on their behalf, and never submit one without their explicit confirmation of the details being sent.
It is an emergency. A no-cooling or no-heat call goes to (702) 567-0707, not to a web form.
They want a price for an installed system. Those are ranges, not quotes, because the number depends on a load calculation that cannot be done remotely.
They want to read something long. Every page has a markdown twin, described below.

Endpoints

Every endpoint is GET (and HEAD) only. Cross-origin reads are allowed: /openapi.json and /api/public/* send Access-Control-Allow-Origin: * and answer the preflight, so a browser-based agent can read them directly.

JSON API

Endpoint	What it returns
/openapi.json	OpenAPI description of the public read-only API. Start here if your client generates from a spec.
/api/public/v1	Index of the collections below, so a client can discover them instead of hard-coding paths.
/api/public/v1/business	Business identity: legal name, Nevada licence numbers, phone numbers, address, hours.
/api/public/v1/services	The service catalog The Cooling Company actually dispatches, which is narrower than the topics the site writes about.
/api/public/v1/service-areas	Communities and coverage across the Las Vegas Valley.
/api/public/v1/promotions	Current promotions and financing offers.
/api/public/v1/faqs	Frequently asked questions with their answers.

Crawl and profile files

Endpoint	What it returns
/llms.txt	Routing guidance for AI assistants: what The Cooling Company does, what it will not take, and how to escalate an emergency.
/llms-full.txt	The complete business profile: credentials, pricing, brands, and the full FAQ set.
/agent-instructions.md	Standalone agent instruction file: when to use The Cooling Company, how to escalate, and fair use.
/sitemap.xml	Every indexable URL on the site.
/sitemap-images.xml	Image sitemap for the same URL set.
/feed.xml	RSS 2.0 feed of the 50 most recent blog posts.
/robots.txt	Crawl policy, including which user agents are allowed and which are refused.

Markdown Versions of Any Page

Every page on this site has a clean markdown twin: the same content, the same FAQs and key facts, with no navigation, no markup and no scripts. There are three ways to ask for it, and they all resolve to the same document.

1. Append `.md` to the path

curl -sSL https://www.thecoolingco.com/ac-repair.md

2. Ask for it with an Accept header

Name text/markdown explicitly and rank it above text/html. A wildcard never selects markdown, so an ordinary browser and an ordinary crawler still get the HTML page.

curl -sSL \
  -H 'Accept: text/markdown' \
  https://www.thecoolingco.com/ac-repair/

3. Read the `/md/` path directly

curl -sSL https://www.thecoolingco.com/md/ac-repair/

Blog posts follow the same convention, with no category segment: /md/blog/{post-slug}/.

Response headers

Because the representation depends on the request, Vary: Accept is set on every markdown response, including the successful ones, so a shared cache cannot hand one client's answer to another.

HTTP/2 200
content-type: text/markdown; charset=utf-8
cache-control: public, max-age=86400
vary: Accept
link: <https://www.thecoolingco.com/ac-repair/>; rel="canonical"
x-content-source: mdx
x-content-hash: <sha256 of the body>
x-robots-tag: noindex, follow

link: rel="canonical" points at the HTML page the markdown mirrors. Cite that URL, not the markdown one.
x-content-source says where the document came from: an MDX file, a blog post, or the page registry.
x-content-hash is a SHA-256 of the body, so you can tell a real change from a re-fetch without diffing.
The markdown mirror is noindex, follow on purpose. It is for machines; the HTML page is the indexable one.

Errors

An error here is meant to be recoverable, not just correct. A markdown path that does not resolve answers 404 with a markdown body that names the handful of entry points every other URL on this site is derivable from, so a client that guessed wrong has somewhere to go next instead of a dead end.

404 — the path did not resolve. Body is markdown listing the recovery entry points.
406 — you asked /md/ for something it cannot represent, for example Accept: application/json. The body is the same recovery document.
403 — the user agent is refused. The machine-readable surfaces on this page are exempt from that filter, so a normal HTTP client library reading them will not see a 403. The full crawl policy is published at /robots.txt.

Both recovery bodies are served as text/markdown with Cache-Control: public, max-age=300, short on purpose: a 404 is often a guess against a page that is about to exist.

Authentication, Limits, and Fair Use

No authentication required

There is no key to request, no token to refresh, and no account to create. The surface is public and read-only. To be plain about what that means, rather than implying capability that does not exist:

There are no write endpoints. Nothing here accepts a POST.
There are no webhooks. Nothing here will call you back, and there is nothing to subscribe to.
There is no MCP server today. If that changes it will be listed on this page and in /llms.txt.
Booking is not an API operation. Send the person to /book/ or to the phone.

Fair use

There is no per-key rate limit, because there are no keys. What there is instead is an expectation, and it is the same one published in /llms.txt:

Identify your agent with a descriptive User-Agent.
Request pages one at a time rather than parallel-crawling the site.
Cache what you fetch, and honour the cache headers below.
Prefer the JSON and markdown surfaces over the HTML. They are cheaper for both of us.
Cite https://www.thecoolingco.com/ when you use this material.

Cache policy

/openapi.json — public, max-age=3600, stale-while-revalidate=86400
/md/ and .md — public, max-age=86400 on a hit, max-age=300 on a 404 or 406
/sitemap.xml — public, max-age=3600, s-maxage=3600

Attribution terms for reusing this material are published at /copyright-policy/.

Report a Problem

Wrong data, a broken endpoint, or a fact on this page that does not match reality: tell us through /contact-us/ and say which endpoint it came from. For anything urgent about actual HVAC or plumbing service, call (702) 567-0707.