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.
- History : Hey, we've been around for a while, wh00! Check out our history page!
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
- Tumblr
- Blogger
- EverNote
- LiveJournal
- GetPocket
- HackerNews
- GoogleBookmarks
- InstaPaper
- Diaspora
- AIM
- Baidu
- Delicious
- EchoJS
- FBMessenger
- FriendFeed
- Google+
- Mail.Ru
- MySpace
- NewsVine
- Ping.fm
- ScoopIt
- SinnaWeibo
- SlashDot
- StumbleUpon / Mix.com
- Viber
- Digg
- AddThis
- Buffer
- Flattr
- SurfingBird
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, GetPocket, HackerNews, Digg, FlipBoard, InstaPaper, SurfingBird, 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, Tumblr, Blogger, LiveJournal, EverNote, HackerNews, FlipBoard, InstaPaper, SurfingBird, Diaspora, VK, Weibo, Douban, RenRen, EMail, GMail, Yahoo, WordPress |
{text} | A longer description of the content you are sharing. | GoogleBookmarks, Twitter, Tumblr, Blogger, InstaPaper, SurfingBird, 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 |
{user_id} | The username/id of a particular user on a social media service. | Twitter, 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 |
{image} | The url to the image/thumbnail to use when sharing. | SurfingBird, WordPress |
{phone_number} | An applicable phone number, if there is one. | SMS, Whatsapp |
{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 |
Parameters :
u
.
https://www.facebook.com/sharer.php?u={url}
Source :
- Official Source :
- Unofficial Source :
- StackOverflow: Facebook share link - no javascript
- StackOverflow: How to add facebook share button on my website?
- StackOverflow: Facebook Share Button for Dynamic Url
- StackOverflow: Facebook share button
- StackOverflow: FaceBook share button to post content on FaceBook
- StackOverflow: Open source alternative to AddThis AddToAny, ShareThis etcfor Social Bookmarking
- StackOverflow: will facebook sharer functionality be supported?
- Test Notes : None.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2013
,2016
,2018
,2020
.
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
. Tested and works with this url: https://www.facebook.com/dialog/share?app_id=182985995589570&display=page&href=http://www.earthfluent.com&redirect_uri=http://www.earthfluent.com - Test Results : Functionality tested and verified by SocialShare Dev's in
2013
,2016
,2018
,2020
.
Global Rank :
19
(may 9, 2020)
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
,2018
,2020
.
Global Rank :
47
(may 9, 2020)
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
- Unofficial Source :
- Test Notes : None.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2013
,2016
,2018
,2020
.
Global Rank :
60
(may 9, 2020)
Parameters :
url
.
https://www.linkedin.com/sharing/share-offsite/?url={url}
Source :
- Official Source : LinkedIn: Share On LinkedIn, Section: "Customized URL"
- Unofficial Source :
- StackOverflow: Is there a single PHP API to post to multiple sharing sites (Twitter, Reddit, Linkedin, etc)?
- StackOverflow: Social Sharing With LinkedIn (April, 2020)
- StackOverflow: How to make custom linkedin share button
- StackOverflow: Social Share Links with Custom Icons
- StackOverflow: Social media sharing without scripts
- StackOverflow: LinkedIn share url without javascript?
- StackOverflow: LinkedIn Share Post URL
- 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
,2018
,2020
.
Global Rank :
71
(may 5, 2020)
Parameters :
phone
, text
.
https://api.whatsapp.com/send?phone={phone_number}&text={title}%20{url}
whatsapp://send/?text={text}%20{url}
https://wa.me/{phone_number}?text={title}%20{url}
Source :
- Official Source : WhatsApp: How to use click to chat
- Unofficial Source :
- StackOverflow: flask Create social share components
- StackOverflow: Mobile website “WhatsApp” button to send message to a specific number
- StackOverflow: Web link to specific whatsapp contact
- StackOverflow: whatsapp://send?text= Doesn't work
- StackOverflow: Sharing link for WhatsApp Web version?
- StackOverflow: Link to chat whatsapp desktop
- StackOverflow: Sending message through WhatsApp
- StackOverflow: Send text to specific contact programmatically (whatsapp)
- Test Notes : wa.me does not work unless a phone_number is supplied, so, for this reason, we are suggesting users use the api.whatsapp.com format.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2020
.
Global Rank :
115
(may 9, 2020)
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
,2018
,2020
.
Global Rank :
152
(may 9, 2020)
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
,2018
,2020
.
Global Rank :
208
(may 9, 2020)
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
,2018
,2020
.
Global Rank :
371
(may 9, 2020)
Parameters :
url
, title
.
https://www.evernote.com/clip.action?url={url}&title={title}
Source :
- Official Source : Unable to locate.
- Unofficial Source :
- Test Notes : Requires login to work. 2020 update: No confirmation is required, the user clicks the link and it literally creates the "note" in the "default notebook," which seems like a security problem. In regards to testing, though, it means you won't be able to see the link directly that you're trying to share, and must navigate to the "default notebook."
- Test Results : Functionality tested and verified by SocialShare Dev's in
2016
,2018
,2020
.
Global Rank :
446
(may 9, 2020)
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
,2018
,2020
.
Global Rank :
940
(may 9, 2020)
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. 2020 Update: Oddly, there is no confirmation here, either. - Test Results : Functionality tested and verified by SocialShare Dev's in
2016
,2018
,2020
.
Global Rank :
5,603
(may 9, 2020)
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
,2020
.
Global Rank :
6,302
(may 9, 2020)
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
,2018
,2020
.
Global Rank :
13,206
(may 9, 2020; site: chrome.com)
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 :
- StackOverflow: Add to favourites link for Google Chrome
- StackOverflow: Modify the Google 'Add Bookmark' bookmarklet to store bookmark without popup?
- StackOverflow: Social Share Links with Custom Icons
- StackOverflow: Google bookmarks script only saves about 1 in 5 links
- StackOverflow: Open source alternative to AddThis AddToAny, ShareThis etcfor Social Bookmarking
- StackOverflow: Wordpress posts show http://google.com/bookmarks/mark?op=edit&title= in front of url
- Test Notes : None.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2018
,2020
.
Global Rank :
32,169
(may 9, 2020)
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
,2018
,2020
.
Global Rank :
300,660
(may 9, 2020)
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
,2020
.
Language :
Chinese.
Parameters :
url
.
http://sns.qzone.qq.com/cgi-bin/qzshare/cgi_qzshare_onekey?url={url}&title={title}&summary={text}
Source :
- Official Source : Unable to locate.
- Unofficial Source :
- Test Notes : None.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2016
,2018
,2020
.
Global Rank :
16
(may 16, 2020)
Language :
Chinese.
Parameters :
url
, title
.
http://service.weibo.com/share/share.php?url={url}&appkey=&title={title}&pic=&ralateUid=
Source :
- Official Source : Weibo: ShareCode
- Unofficial Source :
- Test Notes : Does not require login or software install, service was briefly down in early 2020.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2016
,2018
,2020
.
Global Rank :
22
(may 9, 2020)
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 : 2020 Update: Requires login to test.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2016
,2018
,2020
.
Global Rank :
62
(may 9, 2020)
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
,2018
,2020
.
Global Rank :
284
(may 9, 2020)
Language :
Chinese.
Parameters :
name
, text
, comment
.
http://www.douban.com/recommend/?name={title}&text={text}&comment={url}&href={url}
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
,2018
,2020
.
Global Rank :
1,220
(may 9, 2020)
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
,2018
,2020
.
Global Rank :
1,749
(may 9, 2020)
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
,2018
,2020
.
Global Rank :
20,144
(may 9, 2020)
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={url}{text}
- Official Source : Unable to locate.
- Unofficial Source :
- Test Notes : None.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2018
,2020
.
Global Rank :
175
(may 9, 2020)
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. 2020 Update: Make sure to disable uBlock Origin when testing, otherwise Skype will appear to be blocked.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2016
,2018
,2020
.
Global Rank :
237
(may 9, 2020)
Parameters :
url
, text
.
https://social-plugins.line.me/lineit/share?url={url}
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
,2018
,2020
.
Global Rank :
328
(may 9, 2020)
Parameters :
url
, text
.
https://t.me/share/url?url={url}&text={text}
https://telegram.me/share/url?url={url}&text={text}
tg://msg_url?url={url}&text={text}
- Official Source : Telegram Sharing Button
- Unofficial Source :
- StackOverflow: Pre-filled message to a Telegram number
- StackOverflow: Open telegram app from a link in a mobile web site
- StackOverflow: Share a link via URL scheme (via Telegram for example)
- StackOverflow: Add some html and php codes bottom of wordpress post content
- StackOverflow: There's a new Telegram “button” for websites - need help to use it on blogspot
- Test Notes : None.
- Test Results : Functionality tested and verified by SocialShare Dev's in
2016
,2018
,2020
.
Parameters :
mailto
, subject
, body
.
mailto:{email_address}?subject={title}&body={url} {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
,2018
,2020
.
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
,2018
,2020
.
Global Rank :
12
(may 9, 2020)
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
,2018
,2020
.
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]
-
Further Retest Results in 2020: Viber has completely rewritten their API, as documented here, Viber.com: Deep Links. Further retesting reveals that both the old API and the brand-new API are still broken and inoperable.
-
viber://forward?text={url}
-
-
Social-share service started in 2018 and discontinued in 2020. AddThis is now a marketing firm that tries to sell a social share URL list, much ours. Except we're free -- free as in free beer and free speech!
-
Social-share service discontinued in 2020. Users may still use the api to share text and communicate, but URLs are forbidden, and are immediately rewritten to internal, buffer URLs, which have nothing to do with the content you want to share.
-
Social-share service discontinued in 2020. Attempting to use the URL results in: "404 Sorry, this page isn’t available."