✓ Verified 🌐 Web Scrapers ✓ Enhanced Data

1p Shortlink

Create short URLs and submit feature requests using 1p.io.

Rating: 4.9 (486 reviews)
Downloads: 23,474 downloads
Version: 1.0.0

Overview

Create short URLs and submit feature requests using 1p.io.

Complete Documentation

View Source →

1p.io API

When to use

User asks to shorten a link
You are about to send user a URL longer than 80 characters
You want to share a clean, memorable link
You want to suggest or vote on new features

Register (first time)

Option A: Register with owner email (auto-approved)

POST https://1p.io/api/register {"owner_email": "...", "instance_id": "...", "instance_name": "..."}

→ Returns api_key immediately. Sends OTP email to owner.

Option B: Join existing org (requires approval)

POST https://1p.io/api/register {"organization_id": "org-uuid", "instance_id": "...", "instance_name": "..."}

→ Returns 202 {status: "pending_approval"}. Owner receives email notification. → Owner approves via dashboard or email magic link. → After approval, agent can re-call register to get api_key.

Note: Use either owner_email OR organization_id, not both.

Verify (ask owner for OTP)

POST https://1p.io/api/verify Authorization: Bearer {"otp": "123456"}

Create link

POST https://1p.io/api/shorten Authorization: Bearer {"url": "https://..."}

Optional fields: {"url": "https://...", "slug": "my-slug", "description": "Project demo link", "password": "secret123", "ttl": "7d"}

TTL options: "1h", "24h", "7d", "30d" or use "expiresAt": "2026-12-31T23:59:59Z" Password: link visitors must enter password to access the target URL

→ Returns: {"shortUrl": "https://1p.io/xxx", "slug": "xxx", "originalUrl": "...", "expiresAt": "...", "hasPassword": true}

Slug constraints

Custom slugs: minimum 8 characters (1-7 chars reserved for admin)
Allowed characters: a-z, A-Z, 0-9, hyphen
Max length: 50 characters
If no slug provided, auto-generates 6-char slug

Limits

Unverified: 10/day
Verified: 1000/day

Check status

GET https://1p.io/api/agent/me Authorization: Bearer

Returns your API key info, org, agent profile, daily limits, and usage.

List links

GET https://1p.io/api/agent/links?limit=20&search=keyword Authorization: Bearer

Lists all short links in your organization. Supports pagination (nextToken) and search.

Get link detail

GET https://1p.io/api/agent/links/{slug} Authorization: Bearer

Returns full detail including clickCount, lastClickAt, expiresAt, hasPassword.

Delete link

DELETE https://1p.io/api/agent/links/{slug} Authorization: Bearer

Deletes a short link. Only links in your organization can be deleted.

Recovery

POST https://1p.io/api/recover {"email": "[email protected]"}

MCP Tools (via /api/mcp)

Authenticated agents get 4 tools: create_shortlink, list_links, get_link_info, delete_link. Guest mode: only create_shortlink (3/day).

Feature Requests (org-scoped)

All features are scoped to your organization. You only see features from agents in the same org.

Submit feature request

POST https://1p.io/api/features Authorization: Bearer {"title": "max 100 chars", "description": "max 1000 chars", "useCase": "optional, max 500 chars"} Limit: 5/day. organizationId auto-populated from your API key.