This project is intended to help you integrate sharing on social media within your code. We have been actively doing this since 2013.
What we try to provide :
- Source Code Libraries : To provide basic utilities for generating these social media links in any environment that you need.
- Currently supporting libraries in : JavaScript, PHP, Python, Java, Golang, ReactJS, C++, C, MySQL, C#, Ruby, VB.Net, Perl, Swift, Objective-C.
- Documentation: Each library has its own demo's, online sandboxes, and sample-use code.
- Want to know about the code? Check it out : https://github.com/bradvin/social-share-urls/tree/master/code
- Icons : Public domain and permissively-licensed, at an amazing
450x450
resolution.- Currently supported themes:
opaque background
(1x set),white background
(1x set),background & shadow
(1x set),colorized background
(10x sets). - Want to know about the icons? Check it out : https://github.com/bradvin/social-share-urls/tree/master/images
- Currently supported themes:
- Regularly-Tested, Basic Share-URL Formats of Popular, Social Media : Directly linking to share/like pages on that social media with fillable URL, text, and other parameters.
- For example :
example.com/someSocialMediaSite/share?url=yourWebsiteURL&text=someMessageAboutYourSite
. - URL's are organized into category (
multi-language
,phone-based
,email-based
, etc.). - Each URL category is sorted by
Alexa
-rank. Know what's important without having to track down the info.
- For example :
- Reference Sources : For each service, URL format, and set of parameters, so that you can feel confident about these links and find out more if you need to do something more interesting.
- We include primary sources (official documentation or official dev blogs). We try to provide at least one of these per service.
- We also include secondary sources (like forum conversations or StackOverflow questions). We try to provide at least three of these per service.
Want to download just the URL's from this project?
Then check out our GitHub Gist : https://gist.github.com/HoldOffHunger/1998b92acb80bc83547baeaff68aaaf4
Some sites using this project :
- Mikhail Bakunin : God and the State
- EarthFluent.com : Learn French Online
- List Keywords : Finding and Listing Your Keywords For You
- GoogleBookmarks
- Tumblr
- Blogger
- LiveJournal
- EverNote
- AddThis
- GetPocket
- HackerNews
- Digg
- Buffer
- InstaPaper
- SurfingBird
- Flattr
- Diaspora
- AIM
- Baidu
- Delicious
- EchoJS
- FBMessenger
- FriendFeed
- Google+
- Mail.Ru
- MySpace
- NewsVine
- Ping.fm
- ScoopIt
- SinnaWeibo
- SlashDot
- StumbleUpon / Mix.com
- Viber
Your URL should be placed in the url
parameter; if not available, you will need to construct a message about your URL and place that message in the title
or text
parameters.
Argument | Description | Used By |
---|---|---|
{url} | The URL-encoded link you want to share. Service may reject link if not encoded. | GoogleBookmarks, Facebook, Reddit, Twitter, LinkedIn, Tumblr, Pinterest, Blogger, LiveJournal, EverNote, AddThis, GetPocket, HackerNews, Digg, Buffer, FlipBoard, InstaPaper, SurfingBird, Flattr, Diaspora, Line.me, Skype, Telegram.me, QZone, VK, Weibo, OKru, Douban, XING, RenRen, GMail, Yahoo, WordPress |
{title} | The page title of the url you want to share. | GoogleBookmarks, Reddit, LinkedIn, Tumblr, Blogger, LiveJournal, EverNote, HackerNews, FlipBoard, InstaPaper, SurfingBird, Flattr, Diaspora, VK, Weibo, Douban, RenRen, EMail, GMail, Yahoo, WordPress |
{text} | A longer description of the content you are sharing. | GoogleBookmarks, Twitter, LinkedIn, Tumblr, Blogger, Buffer, InstaPaper, SurfingBird, Flattr, SMS, Line.me, Skype, Telegram.me, VK, RenRen, Threema, EMail, WordPress |
{hash_tags} | Hashtags appended onto the tweet (comma separated. don't include "#"). | GoogleBookmarks, Twitter, Tumblr, Flattr |
{user_id} | The username/id of a particular user on a social media service. | Twitter, Flattr, Threema |
{email_address} | Where a social share is directed. You will most likely want to leave this blank, so the user can fill it in. | EMail, GMail, Yahoo |
{language_code} | A language code from the ISO 639-1 Code specification. | Flattr |
{image} | The url to the image/thumbnail to use when sharing. | SurfingBird, WordPress |
{phone_number} | An applicable phone number, if there is one. | SMS, Telegram.me |
{app_id} | The App ID. | |
{redirect_url} | The url a sharer will be redirected to after a successful share. | |
{page_type} | Type of page, either "page" or "popup." | |
{category} | A section to submit the share/comment to. | Flattr |
{provider} | Service providing the share link. |
Global Rank :
1
(apr. 3, 2018)
Parameters :
bkmk
, title
, annotation
, labels
.
https://www.google.com/bookmarks/mark?op=edit&bkmk={url}&title={title}&annotation={text}&labels={hash_tags}
Source :
- Official Source : Unable to locate.
- Unofficial Source :
- Test Notes : None.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2018
.
Global Rank :
3
(apr. 3, 2018)
Parameters :
u
.
https://www.facebook.com/sharer.php?u={url}
Source :
- Official Source : FaceBook: We have changed the behavior of the sharer plugin...
- Unofficial Source :
- Test Notes : None.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2013
,2016
, and2018
.
Parameters :
app_id
, page_type
, href
, redirect_url
.
https://www.facebook.com/dialog/share?app_id={app_id}&display={page_type}&href={url}&redirect_uri={redirect_url}
Source :
- Official Source : FaceBook: Share Dialog
- Unofficial Source :
- Test Notes : Requires registering in order to get an App_Id. Working test account is available in the official documentation, so you can avoid this requirement for tesing and you can test with
https://www.facebook.com/dialog/share?app_id=145634995501895&someOtherParameters=SomeOtherValues
. - Test Results : Functionality tested and verified by SocialShare Dev's in
2013
,2016
, and2018
.
Global Rank :
6
(apr. 3, 2018)
Parameters :
url
, title
.
https://reddit.com/submit?url={url}&title={title}
Source :
- Official Source : RedDit: put reddit.com buttons on your site
- Unofficial Source :
- Test Notes : Regarding
title
Parameter: Unable to find official source. - Test Results : Functionality tested and verified by SocialShare Dev's in
2013
,2016
, and2018
.
Global Rank :
12
(apr. 3, 2018)
Parameters :
url
, text
, via
, hashtags
.
https://twitter.com/intent/tweet?url={url}&text={title}&via={user_id}&hashtags={hash_tags}
Source :
- Official Source : Twitter: Tweet Button Parameter Reference
- Unofficial Source :
- Test Notes : None.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2013
,2016
, and2018
.
Global Rank :
30
(apr. 3, 2018)
Parameters :
url
, title
, summary
, source
.
https://www.linkedin.com/shareArticle?mini=true&url={url}&title={title}&summary={text}&source={provider}
Source :
- Official Source : LinkedIn: Share On LinkedIn, Section: "Customized URL"
- Unofficial Source :
- Test Notes : URL max is 1,024 characters, title/source max is 200 characters, and summary max is 256 characters.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2013
,2016
, and2018
.
Global Rank :
57
(apr. 3, 2018)
Parameters :
canonicalUrl
, title
, caption
, tags
.
https://www.tumblr.com/widgets/share/tool?canonicalUrl={url}&title={title}&caption={text}&tags={hash_tags}
Source :
- Official Source : Tumblr: Post to Tumblr
- Unofficial Source :
- Test Notes : Requires login. A described language parameter (
data-locale
) appeared to have no effect (and, therefore, is not listed here). - Test Results : Functionality tested and verified by SocialShare Dev's in
2013
,2016
, and2018
.
Global Rank :
79
(apr. 3, 2018)
Parameters :
url
.
http://pinterest.com/pin/create/button/?url={url}
http://pinterest.com/pin/create/link/?url={url}
Source :
- Official Source : Pinterest: Save Button
- Unofficial Source :
- Test Notes : Requires the user to select an image to "pin" the URL with.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2013
,2016
, and2018
.
Global Rank :
183
(apr. 3, 2018)
Parameters :
u
, n
, t
.
https://www.blogger.com/blog-this.g?u={url}&n={title}&t={text}
Source :
- Official Source : Unable to locate.
- Unofficial Source :
- Test Notes : Requires login, a blog tied to your blogger account, and either no
url
or that theurl
be perfectly formatted with protocols (http/https, etc.). - Test Results : Functionality tested and verified by SocialShare Dev's in
2016
and2018
.
Global Rank :
263
(apr. 3, 2018)
Parameters :
subject
, event
.
http://www.livejournal.com/update.bml?subject={title}&event={url}
Source :
- Official Source : LiveJournal: LiveJournal share button
- Unofficial Source :
- Test Notes : None.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2016
and2018
.
Global Rank :
494
(apr. 3, 2018)
Parameters :
url
, title
.
http://www.evernote.com/clip.action?url={url}&title={title}
Source :
- Official Source : Unable to locate.
- Unofficial Source :
- Test Notes : Requires login to work.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2016
and2018
.
Global Rank :
561
(apr. 3, 2018)
Parameters :
url
.
http://www.addthis.com/bookmark.php?url={url}
Source :
- Official Source : AddThis: Social Buttons
- Unofficial Source :
- Test Notes : The above-described url-format does not appear in the official documentation.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2018
.
Global Rank :
669
(apr. 3, 2018)
Parameters :
url
.
https://getpocket.com/edit?url={url}
Source :
- Official Source : getPocket: Pocket Button Documentation
- Unofficial Source :
- Test Notes : Regarding
url
Parameter: Unable to find official source. - Test Results : Functionality tested and verified by SocialShare Dev's in
2016
and2018
.
Global Rank :
1,650
(apr. 3, 2018)
Parameters :
u
, t
.
https://news.ycombinator.com/submitlink?u={url}&t={title}
Source :
- Official Source : Unable to locate.
- Unofficial Source :
- Test Notes : Requires login to work.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2018
.
Global Rank :
2,367
(apr. 3, 2018)
Parameters :
url
.
http://digg.com/submit?url={url}
Source :
- Official Source : Unable to locate.
- Unofficial Source :
- Test Notes : None.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2013
,2016
, and2018
.
Global Rank :
2,487
(apr. 3, 2018)
Parameters :
text
, url
.
https://buffer.com/add?text={title}&url={url}
Source :
- Official Source : Unable to locate.
- Unofficial Source :
- Test Notes : None.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2013
,2016
, and2018
.
Global Rank :
3,638
(apr. 3, 2018)
Parameters :
title
, url
.
https://share.flipboard.com/bookmarklet/popout?v=2&title={title}&url={url}
Source :
- Official Source : FlipBoard: Social Plugins
- Unofficial Source :
- Test Notes : Requires login and properly formatted URL with http/https protocol.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2016
and2018
.
Global Rank :
13,660
(apr. 3, 2018)
Parameters :
url
, title
, description
.
http://www.instapaper.com/edit?url={url}&title={title}&description={text}
Source :
- Official Source : InstaPaper: InstaPaper Browser Extensions
- Unofficial Source :
- Test Notes : Requires login and Chrome (does not work in FireFox).
- Test Results : Functionality tested and verified by SocialShare Dev's in
2016
and2018
.
Global Rank :
21,985
(apr. 3, 2018)
Parameters :
url
, description
, screenshot
, title
.
http://surfingbird.ru/share?url={url}&description={text}&screenshot={image}&title={title}
Source :
- Official Source : Unable to locate.
- Unofficial Source :
- Test Notes : Requires login to work.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2018
.
Global Rank :
132,899
(apr. 3, 2018)
Parameters :
user_id
, url
, title
, description
, language
, tags
, category
.
https://flattr.com/submit/auto?user_id={user_id}&url={url}&title={title}&description={text}&language={language_code}&tags={hash_tags}&hidden=HIDDEN&category={category}
Source :
- Official Source : Flattr: URL Auto Submit Documentation
- Unofficial Source :
- Test Notes : Requires all user_id, url, and title parameters to be precisely formatted.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2018
.
Global Rank :
262,184
(apr. 3, 2018)
Parameters :
title
, url
.
https://share.diasporafoundation.org/?title={title}&url={url}
Source :
- Official Source : Diaspora: Share all teh internetz!
- Unofficial Source :
- Test Notes : Requires login to work.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2018
.
Global Rank :
9
(apr. 3, 2018)
Language :
Chinese.
Parameters :
url
.
http://sns.qzone.qq.com/cgi-bin/qzshare/cgi_qzshare_onekey?url={url}
Source :
- Official Source : Unable to locate.
- Unofficial Source :
- Test Notes : None.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2016
and2018
.
Global Rank :
17
(apr. 3, 2018)
Language :
Russian.
Parameters :
url
, title
, comment
.
http://vk.com/share.php?url={url}&title={title}&comment={text}
Source :
- Official Source : VK.com: Link Posting Documentation
- Unofficial Source :
- DLE-FAQ.ru: Как настроить ссылки поделиться для соц сетей? (How to configure links to share for social networks?)
- PVSM.ru: 1000 и 1 репост: гайд по кнопке «поделиться» в русских соц сетях (1000 and 1 repost: a guide on the button "share" in Russian social networks)
- UC-Zone.3dn.ru: Кнопка «Поделиться ВКонтакте» для uCoz (The "Share ВКонтакте" button for uCoz)
- Test Notes : None.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2016
and2018
.
Global Rank :
21
(apr. 3, 2018)
Language :
Chinese.
Parameters :
url
, title
, pic
.
http://service.weibo.com/share/share.php?url={url}&appkey=&title={title}&pic=&ralateUid=
Source :
- Official Source : Weibo: ShareCode
- Unofficial Source :
- Test Notes : Requires login and software install to work.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2016
and2018
.
Global Rank :
46
(apr. 3, 2018)
AKA :
AKA "Odnoklassniki" (English: "Classmates").
Language :
Russian.
Parameters :
st.shareUrl
.
https://connect.ok.ru/dk?st.cmd=WidgetSharePreview&st.shareUrl={url}
Source :
- Official Source : OK: Like/Share Button
- Unofficial Source :
- Test Notes : Requires login to work.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2016
and2018
.
Global Rank :
900
(apr. 3, 2018)
Language :
Chinese.
Parameters :
url
, title
.
http://www.douban.com/recommend/?url={url}&title={title}
Source :
- Official Source : Douban: 使用"send to"把你喜欢的文章从GReader发送到9点推荐 - 豆瓣
- Unofficial Source :
- ChaoZhuoWang.com: 首页>>论坛中心>>常用技巧>>查看帖子网页常用分享代码大全(前端必备)(Home >> Forum Center >> Common Skills >> Webpage commonly used to share code Daquan (front-end must-haves))
- Blog.Sina.Com.cn: HTML页面分享 (HTML page sharing [This blog post contains pictures])
- GitHub: surmon-china/surmon.me > surmon.me/components/layout/share.vue
- Test Notes : None.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2016
and2018
.
Global Rank :
1,377
(apr. 3, 2018)
Language :
German.
Parameters :
url
.
https://www.xing.com/spi/shares/new?url={url}
Source :
- Official Source :
- Unofficial Source :
- Test Notes : Requires login to work and precisely formatted URL (with protocol http/https parameters).
- Test Results : Functionality tested and verified by SocialShare Dev's in
2016
and2018
.
Global Rank :
1,508
(apr. 3, 2018)
AKA :
Xiaonei.
Language :
Chinese.
Parameters :
resourceUrl
, srcUrl
, title
, description
.
http://widget.renren.com/dialog/share?resourceUrl={url}&srcUrl={url}&title={title}&description={text}
Source :
- Official Source : Unable to locate.
- Unofficial Source :
- Test Notes : None.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2016
and2018
.
Global Rank :
82,555
(apr. 3, 2018)
Language :
German.
Parameters :
text
, id
.
threema://compose?text={url}&id={user_id}
Source :
- Official Source : Threema: Threema Gateway > Developers > Threema Message API
- Unofficial Source :
- Test Notes : If no user_id is provided, user is asked to select a contact, and then the message with text parameter is filled in. If you need to test without paying for the app, there are free trials here:
https://work.threema.ch/en/offers
. Special thanks to Threema for providing free credentials to Social Share dev's for testing Threema. - Test Results : Functionality tested and verified by SocialShare Dev's in
2018
.
Parameters :
sms
, body
.
sms:{phone_number}?body={text}
- Official Source : Unable to locate.
- Unofficial Source :
- Test Notes : None.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2018
.
Global Rank :
360
(apr. 3, 2018)
Parameters :
url
, text
.
https://lineit.line.me/share/ui?url={url}&text={text}
Source :
- Official Source : Line Social Plugins
- Unofficial Source :
- Test Notes : Requires login to work and perfectly formatted URL with protocol parameters (http/https, etc.). Creating an account requires software install. Above-described URL parameters are not indicated in the official documentation.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2016
and2018
.
Global Rank :
375
(apr. 3, 2018)
Parameters :
url
, text
.
https://web.skype.com/share?url={url}&text={text}
Source :
- Official Source : Unable to locate.
- Unofficial Source :
- Test Notes : Requires login to work.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2016
and2018
.
Global Rank :
456
(apr. 3, 2018)
Parameters :
url
, text
, to
.
https://t.me/share/url?url={url}&text={title}&to={phone_number}
https://telegram.me/share/url?url={url}&text={title}&to={phone_number}
tg://msg?url={url}&text={title}&to={phone_number}
- Official Source : Unable to locate.
- Unofficial Source :
- Test Notes : None.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2016
and2018
.
Parameters :
mailto
, subject
, body
.
mailto:{email_address}?subject={title}&body={text}
Source :
- Official Source : RFC 2368: The mailto URL scheme
- Unofficial Source :
- Test Notes : None.
- Test Results : Functionality tested and verified by SocialShare Dev's in
1998
and2018
.
Global Rank :
1
(apr. 3, 2018)
Parameters :
to
, su
, body
, bcc
, cc
.
https://mail.google.com/mail/?view=cm&to={email_address}&su={title}&body={url}&bcc={email_address}&cc={email_address}
Source :
- Official Source : Unable to locate.
- Unofficial Source :
- Test Notes : None.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2016
and2018
.
Global Rank :
7
(apr. 3, 2018)
Parameters :
to
, subject
, body
.
http://compose.mail.yahoo.com/?to={email_address}&subject={title}&body={url}
Source :
- Official Source : Unable to locate.
- Unofficial Source :
- StackOverflow: Yahoo email compose link not working - compose.mail.yahoo.com
- StackOverflow: What is the format of compose links to web mail clients such as Gmail, Yahoo Mail, Hotmail and AOL?
- StackOverflow: mailto: links and webmail
- StackOverflow: javascript commands work singly but not sequentially as a bookmarklet
- Test Notes : Requires login to work.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2016
and2018
.
Parameters :
u
, t
, s
, i
.
http://www.example.com/website_where_you_installed_wordpress/wp-admin/press-this.php?u={url}&t={title}&s={text}&i={image}
Source :
- Official Source : WordPress: Codex > Press This > Technical Note 1
- Unofficial Source :
- Test Notes : Requires login to work.
- Test Results : Could not test (no installation/sandbox).
Once supported, but no longer. Some of these may be well-documented. They are no longer supported because the share links no longer provide the desired action. These are listed for the sake of completion.
Use at your own merciless peril.
-
Links failed in
2018
. There are numerous, active complaints for this service, discoverable by just searching the web.fb-messenger://share?link={url}&app_id={app_id}
-
Massive security flaws were revealed in 2017 and 2018, causing Mail.ru to be added to the uBlock Origin blacklist. User password leak: currently active. Additionally, testing by Social Share dev's determined that the API no longer works.
-
URL requires login, accounts requires authorizing with several social media parties, and on Chrome and Firefox, using Windows, iOS, and Android, account creation could not be completed. This was the longest service to test that did not require software to be downloaded and locally installed.
-
Social-share service moved from stumbleupon.com to mix.com, where it ceased to function in
2019
. Attempted use produces result, "We couldn't gather the information from this website. Please double-check your link or try again later."
-
Social-share service discontinued in 2018. Confirmed after the test requirements: installing Viber on Desktop and Phone, syncing phone with desktop, logging in with verified American legal credentials, and multiple tests of the given documentation - Invalid Documentation: Using Viber Official Specifications is a Failure. Official development @viber has been negligent in response to inquiries.
-
Official Viber Response: "Your feedback will be considered as our teams work on upcoming versions. I’ll be closing this ticket, but feel free to reply to me with any further suggestions." [Case: #4641960]
-
viber://forward?text={url}
-
-
Social-share service discontinued in 2018. Confirmed after the test requirements: installing WhatsApp on Desktop and Phone, syncing phone with desktop, logging in with verified American legal credentials, and multiple tests of the given documentation - Invalid Documentation: Using Whatsapp Official Specifications is a Failure.
-
Official WhatsApp Response: "Sorry, but your description was not clear enough for our agents to understand the issue. Please explain the issue more thoroughly." [Request #172349248330585]
-
whatsapp://send?text={url}
-