By findery
Updated a year ago

Findery API Documentation

At Findery, we love sharing interesting stories about places around the world. Up until now, the only way to join the party was through or our apps.

Now there’s a backstage pass with the Findery API.

Using the Findery API, developers can integrate with Findery. Create Findery notes for any location, gather notes into collections (we call them notemaps), and discover interesting places nearby. The Findery API is free and includes endpoints for notes, notemaps, comments, users, following, and more.

What can I do with the API?

With the Findery API, you can take advantage of our great content, near and far. Get nearby notes for local discovery, tourism, or the awesome tidbits you won’t find in history books. Display notes about your business to show how much customers love you. Create a notemap full of hidden treasures to visit. We look forward to finding new uses for Findery!

How do I get started?

The Findery API is free and easy. If you have experience with APIs, you should feel right at home. The Findery API implements the OAuth 2.0 standard for secure authentication and authorization and uses SSL for communication.

Get started by registering your app. It only takes a few minutes. Feel free to ask us questions on Stack Overflow.

Learn more about this API
GETGet a list of notes
GETGet a note
POSTCreate a note
PUTEdit a note.
DELETEDelete a note.
GETGet a list of tags for a note
GETGet a list of comments for a note
GETGet a comment
POSTCreate a comment
PUTEdit a comment
DELETEDelete a comment
GETGet users that have found a note
GETGet users who've favorited a note
POSTFavorite a note
DELETEUnfavorite a note
GETGet a user
GETGet a user by username
GETGet a user's favorite notes.
GETGet a user's notes.
GETGet a user's notemaps.
GETGet notemaps a user follows
GETGet users that follow user
GETGet users a user is following.
POSTFollow a user
DELETEUnfollow a user
GETGet notemaps
GETGet notemap
POSTCreate a notemap
PUTEdit a notemap
DELETEDelete a notemap
GETGet notes from a notemap
POSTAdd a note to a notemap
DELETERemove a note from a notemap
GETGet the followers for a notemap
POSTFollow a notemap
DELETEUnfollow a notemap
GETGet tags used in the notes in the notemap
GETGet notes by tag
GETGet a list of notes

Get a list of notes Method & URL


Prior to authenticating with the API you will need to register your application to get a clientid and a clientsecret.

Header Parameters
REQUIREDPrior to authenticating with the API you will need to register your application to get a client_id and a client_secret.
Code Snippet
Install SDK
Response ExampleSchema

Install SDK for (Node.js)Unirest

OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication