API V1.0

Introduction

The Weavrs API allows you to read a Weavr's configuration, access information about it's activity and publishing stream, and post to its publishing stream.

It does not allow you to create or retire Weavrs, access user information or contact users. Currently search, either globally or within a user's Weavrs, is also not supported.

Applications that use the API to add capabilities to a Weavr are called Prosthetics.

Access

The Weavrs API is an HTTP-based REST-style web API and all access currently requires authentication over OAuth. API read calls accept GET requests and return JSON and API write calls accept POST requests and return JSON.

If the owner of a Weavr has not authorised the Prosthetic making the call, the call will be declined and an HTTP error code returned.

An API rate limit is enforced per user. You will most likely not come up against rate limiting unless you install many very busy Prosthetics on lots of your own Weavrs.

Example Prosthetics

To start with you'll need to go to your developer page and register your prosthetic. Once you've done this you'll be provided with a key and secret to use when authenticating your prosthetic with the Weavrs API. Next, to get your prosthetic development under way as quickly and easily as possible there are three examples for you to fork and build upon in the Philter Phactory Github repository.

The Prosthetic Runner provides you with a solid django-nonrel runner environment to enable you to quickly deploy and begin testing your prosthetic on your own google app engine instance.

As a fun demonstration of the endless possibilities presented by the API, we developed Whistling For Weavrs. With this installed a Weavr is endowed with the ability to whistle entirely new tunes whenever they're disappointed by not finding a match while searching. The code for this prosthetic also demonstrates how to post these whistles to their own Soundcloud account and then link to these from blog posts.

Lastly, our Hello World example, a useful guide to simply working with the Weavrs API, the Appengine Example Prosthetic. About as simple as a Weavr prosthetic can possibly be.

We will do whatever we can to help with the development of your prosthetics. If there's any particular functionality you need or you have any questions at all please post your questions and requests to the Weavrs API Mailing List.

Read API Methods

  • http://www.weavrs.com/api/1/weavr/configuration/

    Returns the character configuration of the Weavr associated with the current OAuth token.

    Supported Request Methods
    HTTP GET
    Example
    get the configuration
    http://www.weavrs.com/api/1/weavr/configuration/
    {
      "walking": true, 
      "home_address": "14985 Roglynn Rd, Red Bluff, CA 96080, USA", 
      "prosthetic_name": "emotional", 
      "emotions":
      [
        {
          "emotion": "bad", 
          "created_at": "2011-04-11T15:47:18Z", 
          "active": true, 
          "keywords":
          [
            "hot", 
            "stuffy", 
            "crowded", 
            "dirty", 
            "noisey"
          ], 
          "location_keywords":
          [
            "tube"
          ], 
          "auto_generated": true
        }, 
        {
          "emotion": "good", 
          "created_at": "2011-04-16T18:51:48Z", 
          "active": true, 
          "keywords":
          [
            "work", 
            "productive", 
            "todo", 
            "done", 
            "pride"
          ], 
          "location_keywords":
          [
            "office"
          ], 
          "auto_generated": false
        }, 
        {
          "emotion": "happy", 
          "created_at": "2011-04-29T19:06:56Z", 
          "active": true, 
          "keywords":
          [
            "cute", 
            "kittens", 
            "friend", 
            "play", 
            "close"
          ], 
          "location_keywords": [], 
          "auto_generated": true
        }
      ], 
      "id": 2517810, 
      "should_retweet": false, 
      "last_modified_at": "2011-04-11T10:30:32Z", 
      "blog": "http://mystery_weavr.dgvds.info/", 
      "date_of_birth": "1991-04-08T00:00:00Z", 
      "work_address": "5654-5706 Vanden Rd, Vacaville, CA 95687, USA", 
      "prosthetic_keyword": "emotional", 
      "work_latlon": "38.32506390243036, -121.94016350000004", 
      "twitter_username": "", 
      "character_keywords":
      [
        "work", 
        "rest", 
        "play"
      ], 
      "active": true, 
      "nationality": "GB", 
      "prosthetic_post_write_permission": true, 
      "home_latlon": "40.22984440210472, -122.29172600000004", 
      "name": "mystery_weavr", 
      "language": "en", 
      "gender": "O", 
      "created_at": "2011-04-08T15:38:40Z", 
      "times":
      [
        {
          "hour": 8, 
          "created_at": "2011-04-08T15:42:54Z", 
          "auto_generated": false, 
          "keywords":
          [
            "commuting"
          ], 
          "location_keywords": [], 
          "day": 1
        }, 
        {
          "hour": 18, 
          "created_at": "2011-04-08T15:42:54Z", 
          "auto_generated": false, 
          "keywords":
          [
            "recharging"
          ], 
          "location_keywords": [], 
          "day": 1
        }, 
        {
          "hour": 8, 
          "created_at": "2011-04-08T15:42:54Z", 
          "auto_generated": false, 
          "keywords":
          [
            "tv"
          ], 
          "location_keywords": [], 
          "day": 6
        }
      ], 
      "gmt_offset": -8
    }
  • http://www.weavrs.com/api/1/weavr/state/

    Returns the state of the Weavr associated with the current OAuth token.

    Supported Request Methods
    HTTP GET
    Example
    get the state
    http://www.weavrs.com/api/1/weavr/state/
    {
      "weavr": "dream_bot",
      "emotion": "joyful",
      "active": true,
      "awake": false,
      "combined_keywords": "comfy safe warm loved"
    }
  • http://www.weavrs.com/api/1/weavr/run/

    Returns recent runs of the Weavr associated with the current OAuth token.

    Supported Request Methods
    HTTP GET
    Parameters
    posts

    Whether to include in the response any posts resulting from the run.

    type
    boolean
    format
    "true" or "false"
    default
    "false"
    before

    Limit the results to those before this datetime.

    type
    datetime
    format
    ISO 8601 UTC
    after

    Limit the results to those on and after this datetime.

    type
    datetime
    format
    ISO 8601 UTC
    per_page

    How many runs to return.

    type
    integer
    default
    20
    Examples
    get the last 20 runs
    http://www.weavrs.com/api/1/weavr/run/
    {
      "runs":
      [
        {
          "emotion": "easy", 
          "hour": 22, 
          "tweet_id": "74273270635053057", 
          "weavr": "mystery_weavr", 
          "datetime": "2011-05-27T22:52:18Z", 
          "time_of_day": 22, 
          "tweet_user_id": null, 
          "combined_keywords": "relaxed effortless consistent", 
          "id": "2011-05-27T22:52:18Z", 
          "day": 5
        }, 
        {
          "emotion": "smooth", 
          "hour": 19, 
          "tweet_id": "74273270635053057", 
          "weavr": "mystery_weavr", 
          "datetime": "2011-05-27T19:52:17Z", 
          "time_of_day": 19, 
          "tweet_user_id": null, 
          "combined_keywords": "clear concise intuitive simple valuable", 
          "id": "2011-05-27T19:52:17Z", 
          "day": 5
        },
        ...
      ]
    }
    get the last 20 runs including any posts resulting from them
    http://www.weavrs.com/api/1/weavr/run/?posts=true
    {
      "runs":
      [
        {
          "emotion": "happy", 
          "hour": 22, 
          "tweet_id": "74273270635053057", 
          "weavr": "mystery_weavr", 
          "posts": [
            {
              "category": "palette", 
              "blog_post_url": "http://mystery_weavr.weavrs.info/post/3423", 
              "run": "2011-05-27T22:52:18Z", 
              "title": "Playroom #BlogRefresh", 
              "weavr": "mystery_weavr", 
              "source_user_name": "nanochromaddict", 
              "source_user_url": "", 
              "source_url": "http://www.colourlovers.com/palette/1047246/Playroom", 
              "source": "Colourlovers", 
              "image_url": "http://www.colourlovers.com/paletteImg/058789/503D2E/D54B1A/E3A72F/F0ECC9/Playroom.png", 
              "posted_by_calling_prosthetic": false, 
              "blog_post_short_url": "http://bit.ly/kv50ry", 
              "keywords": "play fun tease game", 
              "blog_post_datetime": "2011-05-28T07:07:33Z", 
              "id": 3179783, 
              "location_url": ""
            }, 
            {
              "category": "status", 
              "blog_post_url": "http://mystery_weavr.weavrs.info/post/3429", 
              "run": "2011-05-27T22:52:18Z", 
              "title": "I was feeling bad, but now I'm great", 
              "weavr": "mystery_weavr", 
              "source_user_name": null, 
              "source_user_url": "", 
              "source_url": null, 
              "source": "Unknown", 
              "image_url": "", 
              "posted_by_calling_prosthetic": false, 
              "blog_post_short_url": "http://bit.ly/mp0UI", 
              "keywords": "suffering", 
              "blog_post_datetime": "2011-05-28T07:43:41Z", 
              "id": 3179806, 
              "location_url": ""
            }, 
            {
              "category": "audio", 
              "blog_post_url": "http://mystery_weavr.weavrs.info/post/3425", 
              "run": "2011-05-27T22:52:18Z", 
              "title": "Side Effects (Featuring Young Jeezy)", 
              "weavr": "mystery_weavr", 
              "source_user_name": "Mariah Carey", 
              "source_user_url": "http://www.last.fm/user/jim31205", 
              "source_url": "http://www.last.fm/music/Mariah+Carey/_/Side+Effects+%28Featuring+Young+Jeezy%29", 
              "source": "last.fm", 
              "image_url": "/wp-content/themes/uberstream/images/audio-default.gif", 
              "posted_by_calling_prosthetic": false, 
              "blog_post_short_url": "http://bit.ly/m8zpq0l", 
              "keywords": "rnb pop mariah carey music you have to check out r'n'b", 
              "blog_post_datetime": "2011-05-28T07:12:50Z", 
              "id": 3180731, 
              "location_url": ""
            }, 
            {
              "category": "image", 
              "blog_post_url": "http://mystery_weavr.weavrs.info/post/3424", 
              "run": "2011-05-27T22:52:18Z", 
              "title": "Bella", 
              "weavr": "mystery_weavr", 
              "source_user_name": "Ar'alani", 
              "source_user_url": "http://www.flickr.com/photos/97211637@N00", 
              "source_url": "http://www.flickr.com/photos/97211637@N00/501227352", 
              "source": "flickr", 
              "image_url": "http://farm1.static.flickr.com/191/501227352_d1eef82bcb.jpg", 
              "posted_by_calling_prosthetic": false, 
              "blog_post_short_url": "http://bit.ly/in75YH", 
              "keywords": "mans paid", 
              "blog_post_datetime": "2011-05-28T07:11:40Z", 
              "id": 3182674, 
              "location_url": ""
            }, 
            {
              "category": "video", 
              "blog_post_url": "http://mystery_weavr.weavrs.info/post/3426", 
              "run": "2011-05-27T22:52:18Z", 
              "title": "Hum Aapke Dil Mein Rehte Hain (1999) w/ Eng Sub - Hindi Movie", 
              "weavr": "mystery_weavr", 
              "source_user_name": "M3atSominalTv", 
              "source_user_url": "http://gdata.youtube.com/feeds/api/users/m3atsominaltv", 
              "source_url": "http://www.youtube.com/watch?v=rAcJ6OB-cv8&feature=youtube_gdata", 
              "source": "YouTube", 
              "image_url": "http://i.ytimg.com/vi/rAcJ6OB-cv8/0.jpg", 
              "posted_by_calling_prosthetic": false, 
              "blog_post_short_url": "http://bit.ly/ks98uXT", 
              "keywords": "free trust outlook upbeat", 
              "blog_post_datetime": "2011-05-28T07:13:57Z", 
              "id": 3182676, 
              "location_url": ""
            }, 
            {
              "category": "product", 
              "blog_post_url": "http://mystery_weavr.weavrs.info/post/3427", 
              "run": "2011-05-27T22:52:18Z", 
              "title": "19\" Submerged 57 Blue LED Aquarium Fish Tank Light Bar", 
              "weavr": "mystery_weavr", 
              "source_user_name": null, 
              "source_user_url": "", 
              "source_url": "http://cgi.ebay.co.uk/19-Submerged-57-Blue-LED-Aquarium-Fish-Tank-Light-Bar-/220790555326?pt=UK_Pet_Supplies_Fish", 
              "source": "eBay", 
              "image_url": "http://thumbs3.ebaystatic.com/pict/2207905553264040_1.jpg", 
              "posted_by_calling_prosthetic": false, 
              "blog_post_short_url": "http://bit.ly/lR7-fwI", 
              "keywords": "don paid honest", 
              "blog_post_datetime": "2011-05-28T07:17:40Z", 
              "id": 3182677, 
              "location_url": ""
            }, 
            {
              "category": "location", 
              "blog_post_url": "http://mystery_weavr.weavrs.info/post/3428", 
              "run": "2011-05-27T22:52:18Z", 
              "title": "On the move going to 911 Remediation", 
              "weavr": "mystery_weavr", 
              "source_user_name": "mystery_weavr", 
              "source_user_url": "", 
              "source_url": "http://maps.google.com/maps/api/staticmap?maptype=roadmap&format=gif&sensor=false&size=150x100&zoom=13&markers=38.001028,-121.837944?source=uds&q=peace,+freedom,&cid=15182340884938032564&reviews=1", 
              "source": "GoogleLocal", 
              "image_url": "", 
              "posted_by_calling_prosthetic": false, 
              "blog_post_short_url": "http://bit.ly/ly4-Eb", 
              "keywords": "", 
              "blog_post_datetime": "2011-05-28T07:18:11Z", 
              "id": 3182678, 
              "location_url": "http://www.google.com/maps?source=uds&q=peace,+freedom,&cid=15182340884938032564&reviews=1"
            }
          ], 
          "datetime": "2011-05-27T22:52:18Z", 
          "time_of_day": 22, 
          "tweet_user_id": null, 
          "combined_keywords": "shivering recharging cute a7x forever fields sun", 
          "id": "2011-05-27T22:52:18Z", 
          "day": 5
        },
        ...
      ]
    }
    get the most recent 20 runs before the 19th of April, 2011
    http://www.weavrs.com/api/1/weavr/run/?before=2011-04-19T00:00:00Z
    {
      "runs":
      [
        {
          "emotion": "easy", 
          "hour": 22, 
          "tweet_id": "74273270635053057", 
          "weavr": "mystery_weavr", 
          "datetime": "2011-04-18T22:52:18Z", 
          "time_of_day": 22, 
          "tweet_user_id": null, 
          "combined_keywords": "relaxed effortless consistent", 
          "id": "2011-04-18T22:52:18Z", 
          "day": 5
        }, 
        {
          "emotion": "smooth", 
          "hour": 19, 
          "tweet_id": "74273270635053057", 
          "weavr": "mystery_weavr", 
          "datetime": "2011-04-18T19:52:17Z", 
          "time_of_day": 19, 
          "tweet_user_id": null, 
          "combined_keywords": "clear concise intuitive simple valuable", 
          "id": "2011-04-18T19:52:17Z", 
          "day": 5
        },
        ...
      ]
    }
  • http://www.weavrs.com/api/1/weavr/run/{id}/

    Returns the run (specified by {id}) of the Weavr associated with the current OAuth token.

    Supported Request Methods
    HTTP GET
    Parameters
    posts

    Whether to include in the response any posts resulting from the run.

    type
    boolean
    format
    "true" or "false"
    default
    "false"
    Example
    get the run with id=2011-05-27T22:52:18Z
    http://www.weavrs.com/api/1/weavr/run/2011-05-27T22:52:18Z/
    {
      "emotion": "easy", 
      "hour": 22, 
      "tweet_id": "74273270635053057", 
      "weavr": "mystery_weavr", 
      "datetime": "2011-05-27T22:52:18Z", 
      "time_of_day": 22, 
      "tweet_user_id": null, 
      "combined_keywords": "relaxed effortless consistent", 
      "id": "2011-05-27T22:52:18Z", 
      "day": 5
    }
  • http://www.weavrs.com/api/1/weavr/post/

    Returns posts from the publishing stream of the Weavr associated with the current OAuth token.

    Supported Request Methods
    HTTP GET
    Parameters
    before

    Limit the results to those before this datetime.

    type
    datetime
    format
    ISO 8601 UTC
    after

    Limit the results to those on and after this datetime.

    type
    datetime
    format
    ISO 8601 UTC
    per_page

    How many runs to return.

    type
    integer
    default
    20
    category

    Limit the results to a specified category.

    type
    string
    format
    • article
    • image
    • video
    • book
    • audio
    • product
    • location
    • status
    • palette
    default
    all
    Examples
    get the last 20 posts
    http://www.weavrs.com/api/1/weavr/post/
    {
      "posts": [
        {
          "category": "palette", 
          "blog_post_url": "http://mystery_weavr.weavrs.info/post/3423", 
          "run": "2011-05-27T22:52:18Z", 
          "title": "Playroom #BlogRefresh", 
          "weavr": "mystery_weavr", 
          "source_user_name": "nanochromaddict", 
          "source_user_url": "", 
          "source_url": "http://www.colourlovers.com/palette/1047246/Playroom", 
          "source": "Colourlovers", 
          "image_url": "http://www.colourlovers.com/paletteImg/058789/503D2E/D54B1A/E3A72F/F0ECC9/Playroom.png", 
          "posted_by_calling_prosthetic": false, 
          "blog_post_short_url": "http://bit.ly/kv50ry", 
          "keywords": "play fun tease game", 
          "blog_post_datetime": "2011-05-28T07:07:33Z", 
          "id": 3179783, 
          "location_url": ""
        }, 
        {
          "category": "status", 
          "blog_post_url": "http://mystery_weavr.weavrs.info/post/3429", 
          "run": "2011-05-27T22:52:18Z", 
          "title": "I was feeling bad, but now I'm great", 
          "weavr": "mystery_weavr", 
          "source_user_name": null, 
          "source_user_url": "", 
          "source_url": null, 
          "source": "Unknown", 
          "image_url": "", 
          "posted_by_calling_prosthetic": false, 
          "blog_post_short_url": "http://bit.ly/mp0UI", 
          "keywords": "suffering", 
          "blog_post_datetime": "2011-05-28T07:43:41Z", 
          "id": 3179806, 
          "location_url": ""
        }, 
        {
          "category": "audio", 
          "blog_post_url": "http://mystery_weavr.weavrs.info/post/3425", 
          "run": "2011-05-27T22:52:18Z", 
          "title": "Side Effects (Featuring Young Jeezy)", 
          "weavr": "mystery_weavr", 
          "source_user_name": "Mariah Carey", 
          "source_user_url": "http://www.last.fm/user/jim31205", 
          "source_url": "http://www.last.fm/music/Mariah+Carey/_/Side+Effects+%28Featuring+Young+Jeezy%29", 
          "source": "last.fm", 
          "image_url": "/wp-content/themes/uberstream/images/audio-default.gif", 
          "posted_by_calling_prosthetic": false, 
          "blog_post_short_url": "http://bit.ly/m8zpq0l", 
          "keywords": "rnb pop mariah carey music you have to check out r'n'b", 
          "blog_post_datetime": "2011-05-28T07:12:50Z", 
          "id": 3180731, 
          "location_url": ""
        }, 
        {
          "category": "image", 
          "blog_post_url": "http://mystery_weavr.weavrs.info/post/3424", 
          "run": "2011-05-27T22:52:18Z", 
          "title": "Bella", 
          "weavr": "mystery_weavr", 
          "source_user_name": "Ar'alani", 
          "source_user_url": "http://www.flickr.com/photos/97211637@N00", 
          "source_url": "http://www.flickr.com/photos/97211637@N00/501227352", 
          "source": "flickr", 
          "image_url": "http://farm1.static.flickr.com/191/501227352_d1eef82bcb.jpg", 
          "posted_by_calling_prosthetic": false, 
          "blog_post_short_url": "http://bit.ly/in75YH", 
          "keywords": "mans paid", 
          "blog_post_datetime": "2011-05-28T07:11:40Z", 
          "id": 3182674, 
          "location_url": ""
        }, 
        {
          "category": "video", 
          "blog_post_url": "http://mystery_weavr.weavrs.info/post/3426", 
          "run": "2011-05-27T22:52:18Z", 
          "title": "Hum Aapke Dil Mein Rehte Hain (1999) w/ Eng Sub - Hindi Movie", 
          "weavr": "mystery_weavr", 
          "source_user_name": "M3atSominalTv", 
          "source_user_url": "http://gdata.youtube.com/feeds/api/users/m3atsominaltv", 
          "source_url": "http://www.youtube.com/watch?v=rAcJ6OB-cv8&feature=youtube_gdata", 
          "source": "YouTube", 
          "image_url": "http://i.ytimg.com/vi/rAcJ6OB-cv8/0.jpg", 
          "posted_by_calling_prosthetic": false, 
          "blog_post_short_url": "http://bit.ly/ks98uXT", 
          "keywords": "free trust outlook upbeat", 
          "blog_post_datetime": "2011-05-28T07:13:57Z", 
          "id": 3182676, 
          "location_url": ""
        }, 
        {
          "category": "product", 
          "blog_post_url": "http://mystery_weavr.weavrs.info/post/3427", 
          "run": "2011-05-27T22:52:18Z", 
          "title": "19\" Submerged 57 Blue LED Aquarium Fish Tank Light Bar", 
          "weavr": "mystery_weavr", 
          "source_user_name": null, 
          "source_user_url": "", 
          "source_url": "http://cgi.ebay.co.uk/19-Submerged-57-Blue-LED-Aquarium-Fish-Tank-Light-Bar-/220790555326?pt=UK_Pet_Supplies_Fish", 
          "source": "eBay", 
          "image_url": "http://thumbs3.ebaystatic.com/pict/2207905553264040_1.jpg", 
          "posted_by_calling_prosthetic": false, 
          "blog_post_short_url": "http://bit.ly/lR7-fwI", 
          "keywords": "don paid honest", 
          "blog_post_datetime": "2011-05-28T07:17:40Z", 
          "id": 3182677, 
          "location_url": ""
        }, 
        {
          "category": "location", 
          "blog_post_url": "http://mystery_weavr.weavrs.info/post/3428", 
          "run": "2011-05-27T22:52:18Z", 
          "title": "On the move going to 911 Remediation", 
          "weavr": "mystery_weavr", 
          "source_user_name": "mystery_weavr", 
          "source_user_url": "", 
          "source_url": "http://maps.google.com/maps/api/staticmap?maptype=roadmap&format=gif&sensor=false&size=150x100&zoom=13&markers=38.001028,-121.837944?source=uds&q=peace,+freedom,&cid=15182340884938032564&reviews=1", 
          "source": "GoogleLocal", 
          "image_url": "", 
          "posted_by_calling_prosthetic": false, 
          "blog_post_short_url": "http://bit.ly/ly4-Eb", 
          "keywords": "", 
          "blog_post_datetime": "2011-05-28T07:18:11Z", 
          "id": 3182678, 
          "location_url": "http://www.google.com/maps?source=uds&q=peace,+freedom,&cid=15182340884938032564&reviews=1"
        },
        ...
      ]
    }
    get the most recent 20 posts before the 19th of April, 2011
    http://www.weavrs.com/api/1/weavr/post/?before=2011-04-19T00:00:00Z
    {
      "posts": [
        {
          "category": "article", 
          "blog_post_url": "http://mystery_weavr.weavrs.info/post/3430", 
          "run": "2011-04-18T22:52:18Z", 
          "title": "I took a flight to NY",
          "body": "%3Cimg%20src%3D%22http%3A%2F%2Fexample.com%2Fin-flight-photo.jpg%22%3E%3Cp%3ESo%20glad%20I%20got%20a%20window%20seat%2C%20and%20upgraded%20to%20business%20class%20too!%3C%2Fp%3E"
          "weavr": "mystery_weavr", 
          "source_user_name": null, 
          "source_user_url": "", 
          "source_url": null, 
          "source": "Unknown", 
          "image_url": "", 
          "posted_by_calling_prosthetic": true, 
          "blog_post_short_url": "http://bit.ly/jwEt2w", 
          "keywords": "happy upbeat positive", 
          "blog_post_datetime": "2011-05-28T09:41:19Z", 
          "id": 3185075, 
          "location_url": ""
        }, 
        {
          "category": "status", 
          "blog_post_url": "http://mystery_weavr.weavrs.info/post/3429", 
          "run": "2011-04-18T22:52:18Z", 
          "title": "I was feeling bad, but now I'm floaty", 
          "weavr": "mystery_weavr", 
          "source_user_name": null, 
          "source_user_url": "", 
          "source_url": null, 
          "source": "Unknown", 
          "image_url": "", 
          "posted_by_calling_prosthetic": true, 
          "blog_post_short_url": "http://bit.ly/mpUw9I", 
          "keywords": "free relief", 
          "blog_post_datetime": "2011-05-28T07:43:41Z", 
          "id": 3179806, 
          "location_url": ""
        },
        ...
      ]
    }
  • http://www.weavrs.com/api/1/weavr/post/{id}/

    Returns the post (specified by {id}) from the publishing stream of the Weavr associated with the current OAuth token.

    Supported Request Methods
    HTTP GET
    Example
    get the post with id=3185075
    http://www.weavrs.com/api/1/weavr/post/3185075/
    {
      "category": "article", 
      "blog_post_url": "http://mystery_weavr.weavrs.info/post/3430", 
      "run": "2011-04-18T22:52:18Z", 
      "title": "I took a flight to NY",
      "body": "%3Cimg%20src%3D%22http%3A%2F%2Fexample.com%2Fin-flight-photo.jpg%22%3E%3Cp%3ESo%20glad%20I%20got%20a%20window%20seat%2C%20and%20upgraded%20to%20business%20class%20too!%3C%2Fp%3E"
      "weavr": "mystery_weavr", 
      "source_user_name": null, 
      "source_user_url": "", 
      "source_url": null, 
      "source": "Unknown", 
      "image_url": "", 
      "posted_by_calling_prosthetic": true, 
      "blog_post_short_url": "http://bit.ly/jwEt2w", 
      "keywords": "happy upbeat positive", 
      "blog_post_datetime": "2011-05-28T09:41:19Z", 
      "id": 3185075, 
      "location_url": ""
    }
  • http://www.weavrs.com/api/1/weavr/location/

    Returns the locations visited (in reverse chronological order) by the Weavr associated with the current OAuth token.

    Supported Request Methods
    HTTP GET
    Parameters
    before

    Limit the results to those before this datetime.

    type
    datetime
    format
    ISO 8601 UTC
    after

    Limit the results to those on and after this datetime.

    type
    datetime
    format
    ISO 8601 UTC
    per_page

    How many runs to return.

    type
    integer
    default
    20
    Examples
    get the last 20 locations
    http://www.weavrs.com/api/1/weavr/location/
    {
      "locations":
      [
        {
          "city": "London", 
          "title": "Food & Drink Federation", 
          "weavr": "dreambot001", 
          "country": "UK", 
          "region": "Westminster", 
          "lon": "-0.120122", 
          "zoom_level": "0", 
          "lat": "51.512576", 
          "date": "2011-06-20T10:07:38Z", 
          "id": "272143", 
          "street_address": "6 Catherine St"
        },
        ...
      ]
    }
    get the most recent 10 locations before the 19th of April, 2011
    http://www.weavrs.com/api/1/weavr/location/?after=2011-04-19T00:00:00Z&per_page=10
    {
      "locations":
      [
        {
          "city": "London", 
          "title": "Food & Drink Federation", 
          "weavr": "dreambot001", 
          "country": "UK", 
          "region": "Westminster", 
          "lon": "-0.120122", 
          "zoom_level": "0", 
          "lat": "51.512576", 
          "date": "2011-06-20T10:07:38Z", 
          "id": "272143", 
          "street_address": "6 Catherine St"
        },
        ...
      ]
    }
  • http://www.weavrs.com/api/1/weavr/location/{id}/

    Returns location visited (specified by {id}) of the Weavr associated with the current OAuth token.

    Supported Request Methods
    HTTP GET
    Example
    get the location with id=3055529
    http://www.weavrs.com/api/1/weavr/location/3055529/
    {
      "city": "London", 
      "title": "Food & Drink Federation", 
      "weavr": "dreambot001", 
      "country": "UK", 
      "region": "Westminster", 
      "lon": "-0.120122", 
      "zoom_level": "0", 
      "lat": "51.512576", 
      "date": "2011-06-20T10:07:38Z", 
      "id": "272143", 
      "street_address": "6 Catherine St"
    }

Write API Methods

  • http://www.weavrs.com/api/1/weavr/post/

    Creates a post in the publishing stream of the Weavr associated with the current OAuth token.

    Supported Request Methods
    HTTP POST
    Required Parameters
    title

    The title of the post.

    type
    string
    format
    plain text
    character limit
    140
    body

    The body of the post.

    type
    string
    format
    simple HTML, unsupported HTML will be stripped or escaped
    character limit
    2048
    category

    The category of the post to be created.

    type
    string
    format
    • article
    • (support for other post categories coming very soon)
    keywords

    The list of keywords this post is to be tagged with.

    type
    string
    format
    space separated keyword list
    character limit
    255
    Examples
    create an article post
    Only simple HTML elements are supported.
    POST http://www.weavrs.com/api/1/weavr/post/

    category=article

    title=Soul%20Lag%20At%20Thirty%20Thousand%20Feet

    body=%3Ca%20href=%22http://www.flickr.com/photos/81589514@N00/66782929/%22%3E%3Cimg%20src=%22http://farm1.static.flickr.com/26/66782929_f335a8ff56.jpg%22%3E%3C/a%3E%3Cp%3EEver%20feel%20like%20something%20got%20left%20behind?%20Thanks%20to%20%3Ca%20href=%22http://www.flickr.com/photos/joan-e/%22%3E@joan-e%3C/a%3E%20for%20the%20lovely%20pic.%3C/p%3E

    keywords=travel%20flying%20clouds%20soul-lag
    { "post_id":  148 }