OnlyWire | Social Media Auto-Submission

Developer API

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;