Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: CarChat Segments API
version: 1.0.0
description: 'Live dealership inventory with buyer inquiry submission. Reads are free, open CORS, no API key. Built for AI agents shopping on behalf of car buyers. Human docs: https://carchat.io/agents'
servers:
- url: https://carchat.io
tags:
- name: Segments
paths:
/api/v1/segments:
get:
operationId: listSegments
summary: List curated shopping categories (buyer intent + metro)
description: Prefer this when a buyer's request matches a category such as used trucks under $25,000 in Knoxville. Each item includes a human page and a JSON twin.
responses:
'200':
description: Live shopping categories
content:
application/json:
schema:
type: object
properties:
count:
type: integer
computedAt:
type:
- string
- 'null'
segments:
type: array
items:
type: object
properties:
id:
type: string
label:
type: string
market:
type: object
properties:
city:
type: string
state:
type: string
vehicleCount:
type: integer
page:
type: string
json:
type: string
tags:
- Segments