Skip to content

bradvin/social-share-urls

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

363 Commits
code
code
 
 
images
images
 
 
CODE_OF_CONDUCT.md
CODE_OF_CONDUCT.md
 
 
HISTORY.md
HISTORY.md
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 

Repository files navigation

Social Share URLs

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.
  • Icons : Public domain and permissively-licensed, at an amazing 450x450 resolution.
  • 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.
  • 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!

Just Want the Gist?

Want to download just the URL's from this project?

Then check out our GitHub Gist : https://gist.github.com/HoldOffHunger/1998b92acb80bc83547baeaff68aaaf4

Demos

Some sites using this project :

Supported Social Networks

Multi-Language Social Media

Non-English Social Media

Phone/Audio-Based Social Media

Email-Based Social Media

Locally/Personally-Run Social Media

Deprecated/Discontinued Social Media Share Links

URL Arguments

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. Facebook
{redirect_url} The url a sharer will be redirected to after a successful share. Facebook
{page_type} Type of page, either "page" or "popup." Facebook
{category} A section to submit the share/comment to. Flattr

Multi-Language Social Media

Facebook

Global Rank : 4 (may 9, 2020)

Facebook (with Sharer)

Parameters : u.

https://www.facebook.com/sharer.php?u={url}

Source :

Facebook (with Share Dialog)

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 :

Reddit

Global Rank : 19 (may 9, 2020)

Parameters : url, title.

https://reddit.com/submit?url={url}&title={title}

Source :

Twitter

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 :

LinkedIn

Global Rank : 60 (may 9, 2020)

Parameters : url.

https://www.linkedin.com/sharing/share-offsite/?url={url}

Source :

WhatsApp

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 :

Tumblr

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 :

Pinterest

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 :

Blogger

Global Rank : 208 (may 9, 2020)

Parameters : u, n, t.

https://www.blogger.com/blog-this.g?u={url}&n={title}&t={text}

Source :

EverNote

Global Rank : 371 (may 9, 2020)

Parameters : url, title.

https://www.evernote.com/clip.action?url={url}&title={title}

Source :

LiveJournal

Global Rank : 446 (may 9, 2020)

Parameters : subject, event.

http://www.livejournal.com/update.bml?subject={title}&event={url}

Source :

GetPocket

Global Rank : 940 (may 9, 2020)

Parameters : url.

https://getpocket.com/edit?url={url}

Source :

HackerNews

Global Rank : 5,603 (may 9, 2020)

Parameters : u, t.

https://news.ycombinator.com/submitlink?u={url}&t={title}

Source :

FlipBoard

Global Rank : 6,302 (may 9, 2020)

Parameters : title, url.

https://share.flipboard.com/bookmarklet/popout?v=2&title={title}&url={url}

Source :

GoogleBookmarks

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 :

InstaPaper

Global Rank : 32,169 (may 9, 2020)

Parameters : url, title, description.

http://www.instapaper.com/edit?url={url}&title={title}&description={text}

Source :

Diaspora

Global Rank : 300,660 (may 9, 2020)

Parameters : title, url.

https://share.diasporafoundation.org/?title={title}&url={url}

Source :

Non-English Social Media

QZone

Global Rank : 5 (may 9, 2020)

Language : Chinese.

Parameters : url.

http://sns.qzone.qq.com/cgi-bin/qzshare/cgi_qzshare_onekey?url={url}&title={title}&summary={text}

Source :

Weibo

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 :

VK

Global Rank : 22 (may 9, 2020)

Language : Russian.

Parameters : url, title, comment.

http://vk.com/share.php?url={url}&title={title}&comment={text}

Source :

OKru

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 :

Douban

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 :

RenRen

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 :

XING

Global Rank : 1,749 (may 9, 2020)

Language : German.

Parameters : url.

https://www.xing.com/spi/shares/new?url={url}

Source :

Threema

Global Rank : 20,144 (may 9, 2020)

Language : German.

Parameters : text, id.

threema://compose?text={url}&id={user_id}

Source :

Phone/Audio-Based Social Media

SMS

Global Rank : N/A

Parameters : sms, body.

sms:{phone_number}?body={url}{text}

Skype

Global Rank : 175 (may 9, 2020)

Parameters : url, text.

https://web.skype.com/share?url={url}&text={text}

Source :

Line.me

Global Rank : 237 (may 9, 2020)

Parameters : url, text.

https://social-plugins.line.me/lineit/share?url={url}

Source :

Telegram.me

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}

Email-Based Social Media

EMail

Global Rank : N/A

Parameters : mailto, subject, body.

mailto:{email_address}?subject={title}&body={url} {text}

Source :

GMail

Global Rank : 1 (may 9, 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 :

Yahoo

Global Rank : 12 (may 9, 2020)

Parameters : to, subject, body.

http://compose.mail.yahoo.com/?to={email_address}&subject={title}&body={url}

Source :

Locally/Personally-Run Social Media

WordPress

Global Rank : N/A

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 :

Deprecated Social Share URLs

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.

AIM

Baidu

Delicious

EchoJS

FBMessenger

  • 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}

FriendFeed

Google+

Mail.ru

  • 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.

MySpace

NewsVine

Ping.fm

ScoopIt

  • 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.

SinaWeibo

SlashDot

StumbleUpon/Mix

  • 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."

Viber

  • 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}

Digg

AddThis

  • 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!

Buffer

Flattr

SurfingBird

About

Social Share URLs

Resources

Readme

License

BSD-3-Clause license

Code of conduct

Code of conduct
Activity

Stars

2.8k stars

Watchers

100 watching

Forks

305 forks
Report repository

Releases 4

Remove Google+ and Other Inactives, update Xing URL and JS Lib Latest
Jan 14, 2019
+ 3 releases

Packages

No packages published

Contributors 16

+ 2 contributors

Languages