%20Get%20More%20Traffic
%20Enable%20your%20visitors%20to%20share%20articles,%20comments,%20purchases%20or%20other%20activities%20from%20your%20site%20to%20their%20friends%20on%20multiple%20social%20networks.%20You've%20already%20got%20customers%20that%20love%20your%20product%20or%20service.%20Profit%20from%20helping%20them%20tell%20the%20world%20about%20it.%20The%20Share%20API%20is%20free%20to%20use,%20and%20helps%20you%20grow%20your%20bottom%20line%20and%20traffic%20without%20growing%20your%20marketing%20budget.
%20Share%20API%20Documentation
%20Shareaholic%20provides%20social%20APIs%20to%20connect%20your%20site%20or%20application%20to%20each%20of%20the%20major%20social%20networks%20for%20sharing.%20If%20you%20can’t%20use%20the%20Shareaholic%20JavaScript%20SDK,%20you%20can%20link%20to%20these%20API%20endpoints%20directly.%20With%20these%20APIs%20you%20can%20customize%20the%20social%20sharing%20experience%20for%20your%20users%20to%20match%20the%20look%20and%20feel%20of%20your%20site%20or%20application.
%20Designed%20for%20Ease
%20All%20API%20methods%20are%20accessible%20via%20simple%20HTTP%20calls.%20We%20have%20optimized%20for%20ease%20of%20implementation,%20so%20you%20won’t%20see%20anything%20complicated.%20Most%20implementations%20of%20this%20API%20take%20less%20than%2015%20minutes%20to%20setup.%20Simply%20hit%20the%20provided%20URLs%20with%20their%20respective%20parameters,%20and%20you're%20done.
%20Getting%20Started:%20Authentication
%20All%20API%20endpoints%20require%20authentication%20credentials%20to%20be%20supplied%20as%20query%20arguments.%20To%20get%20started,%20you'll%20need%20a%20free%20Shareaholic%20user%20account%20and%20Site%20ID.%20Signup%20for%20an%20account%20and%20then%20add%20your%20site%20to%20get%20your%20Site%20ID.%20The%20Site%20ID%20is%20your%20API%20Key.
%20Example:
%20%20...&apikey=8943b7fd64cd8b1770ff5affa9a9437b&...%20
%20%20Note:%20the%20apikey%20used%20in%20this%20document%20is%20intended%20for%20use%20as%20an%20example%20only.%20
%20Share%20Content%20with%20over%20200+%20(and%20growing!)%20Destination%20Services
%20Let%20your%20users%20share%20content%20from%20any%20website,%20desktop%20app,%20mobile%20app,%20etc%20to%20any%20supported%20destination%20service.
%20Endpoint:%20https://www.shareaholic.com/api/share/?v=1%20%20%20%20%20Parameter%20Description%20| Required | %20Example | %20
%20%20%20%20v%20 | API%20Version%20 | Required%20 | v=1%20 |
%20%20apitype%20 | API%20Type%20 | Required%20 | apitype=1%20(1=Redirect,%202=Pingback,%203=1x1%20pixel)%20 |
%20%20apikey%20 | API%20Key%20 | Required%20 | apikey=8943b7fd64cd8b1770ff5affa9a9437b%20 |
%20%20service%20 | Destination%20Service%20 | Required%20 | service=7%20(lookup%20codes)%20 |
%20%20link%20 | Link%20 | Required%20 | link=http://www.yoursite.com%20 |
%20%20title%20 | Page%20Title%20 | Optional%20 | title=My%20Awesome%20Webpage%20 |
%20%20notes%20 | Notes%20 | Optional%20 | notes=I%20love%20this!%20 |
%20%20short_link%20 | Shortened%20Link%20 | Optional%20 | short_link=http://bit.ly/1OTIqm%20 |
%20%20shortener%20 | URL%20Shortener%20 | Optional%20 | shortener=shrlc%20(tinyurl|bitly|jmp|google|shrlc|none)%20 |
%20%20shortener_key%20 | URL%20Shortener%20Credentials%20 | Optional%20 | shortener_key=shareaholic|R_83932e4c5d02d1f94aea0f40fbc557ec%20 |
%20%20template%20 | Template%20 | Optional%20 | template=Reading:%20${title}%20 |
%20%20tags%20 | Tags%20 | Optional%20 | tags=programming,python,howto%20 |
%20%20source%20 | Source%20 | Optional%20 | source=shareaholic%20 |
%20%20%20
%20Working%20Example%20(posting%20a%20link%20to%20Facebook):%20%20<a%20href="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"%20target="_blank">Post%20to%20Facebook</a>%20
%20Give%20it%20a%20try:%20Post%20to%20Facebook%20
%20Notes:%20%20link,%20short_link,%20title,%20and%20notes%20parameters%20should%20be%20URL-encoded,%20plain%20text,%20no%20HTML,%20UTF-8.%20You%20can%20not%20include%20a%20parameter%20value%20in%20the%20request%20that%20has%20'&',%20'?',%20'#',%20'%20',%20or%20other%20reserved%20parameters%20without%20first%20encoding%20it.%20Parameters%20should%20not%20contain%20spaces:%20any%20parameter%20with%20spaces%20will%20be%20rejected.%20All%20spaces%20should%20be%20either%20percent%20encoded%20(%20)%20or%20plus%20encoded%20(+).%20Note%20that%20tabs,%20newlines%20and%20trailing%20spaces%20are%20all%20indications%20of%20errors.%20Please%20remember%20to%20strip%20leading%20and%20trailing%20whitespace%20from%20any%20user%20input%20before%20posting.%20Parameters%20must%20have%20a%20slash%20between%20the%20domain%20and%20the%20path%20component.%20For%20example,%20http://example.com?query=parameter%20is%20invalid,%20and%20instead%20should%20be%20formatted%20as%20http://example.com/?query=parameter%20link%20parameter%20value%20should%20be%20a%20complete%20URL%20and%20not%20a%20shortened%20link%20(like%20a%20bit.ly%20short%20link).%20You%20should%20always%20pass%20shortened%20links%20(ex.%20you%20may%20want%20to%20do%20this%20for%20Twitter)%20through%20the%20short_link%20parameter.%20%20Link%20Tracking%20&%20URL%20Shorteners
%20Shareaholic%20can%20automatically%20shorten%20the%20link%20for%20you%20using%20a%20supported%20shortening%20service%20that%20you%20specify.%20...&shortener=google...%20We%20currently%20support%20the%20following%20shorteners/parameter%20values:
%20%20%20%20%20Shortener%20| Description | %20
%20%20%20%20| google%20 | %20 |
%20%20| tinyurl | %20 | %20
%20%20| bitly | %20 | %20
%20%20| jmp | %20 | %20
%20%20| shrlc | %20Default | %20
%20%20| none | %20Do%20not%20shorten%20link | %20
%20%20%20
%20You%20can%20further%20customize%20this%20option%20with%20your%20own%20bit.ly%20or%20j.mp%20account%20if%20you'd%20like%20by%20passing%20the%20shortener_key%20parameter.%20If%20you%20pass%20this,%20the%20API%20will%20use%20your%20key%20to%20shorten%20the%20link.
%20...&shortener=bitly&shortener_key=shareaholic|R_83932e4c5d02d1f94aea0f40fbc557ec&...%20shortener_key%20format:%20username|apikey%20(i.e.%20delimited%20by%20"|").%20For%20su.pr,%20you%20just%20need%20to%20pass%20your%20apikey.
%20Note%20that%20this%20setting%20will%20only%20shorten%20links%20for%20services%20where%20it%20is%20appropriate%20(i.e.%20sharing%20to%20Twitter,%20but%20not%20bookmarking%20in%20Google%20Bookmarks%20or%20Delicious).
%20Templates%20i.e.%20customize%20your%20Tweets
%20By%20specifying%20the%20template%20API%20parameter,%20you%20can%20customize%20the%20default%20post%20format%20for%20services%20that%20support%20templates.%20Specifying%20a%20template%20is%20completely%20optional.%20The%20following%20services%20currently%20support%20templates:
%20%20Twitter%20%20The%20Share%20API%20supports%20a%20few%20different%20tokens%20in%20a%20template%20—%20you%20can%20use%20all,%20some,%20or%20none%20of%20them:
%20%20%20%20%20Template%20Token%20| Description | %20
%20%20%20%20| ${title}%20 | Title%20of%20the%20page%20 |
%20%20| ${link} | %20Link%20to%20the%20page | %20
%20%20| ${short_link} | %20Short%20link%20that%20you%20pass%20to%20the%20Share%20API | %20
%20%20| ${notes} | %20Any%20text;%20usually%20a%20very%20short%20summary%20of%20the%20link%20or%20user%20selected%20text | %20
%20%20%20
%20Sample%20template%20for%20Twitter:
%20...&template=Reading:%20${title}%20(${short_link})%20via%20@Shareaholic%20%23api%20%23devtools&...%20Result:
%20%20%20
%20Give%20it%20a%20try:%20Tweet%20this!%20
%20Tags%20(describe%20your%20content)
%20Use%20the%20optional%20tags%20API%20parameter%20to%20further%20describe%20the%20content/URL%20being%20shared.%20Amongst%20many%20other%20benefits,%20you%20will%20get%20back%20more%20useful%20analytics%20tracking%20reports%20as%20a%20result.
%20tags%20takes%20a%20set%20of%20comma-separated%20values%20(CSV)%20with%20no%20trailing%20comma.%20Commas%20inside%20tag%20values%20MUST%20be%20URL%20encoded%20(as%20%2C)%20and%20commas%20separating%20tags%20MUST%20NOT%20be%20encoded.%20For%20example,%20the%20tags%20"python",%20"conference"%20and%20"Boston,%20MA"%20should%20be%20passed%20as:
%20...&tags=python,conference,boston%2Cma&...%20You%20can%20pass%20in%20as%20many%20tags%20as%20you'd%20like,%20but%20we've%20found%203-5%20to%20be%20most%20optimal.
%20Destination%20Service%20Codes%20Popular%20Services:%20%20%20%20Service%20| Service%20Code%20ID | %20
%20%20%20%20| Facebook%20 | 5%20 |
%20%20| Twitter | %207 | %20
%20%20| Pinterest | %20309 | %20
%20%20| LinkedIn | %2088 | %20
%20%20| Google%20Bookmarks | %2074 | %20
%20%20| Google%20Mail | %2052 | %20
%20%20| PrintFriendly | %20236 | %20
%20%20| Yahoo!%20Mail | %2054 | %20
%20%20%20
%20All%20Services:%20%20%20%20Service%20| Service%20Code%20ID | %20
%20%20%20%20| AIM%20 | 50%20 |
%20%20| Allvoices | %2063 | %20
%20%20| Amazon%20(CA)%20Wish%20List | %20271 | %20
%20%20| Amazon%20(DE)%20Wish%20List | %20272 | %20
%20%20| Amazon%20(FR)%20Wish%20List | %20273 | %20
%20%20| Amazon%20(JP)%20Wish%20List | %20274 | %20
%20%20| Amazon%20(UK)%20Wish%20List | %20270 | %20
%20%20| Amazon%20(US)%20Wish%20List | %20200 | %20
%20%20| AOL%20Mail | %2055 | %20
%20%20| Arto | %20194 | %20
%20%20| Ask.com%20MyStuff | %2091 | %20
%20%20| AttentionMeter | %20221 | %20
%20%20| Backflip | %2097 | %20
%20%20| Balatarin | %20241 | %20
%20%20| Bebo | %20196 | %20
%20%20| BibSonomy | %2025 | %20
%20%20| Bit.ly | %20208 | %20
%20%20| Bitty%20Browser | %20108 | %20
%20%20| Blinklist | %2048 | %20
%20%20| Blogger%20Post | %20219 | %20
%20%20| BlogMarks | %2027 | %20
%20%20| BobrDobr | %20266 | %20
%20%20| Bookmarks.fr | %2035 | %20
%20%20| Box.net | %20240 | %20
%20%20| BuddyMarks | %2090 | %20
%20%20| Buzzster | %201 | %20
%20%20| Care2%20News | %20104 | %20
%20%20| CiteULike | %2013 | %20
%20%20| Clicky.me | %20248 | %20
%20%20| Connotea | %2096 | %20
%20%20| Current | %2080 | %20
%20%20| DailyMe | %20237 | %20
%20%20| Delicious | %202 | %20
%20%20| Design%20Float | %20106 | %20
%20%20| Digg | %203 | %20
%20%20| Digg%20Bar | %20224 | %20
%20%20| Diglog | %2072 | %20
%20%20| diHITT | %20244 | %20
%20%20| Diigo | %2024 | %20
%20%20| Dwellicious | %20251 | %20
%20%20| DZone | %20102 | %20
%20%20| Email%20This | %20313 | %20
%20%20| Evernote | %20191 | %20
%20%20| Expression | %20186 | %20
%20%20| Facebook | %205 | %20
%20%20| Fark | %2062 | %20
%20%20| Faves | %2049 | %20
%20%20| Favoriten | %20242 | %20
%20%20| Feedmarker%20Bookmarks | %2069 | %20
%20%20| Folkd | %20197 | %20
%20%20| Followup.cc | %20235 | %20
%20%20| FriendFeed | %2043 | %20
%20%20| FunP | %2017 | %20
%20%20| Furl | %2011 | %20
%20%20| Gabbr | %20183 | %20
%20%20| Global%20Grind | %2089 | %20
%20%20| Google%20Apps%20Mail | %20260 | %20
%20%20| Google%20Bookmarks | %2074 | %20
%20%20| Google%20Mail | %2052 | %20
%20%20| Google%20Plus%20+1 | %20304 | %20
%20%20| Google%20Sidewiki | %20275 | %20
%20%20| Google%20Translate | %20252 | %20
%20%20| Google%20Wave | %20262 | %20
%20%20| Gravee | %2095 | %20
%20%20| Hatena | %20246 | %20
%20%20| HelloTxt | %2081 | %20
%20%20| Hemidemi | %2016 | %20
%20%20| HootSuite | %20261 | %20
%20%20| Hotmail | %2053 | %20
%20%20| Hub.tm | %20234 | %20
%20%20| Hugg | %2071 | %20
%20%20| Hyves | %20105 | %20
%20%20| Identi.ca | %20205 | %20
%20%20| Imera%20Brazil | %2065 | %20
%20%20| Instapaper | %2018 | %20
%20%20| Is.gd | %20228 | %20
%20%20| iZeby | %20263 | %20
%20%20| j.mp | %20249 | %20
%20%20| Jamespot | %2064 | %20
%20%20| Jumptags | %2014 | %20
%20%20| Khabbr | %2031 | %20
%20%20| Kledy | %2030 | %20
%20%20| LinkaGoGo | %2067 | %20
%20%20| Linkatopia | %2085 | %20
%20%20| LinkedIn | %2088 | %20
%20%20| LiveJournal | %2079 | %20
%20%20| Ma.gnolia | %2023 | %20
%20%20| Mail | %20201 | %20
%20%20| Maple | %2093 | %20
%20%20| Memori.ru | %20269 | %20
%20%20| Mename | %2033 | %20
%20%20| MindBodyGreen | %2068 | %20
%20%20| Mister-Wong | %206 | %20
%20%20| Mixx | %204 | %20
%20%20| Moemesto | %20268 | %20
%20%20| Mozillaca | %20231 | %20
%20%20| MSDN | %20184 | %20
%20%20| Multiply | %2042 | %20
%20%20| MyLinkVault | %2098 | %20
%20%20| MySpace | %2039 | %20
%20%20| Netlog | %208 | %20
%20%20| Netvibes%20Share | %20195 | %20
%20%20| Netvouz | %2021 | %20
%20%20| NewsTrust | %20199 | %20
%20%20| NewsVine | %2041 | %20
%20%20| Ning | %20264 | %20
%20%20| NowPublic | %2075 | %20
%20%20| NUjij | %20238 | %20
%20%20| Oknotizie | %20243 | %20
%20%20| Oneview | %2084 | %20
%20%20| Orkut | %20247 | %20
%20%20| PhoneFavs | %2019 | %20
%20%20| Pinboard.in | %20256 | %20
%20%20| Ping | %2045 | %20
%20%20| Pinterest | %20309 | %20
%20%20| Plaxo%20Pulse | %2044 | %20
%20%20| Plurk | %20218 | %20
%20%20| Posterous | %20210 | %20
%20%20| PrintFriendly | %20236 | %20
%20%20| Propeller | %2077 | %20
%20%20| Protopage%20Bookmarks | %2047 | %20
%20%20| Pusha | %2059 | %20
%20%20| Read%20It%20Later | %20239 | %20
%20%20| ReadWriteWeb | %20250 | %20
%20%20| Reddit | %2040 | %20
%20%20| Segnalo | %2058 | %20
%20%20| Shoutwire | %2012 | %20
%20%20| Simpy | %2086 | %20
%20%20| SiteJot | %2099 | %20
%20%20| Slashdot | %2061 | %20
%20%20| SmakNews | %20206 | %20
%20%20| Soup.io | %20217 | %20
%20%20| Sphere | %20107 | %20
%20%20| Sphinn | %20100 | %20
%20%20| SpringPad | %20265 | %20
%20%20| Spurl | %2082 | %20
%20%20| Skype | %20989 | %20
%20%20| Squidoo | %2046 | %20
%20%20| StartAid | %2029 | %20
%20%20| Strands | %20190 | %20
%20%20| Streakr | %20215 | %20
%20%20| StumbleUpon | %2038 | %20
%20%20| Stumpedia | %20192 | %20
%20%20| Su.pr | %20232 | %20
%20%20| Svejo | %20245 | %20
%20%20| Symbaloo%20Feeds | %20103 | %20
%20%20| Taggly | %2026 | %20
%20%20| Tagza | %20187 | %20
%20%20| Tailrank | %2028 | %20
%20%20| Techmeme | %20204 | %20
%20%20| TechNet | %20185 | %20
%20%20| Technorati%20Favorites | %2010 | %20
%20%20| Technotizie | %2036 | %20
%20%20| TinyURL | %20223 | %20
%20%20| Tipd | %20188 | %20
%20%20| Truemors | %20203 | %20
%20%20| Tumblr | %2078 | %20
%20%20| Tweetie | %20226 | %20
%20%20| Twiddla | %2066 | %20
%20%20| Twine | %20216 | %20
%20%20| Twitter | %207 | %20
%20%20| TypePad%20Post | %20220 | %20
%20%20| unalog | %2070 | %20
%20%20| Viadeo | %2092 | %20
%20%20| VodPod | %20198 | %20
%20%20| Webnews | %2057 | %20
%20%20| Windows%20Live%20Favorites | %2037 | %20
%20%20| Windows%20Live%20Spaces | %2015 | %20
%20%20| Wink | %2022 | %20
%20%20| Wists | %2094 | %20
%20%20| WordPress | %20230 | %20
%20%20| Xerpi | %2020 | %20
%20%20| Yahoo%20Bookmarks | %2076 | %20
%20%20| Yahoo%20Buzz | %2073 | %20
%20%20| Yahoo%20Buzz%20India | %20254 | %20
%20%20| Yahoo%20Messenger | %2087 | %20
%20%20| Yahoo!%20Mail | %2054 | %20
%20%20| Yammer | %20253 | %20
%20%20| Yample | %2083 | %20
%20%20| Yandex | %20267 | %20
%20%20| YC%20Hacker%20News | %20202 | %20
%20%20| YiGG | %2056 | %20
%20%20| Yoolink | %2034 | %20
%20%20| YouMob | %2060 | %20
%20%20%20
%20Feedback
%20If%20you%20believe%20you%20have%20found%20a%20bug,%20or%20you’d%20like%20to%20request%20additional%20functionality,%20or%20you%20release%20something%20using%20this%20API,%20we’d%20love%20to%20hear%20from%20you.
%20
