Read Existing Deep Link

Get
/url

This endpoint is used retrieve the deep link url details based on the provided parameter

Query parameters
url
stringRequired

The deep link url against which the details are to be fetched.

Examplehttps://example.app.link/{UNIQUE_PATH_HERE}
branch_key
stringRequired

The Branch key of the originating app; from your Branch Settings Dashboard

Examplekey_live_xxxx
Responses
200

Ok

Expand All
object
channel
string

Deep link channel

Examplefacebook
feature
string

Deep link feature set

Exampleonboarding
campaign
string

Campaig name

Examplenew product
stage
string
Examplenew user
tags
Array of string

Social media tags

string
Exampleone
data
object
~channel
string

Use channel to tag the route that your link reaches users. For example, tag links with 'Facebook' or 'LinkedIn' to help track clicks and installs through those paths separately

Examplefacebook
url
string

Deep link URL

Examplehttps://branch-demo.app.link/{UNIQUE_PATH_HERE}
$one_time_use
boolean
ExampleFalse
+url
string

Deep link URL

Examplehttps://branch-demo.app.link/{UNIQUE_PATH_HERE}
~creation_source
integer
Example0
$match_duration
integer
Example7200
$fallback_url
string

Change the redirect endpoint for all platforms - so you don't have to enable it by platform. Note that Branch will forward all robots to this URL, which overrides any OG tags entered in the link. System-wide Default URL (set in Link Settings)

Example
$identity_id
string

Deep link identity ID

Example00000000
$id
string

Deep link URL ID

Example00000000
$fallback_url_xx
string

Change the redirect endpoint for all platforms based on a lower-case Alpha-2 country code.

Example
$desktop_url
string

Redirect URL for desktop devices - mobile users will default to the app store.

Example
$ios_url
string

Change the redirect endpoint for iOS App Store page for your app (set in Link Settings)

Example
$ios_url_xx
string

Change the redirect endpoint for iOS based on a lower-case Alpha-2 country code. For example, $ios_url_de="..." would redirect Germany deep link clicks.

Example
$ipad_url
string

Change the redirect endpoint for iPads $ios_url value

Example
$android_url
string

Change the redirect endpoint for Android Play Store page for your app (set in Link Settings)

Example
$android_url_xx
string

Change the redirect endpoint for Android based on a lower-case Alpha-2 country code. For example, $android_url_de="..." would redirect Germany deep link clicks.

Example
$samsung_url
string

Redirect to Samsung Galaxy Store on Samsung devices. Only link level control. Format should be http://www.samsungapps.com/appquery/appDetail.as?appId={PACKAGE_NAME_HERE}

Example
$huawei_url
string

Redirect to the Huawei App Gallery on Huawei devices. Only link level control. Format should be https://appgallery.huawei.com/app/{HUAWEI_APP_GALLERY_ID_HERE}

Example
$windows_phone_url
string

Change the redirect endpoint for Windows OS Windows Phone default URL (set in Link Settings)

Example
$blackberry_url
string

Change the redirect endpoint for Blackberry OS BlackBerry default URL (set in Link Settings) Deep link channel

Example
$fire_url
string

Change the redirect endpoint for Amazon Fire OS Fire default URL (set in Link Settings)

ExampleFalse
$ios_wechat_url
string

Change the redirect endpoint for WeChat on iOS devices $ios_url value

Example
$android_wechat_url
string

Change the redirect endpoint for WeChat on Android devices $android_url value

Example
$web_only
boolean

Force to open the $fallback_url instead of the app

ExampleFalse
$desktop_web_only
boolean

Force to open the $windows_desktop_url, $mac_desktop_url, $desktop_url, or $fallback_url in this order of precedence instead of the app

ExampleFalse
$mobile_web_only
boolean

Force to open the$ios_url, $android_url, or $fallback_url in this order of precefdence instead of the app

ExampleFalse
$after_click_url
string

When a user returns to the browser after going to the app, take them to this URL. iOS only; Android coming soon

ExampleFalse
$afterclick_desktop_url
boolean

When a user on desktop returns to the desktop browser after going to the desktop app, take them to this URL.

ExampleFalse
$canonical_url
string

This is the url set against the identifier.

Examplehttp://www.example.com/content/123
$deeplink_path
string

The value of the deep link path that you would like us to append to your URI.

Exampleradio/station/456
$og_title
string

Set the title of the Deep Link as it will be seen in social media displays.

ExampleDeep Link title.
$og_description
string

Set the description of the Deep Link as it will be seen in social media displays.

ExampleDeep Link description.
$og_image_url
string

Set the image of the Deep Link as it will be seen in social media displays.

Examplehttp://www.lorempixel.com/400/400/
alias
string

Instead of our standard encoded short url, you can specify the vanity alias. For example, instead of a random string of characters/integers, you can set the vanity alias as .app.link/devonaustin.

Example
type
integer

Set type to 1, to make the URL a one-time use URL. It won't deep link after 1 successful deep link. Default is set to 0, which is the standard Branch links created via our SDK.git

Example0
duration
integer

In seconds. Only set this key if you want to override the match duration for deep link matching. This is the time that Branch allows a click to remain outstanding and be eligible to be matched with a new app session. This is default set to 7200 (2 hours).

Example7200
400

Authentication Failed

Result
"{\n    \"error\": {\n        \"message\": \"Authentication failed !\",\n        \"code\": 400\n    }\n}"
Expand All
object
error
object (inline_response_400_error)
message
string
ExampleAuthentication failed !
code
integer
Example400
429

Rate Limit Reached

Result
"{\n    \"error\": {\n        \"code\": 429,\n        \"message\": \"Rate limit reached.\"\n    }\n}"
Expand All
object
error
object (inline_response_400_error)
message
string
ExampleAuthentication failed !
code
integer
Example400