Skip to content

Pacomarchante/social-share-urls

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

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.

Share Links - Do You Have Them?

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.

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 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. Google+, GoogleBookmarks, Facebook, Reddit, Twitter, LinkedIn, Tumblr, Pinterest, Blogger, LiveJournal, EverNote, AddThis, GetPocket, HackerNews, StumbleUpon, 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. Google+, 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. Google+, 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. 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
{provider} Service providing the share link. LinkedIn

Multi-Language Social Media

Google+

Global Rank : 1 (apr. 3, 2018)

Parameters : url, text, hl.

https://plus.google.com/share?url={url}&text={text}&hl={language_code}

Source :

GoogleBookmarks

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 :

Facebook

Global Rank : 3 (apr. 3, 2018)

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 : 6 (apr. 3, 2018)

Parameters : url, title.

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

Source :

Twitter

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 :

LinkedIn

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 :

Tumblr

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 :

Pinterest

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 :

Blogger

Global Rank : 183 (apr. 3, 2018)

Parameters : u, n, t.

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

Source :

LiveJournal

Global Rank : 263 (apr. 3, 2018)

Parameters : subject, event.

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

Source :

EverNote

Global Rank : 494 (apr. 3, 2018)

Parameters : url, title.

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

Source :

AddThis

Global Rank : 561 (apr. 3, 2018)

Parameters : url.

http://www.addthis.com/bookmark.php?url={url}

Source :

GetPocket

Global Rank : 669 (apr. 3, 2018)

Parameters : url.

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

Source :

HackerNews

Global Rank : 1,650 (apr. 3, 2018)

Parameters : u, t.

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

Source :

StumbleUpon

Global Rank : 1,948 (apr. 3, 2018)

Parameters : url.

http://www.stumbleupon.com/submit?url={url}

Source :

Digg

Global Rank : 2,367 (apr. 3, 2018)

Parameters : url.

http://digg.com/submit?url={url}

Source :

Buffer

Global Rank : 2,487 (apr. 3, 2018)

Parameters : text, url.

https://buffer.com/add?text={title}&url={url}

Source :

FlipBoard

Global Rank : 3,638 (apr. 3, 2018)

Parameters : title, url.

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

Source :

InstaPaper

Global Rank : 13,660 (apr. 3, 2018)

Parameters : url, title, description.

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

Source :

SurfingBird

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 :

Flattr

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 :

Diaspora

Global Rank : 262,184 (apr. 3, 2018)

Parameters : title, url.

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

Source :

Non-English Social Media

QZone

Global Rank : 9 (apr. 3, 2018)

Language : Chinese.

Parameters : url.

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

Source :

VK

Global Rank : 17 (apr. 3, 2018)

Language : Russian.

Parameters : url, title, comment.

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

Source :

Weibo

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 :

OKru

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 :

Douban

Global Rank : 900 (apr. 3, 2018)

Language : Chinese.

Parameters : url, title.

http://www.douban.com/recommend/?url={url}&title={title}

Source :

XING

Global Rank : 1,377 (apr. 3, 2018)

Language : German.

Parameters : url.

https://www.xing.com/app/user?op=share&url={url}

Source :

RenRen

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 :

Threema

Global Rank : 82,555 (apr. 3, 2018)

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={text}

Line.me

Global Rank : 360 (apr. 3, 2018)

Parameters : url, text.

https://lineit.line.me/share/ui?url={url}&text={text}

Source :

Skype

Global Rank : 375 (apr. 3, 2018)

Parameters : url, text.

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

Source :

Telegram.me

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}

Email-Based Social Media

EMail

Global Rank : N/A

Parameters : mailto, subject, body.

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

Source :

GMail

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 :

Yahoo

Global Rank : 7 (apr. 3, 2018)

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

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

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]

    • viber://forward?text={url}

WhatsApp

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

About

Social Share URLs

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Objective-C 13.6%
  • JavaScript 13.4%
  • C 7.4%
  • Java 7.2%
  • C++ 6.7%
  • Visual Basic .NET 6.6%
  • Other 45.1%