URL Scheme

Opening the App

Use this URL to open Pushpin, if you don't want to do anything else.

pushpin://

Adding Bookmarks

Use this to add a bookmark.

Parameters

  • url: required
  • title: optional
  • description: optional
  • tags: optional, separate with spaces
  • unread: optional, can be "yes" or "no"
  • private: optional, can be "yes" or "no"
An example:
pushpin://add?url=http%3A%2F%2Fgoogle.com%2F&title=Google&description=A%20fantastic%20search%20engine.

Here's a bookmarklet that you can use this bookmarklet with in your favorite iOS browser:

javascript:window.location='pushpin://add?url='+encodeURIComponent(location.href)+'&title='+encodeURIComponent(document.title)

If you want to be sent back to your browser after adding your bookmark, use this bookmarklet instead:

javascript:window.location='pushpin://x-callback-url/add?url='+encodeURIComponent(location.href)+'&title='+encodeURIComponent(document.title)

Viewing Feeds

Use this to view the Pinboard feed for a user or tag, or combination thereof.

Parameters

Either "user" or "tags" is required.

  • user: just the Pinboard username
  • tags: a list of tags, separated by commas.
An example:
pushpin://feed?user=ticci&tags=pythonista,python

Opening URLs

Use this to open URLs with the Pushpin browser. Just append the URL you want to open to the "pushpin://" suffix. For example:

pushpin://google.com/

And here's a bookmarklet you can use:

javascript:window.location='pushpin://'+location.href.substring(location.href.indexOf("://") + 3)

Feedback and Knowledge Base