Skip to main content
GET
List of states
Returns the states available for state-level geo-targeting, which is supported for the US only. State targeting works on ChatGPT, Copilot, Perplexity, Gemini, and Grok; 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 state alongside country: "US":

Common questions

Can I use state with a non-US country?

It depends on the operation:
  • 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?

cloro routes your request through a proxy located in that US state, which changes the 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: