Welcome to Tiny1z API Integration, a powerful tool that allows you to seamlessly integrate Tiny1z features into your applications. Whether you're looking to shorten URLs, track analytics, or enhance user experiences, Tiny1z API Integration has got you covered.
\nTo start using Tiny1z API Integration, follow these simple steps:
\nObtain an API Key:
\nSign up for a Tiny1z account at https://tiny1z.com/signup.
\nAccess your \"API key\" from the Tiny1z developer dashboard.
\nAPI Requests:
\nAll requests must be made over HTTPS for security.
\nInclude your API key in the request Authorization header.
Response Format:
\nAPI responses are in JSON format.
\nError responses include an error key in the JSON response.
With each successful response you will get the following headers to keep track of your API quota:
\nX-used-api-quota: The consumed amount of your quota so far.
X-max-api-quota: The total amount of your quota.
X-remaining-api-quota: The remaining quota available for use.
Short URL creation APIs have a rate limit of 100 requests per minute. The response headers below are provided to monitor usage limits:
\nX-RateLimit-Limit: Indicates the current rate limit set.
X-RateLimit-Remaining: Displays the remaining rate limit quota available.
** Rate limits only apply to POST requests. GET Requests are not rate limited.
\nExplore our documentation, code examples, and other resources to make the most out of Tiny1z API Integration. Happy integrating! 🌐✨
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"24143355","collectionId":"4bbc8345-455f-4dfa-956f-da6454464f0a","publishedId":"2sA2xb5atb","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"E77728"},"publishDate":"2025-09-11T12:49:30.000Z"},"item":[{"name":"Create a short URL","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","id":"a08f2bec-5c9a-4cda-a4a5-5a1ad60c4e6c"}}],"id":"cb55b96c-5193-4e6a-85bc-2055959be597","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Authorization","value":"your-api-key","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"original_url\": \"string\",\r\n \"alias\": \"string\",\r\n \"password\": \"string\",\r\n \"expiry_duration\": \"decimal (9,2)\",\r\n \"expiry_unit\": \"string - accepts: 'hours', 'days' or 'months'\",\r\n \"user_reference\": \"string - any tag like a user_id or anything you wish to label this url with\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://tiny1z.com/api/v1/create","description":"Create a short URL using the Tiny1z API. Ensure that you set the Content-Type header to application/json in your request.
original_url (required) (String) : The original URL that you want to.
alias (String): An optional custom alias for the short.
password (String): An optional password to access the short.
expiry_duration (Number): The duration for which the short URL will be valid. Should be a number (e.g. 3).
expiry_unit (String): The unit of time for the duration. Accepts: 'hours', 'days', or 'months'.
user_reference (String): Any tag like a user_id or anything you wish to label this url with.
Create short URLs in bulk using the Tiny1z API. Ensure that you set the Content-Type header to application/json in your request.
* Parameters markerd with (\\) are required.
\n-- original_urls(*)(Array): An array of objects, each containing the details of an original url as follows:
url (*) (String): The original URL that you want to.alias (String): Any custom alias you would like to use as the short url slug.password (String or Null): An optional password to access the short URL. Can be a string or null.expiry_duration (Decimal): The duration for which the short URL will be valid. Should be a decimal number (e.g., 3.5).expiry_unit (String): The unit of time for the duration. Accepts: 'hours', 'days', or 'months'.-- global_password (String or Null): An optional global password to access all short URLs. Can be a string or null.
-- global_expiry_duration (Decimal): The global duration for which short URLs will be valid. Should be a decimal number (e.g., 3.5).
-- global_expiry_unit (String): The unit of time for the global duration. Accepts: 'hours', 'days', or 'months'.
-- user_reference (String): Any tag like a user_id or anything you wish to label this url with.
When including a URL in the 'original_urls' array, any values provided for 'global_password,' 'global_expiry_duration,' and 'global_expiry_unit' will be overridden by specific values for 'password,' 'expiry_duration,' and 'expiry_unit' for that URL. Ensure that you set the parameters appropriately at both the global and individual URL levels to achieve the desired settings.
Get user's created URLs by user_reference.
\nreference (required): the user_reference that is referenced when creating the url.Get the info of a single URL by url slug.
\nslug (required): the slug/alias of the short url you are trying to fetch.Get all your created API URLs.
\noffset (required, number): The starting index from which the data should be fetched.limit (required, number): The maximum number of rows to be fetched.sort (required, string): The sorting method for the fetch operation. Accepts only 'desc', 'asc', 'DESC', or 'ASC'.