Skip to main content
GET
List of states

Overview

The States endpoint returns the states available for state-level geo-targeting. State targeting is only supported for the US — passing any other country code returns an empty array. State targeting is available on ChatGPT, Copilot, Perplexity, and Gemini. Google and AI Mode use the location / uule parameters for sub-country precision instead. Adding the state parameter to a monitor request adds +2 credits on top of the base cost and any other add-ons.

Request parameters

Example usage

Response

Response schema

Using states in monitor requests

Pass the code value as the state parameter in any supported monitor request alongside country: "US":

Common questions

Which providers support the state parameter?

ChatGPT, Copilot, Perplexity, and Gemini support the state parameter. Google Search and AI Mode use location / uule for sub-country targeting instead.

Can I use state with a non-US country?

It depends on which operation you’re calling:
  • GET /v1/states?country=GB (or any non-US country) — returns an empty array, no error.
  • state field in a monitor request (e.g., POST /v1/monitor/chatgpt) with a non-US country — returns a 400 validation error. The state field is only accepted when country is "US".

How does state targeting work?

When you provide state, cloro routes your request through a proxy located in that US state. This affects what local results, regional content, and location-specific information the AI provider returns.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

country
string
required

ISO 3166-1 alpha-2 country code. Only "US" returns results.

Required string length: 2
Pattern: ^[A-Z]{2}$

Response

List of supported states

code
string
required

USPS two-letter state code

Example:

"CA"

name
string
required

Full state name

Example:

"California"

Example: