The Web Blend API

The Web Blend API is in Beta at the moment, but we're looking for developers and designers to try it out and help us work out the kinks. You'll need to request an API key to be able to use it. The v1 API responses are returned in JSON format and all of the queries are read-only. All requests must be prefaced by http://api.thewebblend.com/.

We're excited to see what you create, so if you've got some interesting ideas that you come up with then let us know and we'll feature them on this page.

GET /services/v1/contents:

Returns the 10 most recent posts.

          
$ curl http://api.thewebblend.com/services/v1/contents?key=API_KEY
[ {"content":{"blends":1, "category_id":33, "created_at":"2012-04-25T14:05:28+00:00", "id":36508, "link":"http://www.topcmsthemes.com/origin-free-wordpress-blogging-theme/", "text":"Use this free simple, minimal WordPress blogging theme for your personal blogging needs - the most elegant way possible!", "title":"Origin Free WordPress Blogging Theme", "updated_at":"2012-04-25T14:05:28+00:00", "user_id":9871, "image_url":null, "category_name":"WordPress"}}, .... ]

You can also apply filters to the content to change the result set.

          
$ curl http://api.thewebblend.com/services/v1/contents?key=API_KEY&date=today&page=2
$ curl http://api.thewebblend.com/services/v1/contents?key=API_KEY&type=links
$ curl http://api.thewebblend.com/services/v1/contents?key=API_KEY&category=web_theme
$ curl http://api.thewebblend.com/services/v1/contents?key=API_KEY&type=images
$ curl http://api.thewebblend.com/services/v1/contents?key=API_KEY&date=week
$ curl http://api.thewebblend.com/services/v1/contents?key=API_KEY&date=month
$ curl http://api.thewebblend.com/services/v1/contents?key=API_KEY&date=year

GET /services/v1/contents/:id:

Returns details about a post.

          
$ curl http://api.thewebblend.com/services/v1/contents/36501?key=API_KEY
{"content":{"blends":5, "category_id":10, "created_at":"2012-04-25T12:53:50+00:00", "id":36501, "link":"http://homedesignlover.com/home-design/staircase-design-tips/", "text":"A staircase is a vital part of home which can aid the homeowners to get into other areas of the house especially those from the upper areas. ", "title":"What to Consider in Choosing a Staircase Design", "updated_at":"2012-04-25T14:36:11+00:00", "user_id":1209, "image_url":null, "category_name":"Interior Design", "comments":[]}}

GET /services/v1/users:

Returns the Top Users.

          
$ curl http://api.thewebblend.com/services/v1/users?key=API_KEY
[ {"user":{"bio":"Working on The Web Blend.", "contents_count":2463, "created_at":"2012-03-06T02:41:19+00:00", "facebook":"https://www.facebook.com/louis.gubitosi", "full_name":"Louis Gubitosi", "id":1, "location":"Morristown, NJ", "name":"iblend", "profession":"Designer", "profile":"Keeping you current with the latest in web related news and trends.", "twitter":"iblend", "updated_at":"2012-04-25T13:31:35+00:00", "website":"http://interactiveblend.com", "photo_url":"http://www.thewebblend.com/system/photos/1/icon/1.jpg"}}, .... ]

GET /services/v1/users/:id:

Returns info about a user.

          
$ curl http://api.thewebblend.com/services/v1/users/1?key=API_KEY
{"user":{"bio":"Working on The Web Blend.", "contents_count":2463, "created_at":"2012-03-06T02:41:19+00:00", "facebook":"https://www.facebook.com/louis.gubitosi", "full_name":"Louis Gubitosi", "id":1, "location":"Morristown, NJ", "name":"iblend", "profession":"Designer", "profile":"Keeping you current with the latest in web related news and trends.", "twitter":"iblend", "updated_at":"2012-04-25T13:31:35+00:00", "website":"http://interactiveblend.com", "photo_url":"http://www.thewebblend.com/system/photos/1/icon/1.jpg"}}

GET /services/v1/users/:id/contents:

Returns the content for a user (accepts the same filter arguments as contents API query).

          
$ curl http://api.thewebblend.com/services/v1/users/1/contents?key=API_KEY
[{"content":{"blends":1, "category_id":17, "created_at":"2012-04-24T17:30:10+00:00", "id":36451, "link":"http://dribbble.com/shots/259866-Freebie-Tiny-Social-Icons-Enhanced", "text":"I loved the way Tiny Social Icons looked, but there were only 5 icons in the set and they were not scalable. So I decided to enhance the set: make 'em all vector and added a few icons I needed for a particular project I'm working on. The best part is it's a freebie. (Royalty Free).", "title":"Freebie: Tiny Social Icons Enhanced by Ivan Tolmachev", "updated_at":"2012-04-24T17:30:10+00:00", "user_id":1, "image_url":"http://www.thewebblend.com/system/images/36451/large_list/untitled-1-2.png", "category_name":"Icons"}}, .... ]

GET /services/v1/users/:id/comments:

Returns the comments for a user.

          
$ curl http://api.thewebblend.com/services/v1/users/1/comments?key=API_KEY
[ {"comment":{"content_id":36164, "created_at":"2012-04-19T14:56:53+00:00", "id":8509, "text":"Awesome icon and great to have you back!", "updated_at":"2012-04-19T14:56:53+00:00", "user_id":1, "user_name":"iblend", "content_title":"Create a Simple Compass Icon in Illustrator"}}, .... ]

GET /services/v1/comments:

Returns all comments.

          
$ curl http://api.thewebblend.com/services/v1/comments?key=API_KEY
[ {"comment":{"content_id":36466, "created_at":"2012-04-25T02:29:49+00:00", "id":8527, "text":"sweet bear.", "updated_at":"2012-04-25T02:29:49+00:00", "user_id":11608, "user_name":"chazelton331", "content_title":"How a professional web design website can take your business to the next level?"}}, .... ]

GET /services/v1/recent_blenders:

Returns recently logged in users.

          
$ curl http://api.thewebblend.com/services/v1/recent_blenders?key=API_KEY
[ {"user":{"bio":"I am a programmer and I really enjoy writing code. Ruby, C, JavaScript, in particular...", "contents_count":31, "created_at":"2012-03-10T01:46:38+00:00", "facebook":"http://facebook.com/iwillhaveaguinnessplease", "full_name":"Cliff Hazelton", "id":11608, "location":"New Jersey", "name":"chazelton331", "profession":"Developer", "profile":"", "twitter":"chazelton331", "updated_at":"2012-04-25T13:34:23+00:00", "website":"http://hazelton.info", "photo_url":"http://www.thewebblend.com/system/photos/11608/icon/IMG_0163.JPG"}}, .... ]

GET /services/v1/newest_users:

Returns the newest confirmed users.

          
$ curl http://api.thewebblend.com/services/v1/newest_users?key=API_KEY
[ {"user":{"bio":null, "contents_count":0, "created_at":"2012-04-24T16:19:42+00:00", "facebook":"", "full_name":null, "id":12730, "location":null, "name":"myenes", "profession":null, "profile":"", "twitter":null, "updated_at":"2012-04-24T16:21:36+00:00", "website":"", "photo_url":"http://www.thewebblend.com/system/photos/12730/icon/stringio.txt"}}, .... ]

Up-arrow