A Great First Day: The First Step of Smart Onboarding
Resources
Post Your Resume to 65+ Job Sites
Resume Service
-
Share API - Developer Tools - Shareaholic Use the Web Share API to share content to 200+ supported destinations.
100% free to use, reliable, fast. Used by millions every day.
Get More Traffic
Enable your visitors to share articles, comments, purchases or other activities from your site to their friends on multiple social networks. You've already got customers that love your product or service. Profit from helping them tell the world about it. The Share API is free to use, and helps you grow your bottom line and traffic without growing your marketing budget.
Share API Documentation
Shareaholic provides social APIs to connect your site or application to each of the major social networks for sharing. If you can’t use the Shareaholic JavaScript SDK, you can link to these API endpoints directly. With these APIs you can customize the social sharing experience for your users to match the look and feel of your site or application.
Designed for Ease
All API methods are accessible via simple HTTP calls. We have optimized for ease of implementation, so you won’t see anything complicated. Most implementations of this API take less than 15 minutes to setup. Simply hit the provided URLs with their respective parameters, and you're done.
Getting Started: Authentication
All API endpoints require authentication credentials to be supplied as query arguments. To get started, you'll need a free Shareaholic user account and Site ID. Signup for an account and then add your site to get your Site ID. The Site ID is your API Key.
Example:
...&apikey=8943b7fd64cd8b1770ff5affa9a9437b&...
Note: the apikey used in this document is intended for use as an example only.
Share Content with over 200+ (and growing!) Destination Services
Let your users share content from any website, desktop app, mobile app, etc to any supported destination service.
Endpoint:https://www.shareaholic.com/api/share/?v=1Parameter Description Required Example vAPI Version Required v=1 apitypeAPI Type Required apitype=1 (1=Redirect, 2=Pingback, 3=1x1 pixel) apikeyAPI Key Required apikey=8943b7fd64cd8b1770ff5affa9a9437b serviceDestination Service Required service=7 (lookup codes) linkLink Required link=http://www.yoursite.com titlePage Title Optional title=My%20Awesome%20Webpage notesNotes Optional notes=I%20love%20this! short_linkShortened Link Optional short_link=http://bit.ly/1OTIqm shortenerURL Shortener Optional shortener=shrlc (tinyurl|bitly|jmp|google|shrlc|none) shortener_keyURL Shortener Credentials Optional shortener_key=shareaholic|R_83932e4c5d02d1f94aea0f40fbc557ec templateTemplate Optional template=Reading: ${title} tagsTags Optional tags=programming,python,howto sourceSource Optional source=shareaholic Working Example (posting a link to Facebook):
<a href="https://www.shareaholic.com/api/share/?v=1&apitype=1&apikey=8943b7fd64cd8b1770ff5affa9a9437b&service=5&title=The%20Hottest%20VC%20No%20One%20Has%20Ever%20Heard%20Of&link=http://www.robgo.org/post/376467064/the-hottest-vc-no-one-has-ever-heard-of&shortener=google&source=Shareaholic" target="_blank">Post to Facebook</a>
Give it a try: Post to Facebook
Notes:
link,short_link,title, andnotesparameters should be URL-encoded, plain text, no HTML, UTF-8. You can not include a parameter value in the request that has '&', '?', '#', ' ', or other reserved parameters without first encoding it.- Parameters should not contain spaces: any parameter with spaces will be rejected. All spaces should be either percent encoded (%20) or plus encoded (+). Note that tabs, newlines and trailing spaces are all indications of errors. Please remember to strip leading and trailing whitespace from any user input before posting.
- Parameters must have a slash between the domain and the path component. For example, http://example.com?query=parameter is invalid, and instead should be formatted as http://example.com/?query=parameter
linkparameter value should be a complete URL and not a shortened link (like a bit.ly short link). You should always pass shortened links (ex. you may want to do this for Twitter) through theshort_linkparameter.
Link Tracking & URL Shorteners
Shareaholic can automatically shorten the
linkfor you using a supported shortening service that you specify....&shortener=google...
We currently support the following shorteners/parameter values:
Shortener Description google tinyurl bitly jmp shrlc Default none Do not shorten link You can further customize this option with your own bit.ly or j.mp account if you'd like by passing the
shortener_keyparameter. If you pass this, the API will use your key to shorten the link....&shortener=bitly&shortener_key=shareaholic|R_83932e4c5d02d1f94aea0f40fbc557ec&...
shortener_keyformat: username|apikey (i.e. delimited by "|"). For su.pr, you just need to pass your apikey.Note that this setting will only shorten links for services where it is appropriate (i.e. sharing to Twitter, but not bookmarking in Google Bookmarks or Delicious).
Templates i.e. customize your Tweets
By specifying the
templateAPI parameter, you can customize the default post format for services that support templates. Specifying atemplateis completely optional. The following services currently support templates:The Share API supports a few different tokens in a template — you can use all, some, or none of them:
Template Token Description ${title} Title of the page ${link} Link to the page ${short_link} Short link that you pass to the Share API ${notes} Any text; usually a very short summary of the link or user selected text Sample
templatefor Twitter:...&template=Reading: ${title} (${short_link}) via @Shareaholic %23api %23devtools&...Result:
Give it a try: Tweet this!
Tags (describe your content)
Use the optional
tagsAPI parameter to further describe the content/URL being shared. Amongst many other benefits, you will get back more useful analytics tracking reports as a result.tagstakes a set of comma-separated values (CSV) with no trailing comma. Commas inside tag values MUST be URL encoded (as %2C) and commas separating tags MUST NOT be encoded. For example, the tags "python", "conference" and "Boston, MA" should be passed as:...&tags=python,conference,boston%2Cma&...
You can pass in as many tags as you'd like, but we've found 3-5 to be most optimal.
Destination Service Codes
Popular Services:
Service Service Code ID Facebook 5 Twitter 7 Pinterest 309 LinkedIn 88 Google Bookmarks 74 Google Mail 52 PrintFriendly 236 Yahoo! Mail 54 All Services:
Service Service Code ID AIM 50 Allvoices 63 Amazon (CA) Wish List 271 Amazon (DE) Wish List 272 Amazon (FR) Wish List 273 Amazon (JP) Wish List 274 Amazon (UK) Wish List 270 Amazon (US) Wish List 200 AOL Mail 55 Arto 194 Ask.com MyStuff 91 AttentionMeter 221 Backflip 97 Balatarin 241 Bebo 196 BibSonomy 25 Bit.ly 208 Bitty Browser 108 Blinklist 48 Blogger Post 219 BlogMarks 27 BobrDobr 266 Bookmarks.fr 35 Box.net 240 BuddyMarks 90 Buzzster 1 Care2 News 104 CiteULike 13 Clicky.me 248 Connotea 96 Current 80 DailyMe 237 Delicious 2 Design Float 106 Digg 3 Digg Bar 224 Diglog 72 diHITT 244 Diigo 24 Dwellicious 251 DZone 102 Email This 313 Evernote 191 Expression 186 Facebook 5 Fark 62 Faves 49 Favoriten 242 Feedmarker Bookmarks 69 Folkd 197 Followup.cc 235 FriendFeed 43 FunP 17 Furl 11 Gabbr 183 Global Grind 89 Google Apps Mail 260 Google Bookmarks 74 Google Mail 52 Google Plus +1 304 Google Sidewiki 275 Google Translate 252 Google Wave 262 Gravee 95 Hatena 246 HelloTxt 81 Hemidemi 16 HootSuite 261 Hotmail 53 Hub.tm 234 Hugg 71 Hyves 105 Identi.ca 205 Imera Brazil 65 Instapaper 18 Is.gd 228 iZeby 263 j.mp 249 Jamespot 64 Jumptags 14 Khabbr 31 Kledy 30 LinkaGoGo 67 Linkatopia 85 LinkedIn 88 LiveJournal 79 Ma.gnolia 23 Mail 201 Maple 93 Memori.ru 269 Mename 33 MindBodyGreen 68 Mister-Wong 6 Mixx 4 Moemesto 268 Mozillaca 231 MSDN 184 Multiply 42 MyLinkVault 98 MySpace 39 Netlog 8 Netvibes Share 195 Netvouz 21 NewsTrust 199 NewsVine 41 Ning 264 NowPublic 75 NUjij 238 Oknotizie 243 Oneview 84 Orkut 247 PhoneFavs 19 Pinboard.in 256 Ping 45 Pinterest 309 Plaxo Pulse 44 Plurk 218 Posterous 210 PrintFriendly 236 Propeller 77 Protopage Bookmarks 47 Pusha 59 Read It Later 239 ReadWriteWeb 250 Reddit 40 Segnalo 58 Shoutwire 12 Simpy 86 SiteJot 99 Slashdot 61 SmakNews 206 Soup.io 217 Sphere 107 Sphinn 100 SpringPad 265 Spurl 82 Squidoo 46 StartAid 29 Strands 190 Streakr 215 StumbleUpon 38 Stumpedia 192 Su.pr 232 Svejo 245 Symbaloo Feeds 103 Taggly 26 Tagza 187 Tailrank 28 Techmeme 204 TechNet 185 Technorati Favorites 10 Technotizie 36 TinyURL 223 Tipd 188 Tr.im 214 Truemors 203 Tumblr 78 Tweetie 226 Twiddla 66 Twine 216 Twitter 7 TypePad Post 220 unalog 70 Viadeo 92 VodPod 198 Webnews 57 Windows Live Favorites 37 Windows Live Spaces 15 Wink 22 Wists 94 WordPress 230 Xerpi 20 Yahoo Bookmarks 76 Yahoo Buzz 73 Yahoo Buzz India 254 Yahoo Messenger 87 Yahoo! Mail 54 Yammer 253 Yample 83 Yandex 267 YC Hacker News 202 YiGG 56 Yoolink 34 YouMob 60 Feedback
If you believe you have found a bug, or you’d like to request additional functionality, or you release something using this API, we’d love to hear from you.
