API Reference for Developers

Getting Started

App Opener API ^v3 converts supported URLs into app-opening short links for 23+ platforms. Send a JSON POST with your URL and API key; you’ll get a JSON response with the generated link and status. This documentation covers endpoints, request/response, errors, and examples.

App Opener API ^v3

            POST : https://appopener.recut.in/v3/api

To shorten a link, you need to send a valid data in JSON via a POST request. The data must be sent as the raw body of your request as shown below. The example below shows all the parameters you can send but you are not required to send all (See table for more info).

Parameters	Description
url	(required) Long URL to shorten.
status	(optional) public or private (default)

Link privacy. Private = analytics are not public. Public = anyone with the short link can view its analytics page.

            async function shorten(url,status) {
    const response = await fetch("https://appopener.recut.in/v3/api", {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json'
        },
        body: JSON.stringify({ url:url,status:status})
    })
    const data = await response.json()
    console.log(data);
}

shorten('https://www.youtube.com/@youtube','public')

            curl -X POST "https://appopener.recut.in/v3/api" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/@youtube","status":"public"}'

            import requests

response = requests.post(
    "https://appopener.recut.in/v3/api",
    json={"url": "https://www.youtube.com/@youtube","status":"public"},
    headers={"Content-Type": "application/json"},
)
print(response.json())

Server response

            {
  "shorturl": "https://yt.rcut.in/s2tBFmML",
  "status": "public",
  "provider": "youtube",
  "domain": "https://yt.rcut.in",
  "devicetarget": [
    { "device": "iPhone", "link": "vnd.youtube://www.youtube.com/@youtube" },
    { "device": "iPad",   "link": "vnd.youtube://www.youtube.com/@youtube" },
    {
      "device": "Android",
      "link": "intent://www.youtube.com/@youtube#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url=https%3A%2F%2Fwww.youtube.com%2F%40youtube;end"
    }
  ],
  "deeplink": {
    "apple": "https://apps.apple.com/us/app/youtube-watch-listen-stream/id544007664",
    "google": "https://play.google.com/store/apps/details?id=com.google.android.youtube"
  },
  "powered-by": "Recut URL Shortener API, https://app.recut.in/developers"
}

Response Handling

All API response are returned in JSON format by default. To convert this into usable data, the appropriate function will need to be used according to the language. In PHP, the function json_decode() can be used to convert the data to either an object (default). It is very important to check the error key as that provides information on whether there was an error or not. You can also check the header code.

Tip

Always send Content-Type: application/json.
Use POST to create a short link. GET is not allowed for this endpoint.
Make sure url is a full URL with https://.

Errors (examples)

            { "error": "url is required & must be a valid URL" }

            { "error": 1, "message": "URL parameter is missing" }

            { "error": "Method not allowed. Use POST" }

23 Apps We Open for You

We support 23 popular apps. Create links that open directly in the app—Instagram, YouTube, WhatsApp, Amazon, Facebook, TikTok and more. Better reach, more sales.