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...

dashboard

free tier

typical latency

Navigate to header: 1. Get your API key

Navigate to header: 2. Make your first request

Playground

Python

TypeScript

llms.txt URLs

Navigate to header: 3. See the response

Navigate to header: Next steps

Authentication

Synchronous requests

ChatGPT endpoint

Providers

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"

}