Quickstart: make your first cloro API request - cloro
Introduction
Quickstart: make your first cloro API request
Get started with the cloro API in minutes. Learn how to get your API key, make your first monitoring request, and understand the response structure.
This guide takes you from an API key to your first monitoring response.
Navigate to header: 1. Get your API key 1. Get your API key
You can find your API key in your
dashboard
.
New accounts start on the
free tier
, so you can test the API before subscribing to a paid plan.
Navigate to header: 2. Make your first request 2. Make your first request
All cloro monitoring endpoints are
POST
endpoints that expect a JSON body and a bearer-token
Authorization
header. You cannot call them by pasting a URL into a browser address bar (that would send a
GET
with no body). Use any of these instead:
The Playground in the dashboard. It needs no API key: it sends the request as you, and shows the response as JSON, as the rendered page, and as the code for the same request. Requests use your organization’s credits.
curl in a terminal (shown below)
A GUI HTTP client such as Postman , Insomnia , or Bruno
Code — see the Python and TypeScript integration guides
An AI coding assistant — give it the llms.txt URLs , then ask it to build the request
The request drives a real ChatGPT session, so it takes longer than a typical API call: see
typical latency
.
Navigate to header: 3. See the response 3. See the response
{
"success"
:
true
,
"result"
: {
"text"
:
"Acme Corp is a fictional corporation that appears in many cartoons."
,
"sources"
: []
}
}
Navigate to header: Next steps Next steps
Authentication — create and manage your API keys
Synchronous requests — shared request and response structure
ChatGPT endpoint — every field in the response
Providers — endpoint costs and feature support
Was this page helpful?
Ask a question...
Navigate to header: 1. Get your API key
Navigate to header: 2. Make your first request
Navigate to header: 3. See the response
Navigate to header: Next steps
curl
curl
-X
POST
"https://api.cloro.dev/v1/monitor/chatgpt"
\
-H
"Authorization: Bearer YOUR_API_KEY"
\
-H
"Content-Type: application/json"
\
-d
'{
"prompt": "What do you know about Acme Corp?",
"country": "US"
}'
Method: POST
URL: https://api.cloro.dev/v1/monitor/chatgpt
Headers:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Body (raw JSON):
{
"prompt": "What do you know about Acme Corp?",
"country": "US"
}