Clico API

Name: Clico API API
Brand: Clico API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentDeveloper ToolsMonitoring ObservabilityapiKey7 EndpointsREST

For Agents

Mint and manage short links via Clico — create trackable URLs, read click statistics, and inspect the calling account, all behind a simple API key.

Connect the Clico API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Clico API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Install Jentic One Beta (Self-Hosted)

Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Clico API API.

Create a short link from a destination URL with optional custom alias

List the short links owned by the authenticated account

Update the destination of an existing short link

Delete a short link that is no longer needed

GET STARTED

Start building with Clico API API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI document for Clico API, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for Clico API, keeping it validated and agent-ready. The Clico API is a small, focused URL shortener service that lets clients create, list, update, and delete short links and read per-link click statistics. It authenticates with a simple X-API-Key header and exposes a flat resource model under /links plus an /account endpoint for the calling tenant. Agents can use it to mint trackable short URLs on demand and pull engagement counters back into reports or messages.

Use Cases

Patterns agents use Clico API API for, with concrete tasks.

★ Trackable Links in Outbound Messages

Mint a short URL programmatically every time a backend system sends a marketing email, SMS, or notification, then read /links/{id}/stats later to attribute engagement. The /links POST endpoint accepts a destination URL and optional alias and returns the short URL ready to embed. Wiring this in usually takes under a day.

Create a short link for 'https://example.com/landing' via POST /links and return the resulting short URL

Click Attribution Reporting

Pull per-link click statistics from Clico into a daily report or BI dashboard to attribute engagement back to the campaign or message that minted the link. The /links/{id}/stats endpoint returns total click counts for each short link, which is enough to drive a campaign-level dashboard. A simple sync job takes a few hours.

Fetch /links/{id}/stats for short link id 'abc123' and return the click count for the last 7 days

Lifecycle Management of Short Links

Keep the short link estate clean by listing existing links, updating destinations when a target page moves, and deleting links that are no longer needed. The /links collection plus /links/{id} endpoints are sufficient for a maintenance script that runs on a schedule. Setup is typically under a day.

List all links, find any pointing at the legacy /old-page destination, and update each to the new /new-page URL

Agent-Driven Short Link Operations via Jentic

Expose Clico to an AI agent through Jentic so a marketer or operator can ask the agent to mint a trackable link or read its stats in natural language. Jentic isolates the API key and surfaces only the relevant Clico operations for the intent. A working integration takes well under an hour.

Search Jentic for 'create a short link', load POST /links, and execute it for destination 'https://example.com/promo'

Key Endpoints

7 endpoints — jentic publishes the only available openapi specification for clico api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/links

Create a new short link

GET

/links

List short links for the account

GET

/links/{id}

Read a single short link

DELETE

/links/{id}

Delete a short link

GET

/links/{id}/stats

Read click statistics for a short link

GET

/account

Read account metadata for the API key

POST

/links

Create a new short link

GET

/links

List short links for the account

GET

/links/{id}

Read a single short link

DELETE

/links/{id}

Delete a short link

GET

/links/{id}/stats

Read click statistics for a short link

GET

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Clico X-API-Key values are stored encrypted in the Jentic vault. Agents receive scoped execution handles — the raw key never enters the agent context, so a leaked transcript cannot be replayed against the API.

Intent-based discovery

Agents search by intent (e.g., 'create a short link') and Jentic returns the matching Clico operation with its input schema, so the agent calls POST /links without browsing the reference.

Time to first call

Direct Clico integration: a few hours to wire the API key, payload shape, and stats polling. Through Jentic: under 15 minutes — search, load, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Bitly API

Established URL shortener with deeper analytics, branded domains, and QR codes

Choose Bitly when branded domains, QR codes, or richer analytics are required; Clico is preferred for a minimal API surface

Alternative

Rebrandly API

Branded short link platform with custom domain support

Choose Rebrandly when branded short domains and team workflows are required

Alternative

TinyURL API

Long-running, simple URL shortener

Choose TinyURL when only the most basic shortening is needed and you want the shortest possible integration

FAQs

Specific to using Clico API API through Jentic.

Why is there no official OpenAPI spec for Clico API?

Clico does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Clico API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Clico API use?

Clico uses a simple API key passed in the X-API-Key header on every request to https://cli.com/api/v1. When called through Jentic, the key is held in the Jentic vault and injected into outgoing requests — it never enters the agent context.

Can I create short links with a custom alias?

Yes. POST /links accepts a destination URL and optional alias. If the alias is omitted, Clico returns a randomly generated short id; otherwise it uses your alias as the short slug.

Can I read click statistics for a short link?

Yes. GET /links/{id}/stats returns the click counters for a single short link, which is enough to attribute engagement back to the message that minted it.

What are the rate limits for the Clico API?

Clico does not document fixed numeric rate limits in the public spec. In practice, treat /links creation as a low-rate operation (a few per second per key) and prefer batched listing via GET /links over per-id fetches.

How do I mint a short link through Jentic?

Run pip install jentic, search for 'create a short link', load POST /links, and execute with the destination URL. Jentic injects the X-API-Key header from the vault and returns the created short URL.