The URLgenius REST API allows you to query meta-data about your deeplinks. You can view this information both inside your dashboard and from within the API. Creating deeplinks and getting stats on those deeplinks is easy.
Since the API is based on REST principles, it's very easy to write and test applications. You can use your browser to access URLs, and you can use pretty much any HTTP client in any programming language to interact with the API.
In order to receive access to the API, please send a request to info@urlgeni.us and let us know how you might envision using the API.
We currently do not enforce any limitations to the number of requests you can make.
Breaking changes to the API will be rolled out via versions in the URL path. All prior versions will remain enabled and documented.
Current Version: v1
Access to the API end points is handle by way of an API token. All requests which come into the API must have the appropriate header record set to send the token. Any actions initiated by the API with the account token can affect deeplinks created via the UI and visa versa.
Add a header of HTTP_AUTHORIZATION and set to the token generated by the system.
Rails users may need to use encode_credentials
ActionController::HttpAuthentication::Token.encode_credentials("token")
All URLs referenced in the documentation have the following base:
https://api.urlgeni.us/
The URLgenius REST API is served over HTTPS. To ensure data privacy, unencrypted HTTP is not supported.
A link resource is the core of the URLgenius API and represents a deeplink into a mobile application. Once a deeplink is created, it is added to the account of the token holder. You can retrieve statistics about that deeplink, delete the deeplink, get a list of deeplinks, and of course create them with a single parameter.
To retrieve all of the deeplinks associated with the account, make an HTTP GET request to this end point:
https://api.urlgeni.us/v1/links
To receive statistics and more information about a deeplink, make an HTTP GET request to this end point:
https://api.urlgeni.us/v1/links/:id
To remove a deeplink from your account, send an HTTP DELETE request to this end point:
https://api.urlgeni.us/v1/links/:id
To create a deeplink, make an HTTP POST request to this end point:
https://api.urlgeni.us/v1/links
Required Parameters
| Parameter | Description |
|---|---|
| URL | The web URL of the resource you wish to deeplink into. Our system will take the URL and automatically create the routes to get mobile users into the applications. |
Supported Applications
