Developer API

Do you want to intergrate your app? Contact Us

Documentation

  • Bookmark Submission URL:
    https://www.onlywire.com/api/add
  • Service List Request URL:
    https://www.onlywire.com/api/services
  • Submission Status List Request URL:
    https://www.onlywire.com/api/submissions
Bookmark Submission URL:
&url - (required) the URL of the item.
&title - (required) the title of the item.
&comments - (required) notes/comments for the item.
&tags - (required) tags for the item (comma delimited).
&service_logins - (optional) comma delimited service login IDs based on the service_login_id parameter from the Services API response. Will submit to all user registered networks if not provided.
&type - (optional) json
&schedule_date - (optional) (UTC) Format: Y-m-d H:i:s (e.g. 2013-12-31 23:59:59) or YmdHis (e.g. 20140101235959)
Please note that if Schedule Date is not mentioned then OnlyWire will randomly schedule your new articles over a 12 hour time period.
Services List Arguments:
&type - (optional) json
No additional arguments are required.
This API returns a list of all available services for the provided user.
Submission Status List Arguments:
&limit - (optional) number of latest submissions
No additional arguments are required. This API returns a list of user submissions with title, url and status indicating success or failure accompanied by error message if any. Default 1, Max 50.

Examples

Submit bookmarks to all your services:
https://www.onlywire.com/api/add?url=https://onlywire.com&title=OnlyWire&comments=onlywire%20API&tags=auto-submit
Default Response If the post was successful:
success
JSON response If the post was successful:
{"result":"success"}
Default response for service list request:
name,name_clean,supports_status,supports_bookmark,service_login_id
Bibsonomy,bibsonomy,no,yes,my-bibsonomy
Facebook,facebook,yes,yes,my-facebook
Facebook Group|group_name,facebook-group,yes,yes,my-facebook-group
Facebook Page|page_name,facebook-page,yes,yes,my-facebook-page
Folkd,folkd,no,yes,my-folkd
JSON response for service list request:
  [
    {
    "name":"Bibsonomy",
    "name_clean":"bibsonomy",
    "supports_status":"no",
    "supports_bookmark":"yes",
    "service_login_id":"my-bibsonomy"
    }
  ]
For submission status list request:
[
    {
    "scheduled_date":"2011-11-21 13:30",
    "title":"Content Submission Tools | OnlyWire",
    "url":"https://www.onlywire.com/",
    "service":"Delicious",
    "status":"success"
    }
]
Sample Code (PHP): The sample code below shows you how to authenticate and post to the OnlyWire API:
<?php


$ch = curl_init();

$url = urlencode("https://blog.onlywire.com");
$title = urlencode("OnlyWire Blog");
$comments = urlencode("OnlyWire Integration Testing");
$tags = urlencode("onlywire,bookmarking,blogging,submission");
$servicelogins = urlencode("my-facebook,my-folkd,my-bibsonomy");

$username= "your-username";
$password= "your-password";

$params = "url={$url}&title={$title}&tags={$tags}&comments={$comments}&service_logins={$servicelogins}&schedule_date=2013-01-01 12:59:59";

$query = "https://www.onlywire.com/api/add?{$params}";

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($ch, CURLOPT_URL, $query);
curl_setopt($ch, CURLOPT_USERPWD, $username.":".$password);

$output = curl_exec($ch);

curl_close ($ch);

echo $output;

?>

Supported Networks

Facebook
Bookmark: YES
Status: YES
Facebook Page
Bookmark: YES
Status: YES
Facebook Group
Bookmark: YES
Status: YES
Twitter
Bookmark: YES
Status: YES
Google+ Page
Bookmark: YES
Status: NO
Pinterest
Bookmark: YES
Status: NO
LinkedIn
Bookmark: YES
Status: YES
LinkedIn Company Pages
Bookmark: YES
Status: NO
24/7 ebookmark
Bookmark: YES
Status: NO
BagTheWeb
Bookmark: YES
Status: NO
Bitly
Bookmark: YES
Status: NO
Blogger
Bookmark: YES
Status: NO
Delicious
Bookmark: YES
Status: NO
Diigo
Bookmark: YES
Status: NO
Exchangle
Bookmark: YES
Status: NO
Feedspot
Bookmark: YES
Status: NO
Folkd
Bookmark: YES
Status: NO
Hi5
Bookmark: YES
Status: YES
Imgur
Bookmark: YES
Status: NO
Instapaper
Bookmark: YES
Status: NO
LinkaGoGo
Bookmark: YES
Status: NO
LiveJournal
Bookmark: YES
Status: NO
Medium
Bookmark: YES
Status: NO
MySpace
Bookmark: YES
Status: NO
Newsvine
Bookmark: YES
Status: NO
Plurk
Bookmark: YES
Status: YES
Pocket
Bookmark: YES
Status: NO
Reddit
Bookmark: YES
Status: NO
Skyrock
Bookmark: YES
Status: NO
Slashdot
Bookmark: YES
Status: NO
Sociable Bookmarker
Bookmark: YES
Status: NO
Stumbleupon
Bookmark: YES
Status: NO
Tagged
Bookmark: YES
Status: YES
Tumblr
Bookmark: YES
Status: NO
Wordpress
Bookmark: YES
Status: NO
Xing
Bookmark: YES
Status: NO