Bulk import and export of short links

When you have tens or thousands of URLs to shorten, upload them in one CSV file instead of creating each link by hand. Every row becomes a normal short link that you can edit, share and track like any other.

Note

Bulk creation depends on your plan. Each created row costs the same as creating it by hand, and importing or exporting adds no extra cost. See the credits page for the details. Feature Credits

Import short links from a CSV file

1. Open URL Shortener in the dashboard and choose Bulk import.

2. Download the CSV template, fill one row per link and save it as CSV.

3. Upload the file and pick the defaults that apply to rows that leave a column empty, such as the template or the tag.

4. Check the file. Posty5 reads every row without creating anything and lists the rows that would fail.

5. Start the import. You can leave the page, and a notification tells you when it has finished.

The file’s columns

Only the url column is required. Column names are not case-sensitive, and a column Posty5 does not know is ignored and reported in the check step.

Column
url	The destination address. Required. baseUrl is accepted as another name for it.
name	A name for your own list. Left empty, Posty5 fills it from the page title in the background.
customId	Your own ending for the short link, when your plan allows custom IDs. It must be unused, including by an earlier row of the same file.
tag	A tag to group and filter the links later.
refId	Your own reference, for example a product code from your system.
templateId	The QR code template of this row. It overrides the default you picked.

url,name,customId,tag,refId,templateId
https://example.com/spring-sale,Spring sale,,spring,,

Save the file as UTF-8 CSV with commas and a header row. Values that contain commas go in double quotes, as spreadsheet apps do on their own.

Checking the file

The check runs the same rules as creating a link by hand and shows each failing row with its row number, counting from the first row under the header. A row fails when

• the URL is missing, is not a valid web address, or is longer than 2,048 characters
• the URL is blocked as unsafe
• a name, tag or reference is longer than 255 characters
• the custom ID is not allowed on your plan, is invalid, or is already in use
• the template does not exist or is not yours

Limits

• One file holds up to 5,000 rows and 2 MB.
• You can create up to 20,000 rows in bulk per day (UTC), counting every import and API call together.
• One import runs at a time, and up to three more can wait for it.
• If your credits run out during an import, that row and every row after it fail with Not enough credits, and the links already created stay.

Progress

The import page shows how many rows were processed, created and failed, and refreshes on its own. You can cancel a running import; the links created before the cancel stay.

Page titles and app deep links are fetched in the background after each link is created, so a link may show its host as its name for a short while.

The results file

When the import finishes, download its results file. It has one line per row of your file.

Column
row	The row number in your file, counting from the first row under the header.
status	created, failed, skipped, or notProcessed when the import stopped before reaching the row.
id, shortUrl	The new link’s ID and short address.
errors	Why the row failed.

A second file holds only the failed rows with your original values, so you can fix them and upload that file again.

Past imports

Bulk jobs lists your recent imports with their status and counts. Open one to see its progress or download its files again.

Caution

Uploaded files and result files are kept for 7 days and an import’s record for 30 days. Download what you need before then. The links themselves are never removed.

Bulk creation through the API

Developers can send up to 100 rows in one request and get one result per row back at once, or submit a file of up to 5,000 rows as a job and poll it. The same limits and checks apply, and the request honours an Idempotency-Key header so a retried request does not create links twice. The routes are documented in the API reference (Swagger).

• POST /api/short-link/bulk
• POST /api/link-bulk-jobs
• GET /api/short-link/export

Export your links

From the short-link list, choose Export CSV or Export JSON to download your links with their visit counters.

• The export uses the filters that are applied to the list, so filter first to export only part of it.
• One export holds up to 50,000 rows, newest first. A longer list is cut there, and the file says so in its last line (CSV) or its truncated field (JSON).
• A cell that starts with = + - or @ gets a leading apostrophe in the CSV, so that a spreadsheet app shows it as text instead of running it as a formula.