Twinverse API

Introduction

Twinverse exposes some of its functionality via an Application Programming Interface (API). This document is a reference for that functionality, and aims to serve for developers building tools that interact with Twinverse.

Post Twinbit

URL: http://api.twinverse.com/post_twinbit

Parameters:
email_address, password, lon, lat, tags, description,
name: the twinbit title
type: "text", "video" or "pict" (default="text")
media_url: (eg http://www.youtube.com/watch?v=0FFkvhoEfX8)

Note : Don't forget to url encode string parameters containing special characters or spaces.

Return value: JSON encoded true if success false otherwise

Example:

http://api.twinverse.com/post_twinbit?name=A+twinbit&tags=test&email_address=xxx@example.com&password=xxxx&description=My+first+twinbit&lon=-122.51262187957764&nearbyplace=Sunset+District%2C+San+Francisco+County%2C+California%2C+United+States&lat=37.767288414494544&type=video&media_url=http%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3D0FFkvhoEfX8

Note: Email address and password should match a valid Twinverse account

Get Twinbits by Box

URL: http://api.twinverse.com/get_twinbits_by_box

Parameters:
south, north, west, east: bounding box coordinates,
limit: maximum number of twinbits returned (default=10)

Return value: JSON encoded list

Example:

http://api.twinverse.com/get_twinbits_by_box?west=-122.522&north=37.771&south=37.762&east=-122.502