Use the Universal Share API to share content with 89+ destinations

Reliable, fast, highly customizable. Used by millions every day.

Universal Share API

Get More Traffic

You've already got an audience that loves your content, product or service. Profit from helping them tell their friends and followers about you. The Universal Share API will enable the people that visit your website to share articles, comments, purchases and other activities from your website with their friends on multiple social networks. This API is free to use with premium upgrades available, and helps you grow your bottom line and traffic without growing your marketing budget.

Universal Share API Documentation

Shareaholic provides social APIs to connect your site or application to each of the major social networks for sharing. If you can’t use the Shareaholic JavaScript SDK, you can link to these API endpoints directly.

The Shareaholic JavaScript SDK incorporates this API and has many other very useful bells and whistles such as tackling cross device deep linking nuances, including the ability to customize the buttons to match the look and feel of your site or application.

It typically takes less than 10 minutes and 2 lines of code to implement. We highly recommend using the SDK to save time. It is the preferred implementation for Social Sharing Buttons.

You can even use your own icons by turning any DOM element on a page into a Share Button with very simple markup! For example (FAQ):

<a href data-app="share_buttons" data-app-config='{"service":"facebook"}'>Share</a>

API Designed for Ease

We have optimized for ease of implementation. All API methods are accessible via simple HTTP calls. Most implementations of this API take less than 15 minutes to setup. Simply call the provided URLs with their respective parameters, and you're done.

Getting Started: Authentication

All API endpoints require API authentication credentials to be supplied as query arguments. To get started, you'll need a free Shareaholic account and Site ID. Signup for an account and then add your site to get your Site ID. The Site ID is your API Key.



Note: the apikey used in this document is intended for use as an example only. It is subject to change.

Share Content with over 89 (and growing!) Destination Services

Let your users share content from any website, desktop app, mobile app, etc to any supported destination service.


Parameter Description Required Example
v API Version Required v=1
apitype API Type Required apitype=1 (1=Redirect, 2=Pingback, 3=1x1 pixel)
apikey API Key Required apikey=8943b7fd64cd8b1770ff5affa9a9437b
service Destination Service ID or Code Required service=facebook (lookup Service IDs and Codes)
link Link Required link=
title Page Title Optional title=My%20Awesome%20Webpage
notes Notes Optional notes=I%20love%20this!
media_link Media Link Optional media_link=
short_link Shortened Link Optional short_link=
shortener URL Shortener Optional shortener=shrlc (shrlc|bitly|tinyurl|none)
shortener_key URL Shortener Credentials Optional shortener_key=83932e4c5d02d1f94aea0f40fbc557ec
templates[twitter][body] X Template Optional templates[twitter][body]=${title} - ${short_link}
templates[twitter][related] Suggested X Accounts
(plan required)
Optional templates[twitter][related]=my_x_handle,my_other_x_handle
templates[email][body] E-mail Template
(plan required)
Optional templates[email][body]=${link}
templates[email][subject] E-mail Subject
(plan required)
Optional templates[email][subject]=${title}
templates[whatsapp][text] WhatsApp Template Optional templates[whatsapp][text]=${title} - ${short_link}
templates[whatsapp][phone] WhatsApp Phone Number
(plan required)
Optional templates[whatsapp][phone]=1617XXXXXXX
templates[sms][text] SMS/Text Message Template Optional templates[sms][text]=${title} - ${short_link}
templates[sms][phone] SMS/Text Message Phone Number
(plan required)
Optional templates[sms][phone]=+1617XXXXXXX
var[custom_token] Pass custom tokens to Templates Optional var[twitter:author]=@maroon5
tags Tags Optional tags=programming,python,howto
source Source Optional source=shareaholic

Working Example (posting a link to Facebook):

<a href="" target="_blank">Post to Facebook</a>

Give it a try: Post to Facebook


  • link, short_link, title, and notes parameters should be URL-encoded, plain text, no HTML, UTF-8. You can not include a parameter value in the request that has '&', '?', '#', ' ', or other reserved parameters without first encoding it.
  • Parameters should not contain spaces: any parameter with spaces will be rejected. All spaces should be either percent encoded (%20) or plus encoded (+). Note that tabs, newlines and trailing spaces are all indications of errors. Please remember to strip leading and trailing whitespace from any user input before posting.
  • Parameters must have a slash between the domain and the path component. For example, is invalid, and instead should be formatted as
  • link parameter value should be a complete URL and not a shortened link (like a short link). You should always pass shortened links (ex. you may want to do this for X) through the short_link parameter.
  • templates[twitter][related] parameter value should be a valid X handle, without the '@' or any whitespace. Multiple X accounts can be added as a comma-separated list of values with no spaces in between.

Link Tracking & URL Shorteners

Shareaholic can automatically shorten the link for you using a supported shortening service that you specify.


We currently support the following shorteners/parameter values:

shortener= Description
bitly Includes support for custom bitly domains
shrlc Default
none Do not shorten link

You can further customize this option with your own bitly or account by setting the shortener_key parameter. If you set this parameter, the API will use your personal bitly generic access token to shorten the link.


For those of you that are using older versions of Bitly (where your token starts with "R_"), you will need to pass your Bitly username as well:

shortener_key format: username|R_token (i.e. delimited by "|").

We shorten links for services where it is appropriate (i.e. sharing to X, but not Reddit). Also, if you would prefer not to publicize your shortener keys, you can setup your URL Shortener preferences and keys in your Shareaholic Admin Console. This is also the only way to setup a Bitly Custom Domain. If you do not pass the shortener and shortener_key parameters when calling the API call, the API will automatically lookup your saved cloud settings linked to your API Key, including the Bitly Custom Domain.

Templates i.e. customize the format of X Posts, Emails, WhatsApps, SMS / Text Messages

By specifying a templates[][] API parameter, you can customize the default post format for services that support templates. Specifying a template is completely optional. The following services currently support templates:

  • X
  • Email (also covers Gmail, Yahoo Mail, Outlook and AOL Mail)
  • SMS (Text Message)
  • WhatsApp

The Share API supports a few different tokens in a template — you can use all, some, or none of them:

Template Token Description
${title} Title of the page
${link} Link to the page
${short_link} Shortened link to the page
${notes} Any text; usually a very short summary of the link or user selected text
${custom_var} Any custom token. You can define more than one. For example: reference ..&var[twitter:author]=@maroon5&.. with ${twitter:author}

Sample template for X:

...&templates[twitter][body]=Reading: ${title} (${short_link}) via @Shareaholic %23api %23devtools&...


Give it a try: Tweet this!

Passing Custom Tokens to your Templates

With the [var][custom_token] parameter, you can pass custom tokens to your templates. You can pass more than one [var][] parameter.

Sample template with a custom token called text:

...&[var][text]=Breaking%20News&templates[whatsapp][text]=${text}: ${title} (${short_link}) via @Shareaholic %23api %23devtools&...

Example #1 (use a custom template token to add a CTA to a WhatsApp button):

<a href="[cta]=A little hint that this caught my eye!&templates[whatsapp][text]=${cta} -- ${title} - ${short_link}" target="_blank">Send a Hint ;) 🎁</a>

Give it a try: Send a Hint ;)  🎁

Example #2 (use a custom template token to reference a X account):

<a href=" Share%20API%20to%20share%20content%20to%20over%20100%20destinations&link=[twitter:author]=@maroon5&templates[twitter][body]=${title} - ${short_link} by ${twitter:author}" target="_blank">Tweet this!</a>

Give it a try: Tweet this!

Suggested X Accounts

By specifying the templates[twitter][related] API parameter, you can specify X accounts to appear in the "Recommend X Accounts" page that appears after a user shares your content via X. This feature is currently available for Pro Subscribers only.

To specify X accounts to be recommended, enter a comma-separated list of X handles, omitting the '@' sign and any whitespace.

Sample templates[twitter][related] for X:


Tags (describe your content)

Use the optional tags API parameter to further describe the content/URL being shared. Amongst many other benefits, you will get back more useful analytics tracking reports as a result.

tags takes a set of comma-separated values (CSV) with no trailing comma. Commas inside tag values MUST be URL encoded (as %2C) and commas separating tags MUST NOT be encoded. For example, the tags "python", "conference" and "Boston, MA" should be passed as:


You can pass in as many tags as you'd like, but we've found 3-5 to be most optimal.

Destination Services

Service Service ID Service Code Type About
Amazon (CA) Wish List 271 amazon_ca_wish_list bookmark

Add any item to your Amazon Canada Wish List. You can show everyone what you'd like for your birthday or special occasion.

Amazon (DE) Wish List 272 amazon_de_wish_list bookmark

Add any item to your Amazon Germany Wish List. You can show everyone what you'd like for your birthday or special occasion.

Amazon (FR) Wish List 273 amazon_fr_wish_list bookmark

Add any item to your Amazon France Wish List. You can show everyone what you'd like for your birthday or special occasion.

Amazon (JP) Wish List 274 amazon_jp_wish_list bookmark

Add any item to your Amazon Japan Wish List. You can show everyone what you'd like for your birthday or special occasion.

Amazon (UK) Wish List 270 amazon_uk_wish_list bookmark

Add any item to your Amazon UK Wish List. You can show everyone what you'd like for your birthday or special occasion.

Amazon (US) Wish List 200 amazon_us_wish_list bookmark

Add any item to your Wish List. You can show everyone what you'd like for your birthday or special occasion.

Amazon Kindle It 971 kindle_it bookmark

Kindle It lets you send articles you find on the web to your Kindle or other e-reader for easy reading.

Amazon Universal Registry 296 amazon_universal_registry bookmark

The Universal Registry Button lets you add items from other websites to your Amazon Registry. Use this to keep track of what you want from anywhere.

AOL Mail 55 aol_mail email

AOL Mail is a free web-based email service provided by AOL, a division of Verizon Communications.

Baidu 995 baidu bookmark

Baidu is the dominant Chinese internet search engine company, and it is the equivalent to Google in the United States.

Bitly 208 bit_ly urlshortener

Bitly is a URL shortening service and a link management platform.

Blogger Post 219 blogger_post blog

Blogger is a free blog publishing tool from Google for easily sharing your thoughts with the world.

Box 240 box_net bookmark

With Box, you get a single place to manage, secure, share and govern all of the content for your internal and external collaboration and processes.

Buffer 308 buffer tool

Buffer is a simpler and easier way to schedule posts, track the performance of your content, and manage all your accounts in one place.

Copy Link 1018 copy_link bookmark

Enable visitors to easily copy a link to share with others.

Diaspora 1026 diaspora socialnetwork

Diaspora is a nonprofit, user-owned, decentralized social network.

Digg 3 digg news

Digg is a place for people to discover and share content from anywhere on the web. From the biggest online destinations to the most obscure blog, Digg surfaces the best stuff as voted on by our users.

Diigo 24 diigo bookmark

Diigo is a powerful research tool and a knowledge-sharing community.

Diigolet 227 diigolet bookmark

Diigo is a powerful research tool and a knowledge-sharing community.

Douban 1024 douban socialnetwork

Douban is a social network that has become the preferred online social network for scholars, academics and writers in China to share opinions and create content related to movies, books, and music.

Douban is the third most popular social media platform in China. Because of its high-quality content, engaged user base and active communities, the platform is where a lot of big news stories are broken.

Email This 313 email_this email

It's true that email is fighting with other services (text, WhatsApp, social networks, etc) to maintain its share of voice, but it is still ubiquitous in a way that other social media networks are not.

Evernote 191 evernote bookmark

Evernote allows you to easily capture information in any environment using whatever device or platform you find most convenient, and makes this information accessible and searchable at any time, from anywhere.

Facebook 5 facebook socialnetwork

Facebook is a social utility that connects people with friends and others who work, study and live around them. People use Facebook to keep up with friends, upload photos, post links and videos, and learn more about the people they meet.

Facebook Messenger 305 facebook_messenger socialnetwork

Facebook is a social utility that connects people with friends and others who work, study and live around them. People use Facebook to keep up with friends, upload an unlimited number of photos, post links and videos, and learn more about the people they

Fark 62 fark news

Fark is a community website that allows members to comment on a daily batch of news articles and other items from various websites.

Flipboard 951 flipboard bookmark

Flipboard is Your Personal Magazine. It's a single place to discover, collect and share the news you care about. Add your favorite social networks, publications and blogs to stay connected to the topics and people closest to you.

Gab 1017 gab socialnetwork

Gab, launched in 2016, is an American alt-tech social networking service known for its far-right userbase. Gab was launched as an alternative to traditional platforms, such as X (Twitter) and Facebook. Users turned to Gab in part due to concerns larger platforms like X (Twitter) were censoring conservative opinions.

GETTR 1037 gettr socialnetwork

Gettr is a social media platform created as an alternative to X (Twitter).

Created by former Trump advisor Jason Miller, Gettr provides an alternative space for individuals who seek open dialogue and engagement without the fear of censorship.

Gettr has become a go-to platform for conservative voices and political figures.

Google Apps Mail 260 google_apps_mail email

Gmail (also known as Google Mail) is a free email service developed by Google.

Google Classroom 990 google_classroom bookmark

Google Classroom makes teaching more productive and meaningful by streamlining assignments, boosting collaboration, and fostering communication. Educators can create classes, distribute assignments, send feedback, and see everything in one place. Classroom also seamlessly integrates with other Google tools like Google Docs and Drive.

Google Gmail 52 google_mail email

Gmail (also known as Google Mail) is a free email service developed by Google.

Hacker News 202 yc_hacker_news news

Hacker News is a social news website focusing on computer science and entrepreneurship. It is run by Paul Graham's investment fund and startup incubator, Y Combinator. In general, content that can be submitted is defined as "anything that gratifies one's intellectual curiosity".

Hatena 246 hatena bookmark

Japan's largest bookmarking service to save and share Japanese news, blogs and websites.

Houzz 957 houzz socialnetwork

Houzz is a platform for home remodeling and design, bringing homeowners and home professionals together in a uniquely visual community.

Instapaper 18 instapaper tool

Instapaper is a simple tool for saving web pages to read later on your iPhone, iPad, Android, computer, or Kindle.

Kakao 1021 kakao socialnetwork

KakaoTalk, commonly referred to as KaTalk in South Korea, is a mobile messaging app for smartphones operated by Kakao Corporation.

With over 52 million active users in the fourth quarter of 2020, KakaoTalk is one of the most popular mobile messaging apps in South Korea. It is available in 15 languages and used by over 93% of smartphone owners in South Korea.

Koo 1031 koo socialnetwork

Koo is a micro-blogging platform. Discussions are around interesting topics. It empowers people to express their thoughts in Indian languages with a strong-knit local Indian community.

Line 996 line_me mobile

LINE is a communication app which allows you to make free voice calls and send free messages whenever and wherever you are, 24 hours a day!

LinkedIn 88 linkedin socialnetwork

LinkedIn is a business-oriented social networking site that connects experienced professionals around the world, representing 170 industries and 200 countries.

Mail 201 mail email

It's true that email is fighting with other services (text, WhatsApp, social networks, etc) to maintain its share of voice, but it is still ubiquitous in a way that other social media networks are not.

Mail.Ru 1020 mail_ru email

Mail.Ru is a Russian Internet company. It was started in 1998 as an e-mail service and went on to become a major corporate figure in the Russian-speaking segment of the Internet, comprising e-mail, instant messenger and online games.

Mastodon 1032 mastodon socialnetwork

Named after an extinct elephant-like mammal, Mastodon is being heralded as a more intimate and 'nicer' version of X (Twitter), with a lot of familiar-looking features.

Each user is a member of a specific Mastodon instance (also called a server), which can interoperate as a federated social network, allowing users on different instances to interact with each other.

Meneame 33 meneame bookmark

Menéame is a social bookmarking destination where subscribers send stories and other users can vote. Voted content is promoted to the homepage.

MeWe 1013 mewe socialnetwork

Launched in 2016, MeWe is a private social network that wants to take on the likes of Facebook and X (Twitter). There are no ads—targeted or otherwise—and no tracking users of any kind, such as data mining.

Microsoft OneNote 973 onenote tool

Microsoft OneNote is a program for free-form information gathering and multi-user collaboration.

Microsoft Teams 1019 microsoft_teams socialnetwork

Microsoft Teams is a proprietary business communication platform developed by Microsoft, as part of the Microsoft 365 family of products. Teams primarily competes with the similar service Slack, offering workspace chat and videoconferencing, file storage, and application integration.

The Share to Teams feature allows site visitors to easily share a site and content to individual contacts or groups on Teams. Make it easy for visitors to share the content they find interesting and useful with other individuals, or groups they have on Teams.

Mixi 970 mixi socialnetwork

Mixi is an online Japanese social networking service.

Naver 1028 naver socialnetwork

Naver (네이버 in Korean) is a South Korean online platform operated by Naver Corporation.

Naver is not just a search engine - Naver Blog was launched in October 2003 and has become a very important part of the search engine. As one of the pioneer services, Naver Blog succeeded in becoming one of the most successful digital platforms in Korea to share and access information about almost everything. Many companies, B2C and C2C, use Naver Blog.

So if you want to have your presence in Korea, you need to set up a Naver blog. Koreas will typically search for your service on Naver if they want to know about you.

Odnoklassniki 967 odnoklassniki socialnetwork is a Russian social network service for classmates and old friends.

Outlook 53 hotmail email

Email by Microsoft. A best in class e-mail service that helps you organize and manage all your email.

Parler 1014 parler socialnetwork

Parler is a social network launched in August 2018, promoted as an alternative to X (Twitter) and particularly marketed to political conservatives in the United States. The social network has a similar feel to X. You follow accounts, and content appears in a chronological News Feed. You can also comment on a post and search for hashtags. 256 pinboard_in bookmark

Pinboard is a fast, no-nonsense bookmarking site for people who value privacy and speed.

Pinterest 309 pinterest bookmark

Pinterest lets you organize and share all the beautiful things you find on the web. Best of all, you can browse pinboards created by other people who share your interests.

Plurk 218 plurk socialnetwork

Plurk is a social journal for your life. Share your life easily with friends, family and fans.

Pocket 239 pocket tool

When you find something you want to view later, put it in Pocket. Save directly from your browser or from apps like X (Twitter), Flipboard, Pulse and Zite.

Print 998 print tool

Easily print any page with just one click.

PrintFriendly 236 printfriendly tool

PrintFriendly makes printing on the web better. You'll save paper and ink, plus get great looking documents.

Rakuten (楽天ブログ) 1039 rakuten_blog tumblelog

Rakuten Blog is a blogging platform offered by Rakuten, a leading e-commerce and technology company.

It enables individuals and businesses to create and customize their own blogs easily. With various templates and tools, users can share their thoughts, showcase products, and promote brands.

Rakuten Blog is most popular in Japan.

Reddit 40 reddit news

Reddit is one of the most popular websites on the internet, and you can find pretty much anything there. At its core, Reddit is a social sharing website. It’s built around users submitting links, pictures, and text, which everyone can then vote on. The best content rises to the top, while downvoted content becomes less visible.

Renren 1025 renren socialnetwork

The Renren Network, formerly known as the Xiaonei Network is a Chinese social networking service similar to Facebook. It is popular among college students.

Sina Weibo 969 weibo socialnetwork

Sina Weibo is a Chinese microblogging website. Akin to a hybrid of sites Facebook and X (Twitter), it is one of the most popular sites in China.

Skype 989 skype socialnetwork

Skype is a VoIP service, which allows people to make and receive free voice and video calls online.

SMS 975 sms mobile

Mobile is king. The use of SMS messaging clients (includes Apple's iMessage) continues to grow as a powerful way to share content with family, friends and colleagues.

Snapchat 1003 snapchat socialnetwork

Snapchat lets you easily talk with friends, view Live Stories from around the world, and explore news in Discover. Life's more fun when you live in the moment!

Snapchat has over 229 million daily active users worldwide. Your marketing strategy should clearly have a Snapchat component.

Stocktwits 1022 stocktwits socialnetwork

StockTwits is a social media platform designed for sharing ideas between investors, traders, and entrepreneurs.

Stumpedia 192 stumpedia bookmark is a social search engine that relies on human participation to index, organize, and review the world wide web.

Techmeme 204 techmeme news

Techmeme is a technology news aggregator. The website has been described as "a one-page, aggregated, filtered, archiveable summary in near real-time of what is new and generating conversation"

Telegram 1000 telegram bookmark

Telegram is a cloud-based instant messaging and voice over IP service. Users can send messages and exchange photos, videos, stickers, audio and files of any type.

Tencent QQ (Qzone) 1029 tencent socialnetwork

Tencent QQ, also known as QQ, offers services that provide online social games, music, shopping, microblogging, movies, and group and voice chat. There are more than 800 million QQ accounts.

Threads 1033 threads socialnetwork

Threads is Instagram's text-based conversation app where communities come together to discuss everything from the topics you care about today to what'll be trending tomorrow.

Whatever it is you're interested in, you can follow and connect directly with your favorite creators and others who love the same things -- or build a loyal following of your own to share your ideas, opinions, and creativity with the world.

Threema 1038 threema socialnetwork

Threema is a secure and private messaging app that is perfect for anyone who wants to protect their communications. It is end-to-end encrypted, meaning that only the sender and recipient can read messages, not even Threema. You do not need to provide any personal information to use Threema, and the app is open source so that anyone can inspect the code. Threema is a great choice for individuals, journalists, activists, and businesses who need a secure and private way to communicate.

TinyURL 223 tinyurl urlshortener

TinyURL is a URL shortening service, which provides short aliases for redirection of long URLs.

Trello 1008 trello tool

Trello is a collaboration tool that organizes your projects into boards. In one glance, Trello tells you what is being worked on, who is working on what, and where something is in a process.

Truth Social 1035 truthsocial socialnetwork

Truth Social is a social media platform launched by former U.S. President Donald Trump. It aims to provide a space for conservative users to share and interact without perceived censorship. Its features and policies prioritize free speech and expression, targeting those who feel marginalized on mainstream platforms.

Tumblr 78 tumblr tumblelog

Tumblr lets you effortlessly share anything. Post text, photos, quotes, links, music, and videos, from your browser, phone, desktop, email, or wherever you happen to be. You can customize everything, from colors, to your theme's HTML.

TypePad Post 220 typepad_post blog

TypePad is the premier blogging service for professionals and small businesses. TypePad hosts many popular blogs and small business websites.

Viadeo 92 viadeo socialnetwork

Viadeo is a professional social network whose members include business owners, entrepreneurs and managers.

Viber 1007 viber mobile

Viber is a mobile application that allows you to make phone calls and send text messages to all other Viber users for free.

VK 953 vk socialnetwork is the most popular social network service in Russia, Ukraine, Belarus and Kazakhstan.

We Heart It 212 we_heart_it bookmark

We Heart It is your home for inspiring images and the people who heart them.

WeChat 1009 wechat im

First released in 2011, WeChat is a free messaging app that allows you to easily connect with family & friends across countries. In its home market of China, WeChat is marketed as Weixin and was rebranded as WeChat in 2012 for international audiences. WeChat began life as a messaging platform similar to WhatsApp, but now does much more. As well as being one of the largest social networks in existence, it also allows users to shop online, book taxis, make restaurant reservations and order food through its mobile payment system WeChat Pay.

WhatsApp 974 whatsapp im

WhatsApp is the world's biggest cross-platform messaging app and one of the most secure ways to communicate with loved ones and friends abroad. WhatsApp is known for its enhanced privacy features, like end-to-end encryption, and its free web-based international calling.

WordPress Blog 230 wordpress_blog blog

WordPress is a Content Management System (CMS), a platform you can use to build and maintain a website without any knowledge of coding. This software enables you to customize just about every aspect of your site.

Wykop 285 wykop bookmark is a Polish social networking service. It is modeled after the American website (wykop in Polish language means unearth! or dig out!), it's also very similar to

X (Twitter) 7 twitter socialnetwork

X is a free social networking and micro-blogging service that enables its users to send and read messages.

Xing 968 xing socialnetwork

XING is business social networking site with over 16 million members in German-speaking countries. Workers from every industry use XING to connect with one another, to look for jobs, new hires, projects, cooperation partners, expert advice and business ideas.

Yahoo! Mail 54 yahoo_mail email

Yahoo Mail is a free web-based email service.

Yammer 253 yammer socialnetwork

Yammer is a tool for making companies and organizations more productive through the exchange of short frequent answers to one simple question: 'What are you working on?'

Yummly 956 yummly socialnetwork

Yummly is the recipe app and site that learns what you like. With over 2 million recipes and food related articles and videos, it's the ultimate kitchen tool. Whether it's finding a recipe, meal planning or taking a digital grocery list to the store, Yummly makes it easier for foodies to do what they love – discover, cook, eat and share!

Yummly uses patent-pending technology, and a hand-curated knowledge graph to offer a semantic web search engine for food, cooking and recipes. Yummly allows users to search by ingredient, diet, allergy, nutrition, price, cuisine, time, taste, meal courses and sources; and "learns" about users based on their likes and dislikes. Yummly uses this information to categorize food for search and make recommendations.

Error codes

Code Description
100 apikey not provided
101 apikey provided is invalid
105 v not provided
106 apitype not provided
111 service provided is invalid
130 link not provided
131 link provided is invalid

Rate Limits

In order to maintain an efficient, secure, and high-performing API, there are limits on how many times this API can be called in any given period. If you exceed your per-hour or per-minute call limit, you will receive a rate_limit_exceeded 429 error. To increase your limit, subscribe to a higher plan or contact your account manager for assistance. API responses include X-RateLimit-* headers that describe rate limit usage.


If you believe you have found a bug, or you’d like to request additional functionality, or you release something using this API, we’d love to hear from you.

Build with Shareaholic

Developer Tools and APIs that are reliable, stable, and fast. Built and run on the same scaled cloud infrastructure that runs Shareaholic products and powers functionality across over 300,000+ sites. Over 10 rock solid years in production.

As seen in