Last edited: 2024/12/31 12:40 (UTC+8)

This is the API documentation for the PicSee URL Shortener. PicSee offers Free, Basic, and Advanced Plans. For detailed information and documentation updates, please refer to the PicSee API official website: https://picsee.io/developers.

If you encounter issues while integrating**, please use Postman take screenshots**, and provide your PicSee ID with PicSee customer support. Please DO NOT share your code directly.
The API endpoint varies when upgrading to the "Dedicated Host (獨立主機)" or "Fixed IP Server (固定 IP)" plans. Don't hesitate to get in touch with PicSee for more details.

1. Get API Plans and Usage

One call per second is allowed. If this limit is exceeded, a status code **429** will be returned. A try-catch structure is recommended to retry.

Request

GET https://api.pics.ee/v2/my/api/status

Query Params (append to URL)

Response

Body Params (application/json)

2. Create a Short Link

As long as the request is within the plan's rate limit, you do not need to wait for the response and can make concurrent calls. If the rate limit is exceeded, a status code **429** will be returned. A try-catch structure is recommended to retry.

<aside> 💡 Once a Short Link is created or edited, it can be used immediately. However, due to the cache design, it may take up to 10 minutes to appear in the "Batch Records" on the PicSee website or the Short Link List and Short Link Analytics via the API.

</aside>

Request

POST https://api.pics.ee/v1/links

Params

Query Params (append to URL)

Body Params (application/json)