Yo Developers API

Is up and running

2 min readMay 20, 2014


There are endless ways to use the world’s simplest API (it only has one endpoint…).

If you run a blog, a website, a shopify online store or any other kind of service, you’ll be able to boost your engagement with the Yo API.

Some example use cases:

  1. A blog can Yo the readers whenever a new post is published. Imagine getting a Yo From PRODUCTHUNT.
  2. An online store can Yo its customers whenever a new product is offered. Imagine getting a Yo From JENNASHOPIFY.
  3. A football club can Yo the fans whenever the team scores a touchdown. Imagine getting a Yo From THE49ERS.
  4. An ice-cream truck can Yo the kids when it’s around the corner.… Imagine getting a Yo From THEICECREAMTRUCK.

How it works…

  1. Pick a Yo username for your blog/website/service, for example: JOEYSBLOG or JENNASHOPIFY or THE49ERS

2. Tell your users to Yo you at the name you registered and what they should expect when they get your Yo’s, for example:

“Yo me at JOEYSBLOG and I’ll Yo you when I publish a new post!”

“Yo me at JENNASHOPIFY and I’ll Yo you when there is a new product!

“Yo us at THE49ERS and we’ll Yo we score a touchdown!

Once they Yo the service, they are subscribed to that service Yo notifications.

They can unsubscribe by swiping out the name in the Yo app.

3. You uploaded a post and you want to Yo your subscribers! Great!

HTTP POST using your favorite language or curl --data "api_token=<your_api_token>" http://api.justyo.co/yoall/

If you want to add a link:

curl --data "api_token=<your_api_token>&link=http://mylink.com" http://api.justyo.co/yoall/

Some sample code: https://github.com/YoApp/

You can also get notified when someone Yo’s your API account by setting up a callback!

Read more: http://docs.justyo.co

Yo. It’s that simple.


Yo all the users that Yo'ed your Yo service ("subscribers"):

curl --data "api_token=<token>" http://api.justyo.co/yoall/

Specific user Yo:

curl --data "api_token=<token>&username=<username>" http://api.justyo.co/yo/

* Rate limited to one Yo per user per minute.

If you want to add a link:

HTTP POST using your favorite language or curl —data “api_token=<your_api_token>&username=<username>&link=http://mylink.com" http://api.justyo.co/yo/

See the original post on the official Yo Blog