Developer API · Free

Free URL Shortener API

One POST endpoint, five actions. Send your API key as JSON and shorten, update, list, delete or search links from anywhere. No plans, no limits beyond a fair 10,000 links/day per key.

POST https://cuq.in/api

Get a free API key

One key per email. 10,000 links a day. Verify your email and it's yours. No account, no card.

Playground

Pick an action, fill the fields, and hit Send. You'll get a real-looking JSON response. Nothing is stored.

Action

// Send a request to see the JSON response here.

In your language

Reference

Actions

Actions
Action	Description	Required
`add`	Create a short link from a long URL. Returns status, shortCode and shortUrl.	apiKey · url
`update`	Point an existing shortCode at a new long URL. Returns the status.	apiKey · shortCode · url
`getAll`	Retrieve every short URL created with your API key. Returns an array.	apiKey
`delete`	Delete a short URL by its shortCode. Returns the status.	apiKey · shortCode
`search`	Search your URLs by keyword or long URL. Returns matching results.	apiKey · query

Request parameters

Request parameters
Parameter	Type	Req.	Description
`apiKey`	string	Yes	Your API key, required for every action.
`action`	string	Yes	One of add, update, delete, search, or getAll.
`url`	string	Cond.	The long URL to shorten (add / update).
`shortCode`	string	Cond.	The short code to act on (update / delete).
`query`	string	Cond.	Keyword or URL to look up (search).

Response structure

Response structure
Field	Type	Description
`status`	boolean	true on success, false on error.
`message`	string	Detail about the result, or an error message.
`code`	integer	HTTP status code (200 ok, 400 error).
`shortUrl`	string	The full shortened URL (add / update).
`results`	array	Array of links returned by getAll / search.

Something unclear or missing? Say hello. We usually reply within 48 hours.