How to define which domain will be used when calling the API?
If you use Twitter clients like Tweetdeck (click here for setup details) or web based services like dlvr.it for instance, you can use our API to set up automatic shortcuts from your posts, etc. (click here for setup details).
By default, the system will take the first domain name available and assign it to your shortcut. But, if you want to choose your preferred domain name, you need to add one variable in the URL endpoint settings.
The variable to add is “domain::ddd” (without quotes) where ddd is the ID number of the chosen domain. For example, for ✰.ws you would use “domain::2”.
The URL then becomes:
http://qoiob.com/api/shorten/?theKitchenSink=login::xxx||apiKey::zzz||format::txt||domain::ddd||longUrl::yyy
or
http://cauzes.com/api/shorten/?theKitchenSink=login::xxx||apiKey::zzz||format::txt||domain::ddd||longUrl::yyy
(Note: there is no space after the ? or anywhere in the URL)
-
Here is the list of available on qoiob.com and cauzes.com, and their respective IDs:
qoiob
➪.ws : ID=1
✰.ws : ID=2
ツ.tv : ID=3
⍥.ws : ID=5
▶.ws : ID=6
☎.ws : ID=7
♘.ws : ID=8
♟.ws : ID=9
tcho.net : ID=10
viio.net : ID=11
xoxi.net : ID=4
모.ws : ID=12
ᄒ.ws : ID=13
ж.tv : ID=14
cauzes
☾oe✡is†.ws : ID=1
eatlessmeat.ws : ID=2
freeburma.ws : ID=3
freetibet.ws : ID=4
givetojapan.ch : ID=9
nomoreplastic.ch : ID=8
pastafari.ws : ID=5
renewableenergies.ch : ID=7
stopnuclear.ch : ID=6
We will update this page when we add new domain options.
-
Comments? Questions? Tell us what you think at twitter.com/qoiob_com
How to use qoiob with Tweetdeck?
Tweetdeck is a popular client for Twitter, which automatically shortens URLs while you are typing tweets. To have it use qoiob for your own shortcuts, simply follow these very easy setup steps.
1. Create your qoiob account.
You must have a qoiob account to get your own personal API key. To create an account, all you need to do is to create your first shortcut on www.qoiob.com and the validation email sent to your address will allow you to access your account page to find your API key (read more about it here).
If you already have an qoiob account, then you already have an API key. Simply login and visit your account page to find it.
2. Set up Tweetdeck
Open the Settings menu in Tweetdeck by clicking the “settings” button, in the top-right corner of the screen.

There you will find a “Services” menu on the left-hand side. Click on it.

Then, select “Other” in the drop-down menu of URLs shorteners.
In the input field “Other URL Shortening Endpoint”, enter the following string, after you replaced “xxx” by your qoiob login email address, and “zzz” by your API key. Variables are separated by ||.
http://qoiob.com/api/shorten/?theKitchenSink=login::xxx||apiKey::zzz||format::txt||longUrl::%@
(Note: there should be no space after the ? or anywhere else in the string.)
Click the “Save settings” button.
3. Activate auto-shortening in Tweetdeck
With “auto-shortening” enabled in the update window, TweetDeck will automatically shorten any URLs that you type or paste into the update box. If auto-shortening is not yet enabled, turn it on by clicking the
button (more about auto-shortening on Tweetdeck’s support site).
Can I choose which domain will be used when new shortcuts are created automatically from the API?
Yes, read this post for more details on how to set the endpoint link.
-
Comments? Questions? Tell us what you think at twitter.com/qoiob_com
How to use qoiob on an iPhone?
qoiob bookmarklet on iPhone
These instructions will help you make a qoiob bookmarklet on your iPhone, so you can shorten links directly from Safari in one click.
Step 1: Bookmark This Page
Tap the plus button at the bottom of the screen, then select Add Bookmark.

Name your bookmarklet something like “qoiob”, save it in your “Bookmarks” folder, then tap Save.

Step 2: Edit The Bookmark
Copy the link below. To do so, simply tap and keep your finger on the text for a few seconds, then choose “Copy”.
[ Copy the link of this text ]
Tap the Bookmarks button at the bottom of the screen.

Find the bookmark you just made. Tap Edit, then tap on the bookmark itself.
To modify the bookmark URL, tap the URL field (it begins with “http:”), erase all content, then replace it with the text you just copied (just tap once in the empty field and then choose “Paste”).

Then, delete everything that comes before “JavaScript:” (i.e., “http://____”).
The finished URL should look like this:

Step 3: Use The Bookmarklet
First, go to qoiob.com and sign into your account. You will only need to do this once, and the system will remember you next time you visit. (You can log out at any time.)
When you’re surfing the web and want make a shortcut link to share or bookmark for later, just tap the Bookmarks button, then tap “qoiob”. The current link will be sent to qoiob, where you can choose a keyword, and share it on Twitter, Facebook, etc.

-
Comments? Questions? Tell us what you think at twitter.com/qoiob_com
