GigPark's API Documentation

See GigPark API in action

Check out the widgets page for working examples.

Are you using GigPark API?

If you have questions, or just want to let us know about cool projects you are working on with our API, let us know at

JSON

GigPark makes some data available for developers, via an API.

Getting started

The GigPark API accepts RESTful requests, and returns JSON encoded responses. There are a number of ways to get data about the recommendations made through GigPark, including details for a specific recommendation, its associated business, recommendations made by a specific member, and recommendations made for a specific business.

JSON Objects

GigPark has several different types of objects that it represents: recommendations, businesses, and users. Below are the keys associated with each object.

Recommendation Object

business_id
city
comment
country
created_at
created_at_ago_in_words
name
service
string_id
times_viewed
user

User Object

abbr_name
business_id
city
country
created_at
created_at_ago_in_words
name
profile_picture
profile_picture_small
string_id

Business Object

autohound_id
city
country
created_at
created_at_ago_in_words
name
num_recommendations
service
string_id
total_views

Get the data

GigPark objects can be retrieved from the following URLs. All objects are requested based on their given string_id.

Recommendation

http://www.gigpark.com/recommendations/string_id.json

Please note that, as a convenience, when retrieving recommendation objects the corresponding business object is returned as well. E.g.:

{"recommendation": recommendation_object,
 "business": business_object }

User

http://www.gigpark.com/people/string_id.json

Business

http://www.gigpark.com/business/string_id.json

JSONP

JSONP can be used to circumvent the Same Origin Policy in browsers. Essentially, the JSON response can be wrapped in a callback function:

http://www.gigpark.com/recommendations/string_id.json?callback=function_name

Sample request

curl 'http://www.gigpark.com/recommendations/a6a9d34a1.json?callback=my_function'

Sample response

my_function({
  "recommendation": recommendation_object,
  "business": business_object
})

Get all recommendations by a specific member

You may request the data for the latest recommendations made by a specific GigPark member, based on that user's string_id.

http://www.gigpark.com/people/string_id/recommendations.json

The call will return an array of recommendations, up to a limit specified. The limit is capped at 100, and the unspecified value defaults to 20. The response could be wrapped in a callback function.

Sample request

curl 'http://www.gigpark.com/people/tonytargonski/recommendations.json?limit=2&callback=my_function'

Sample response

my_function({
  "recommendations": [
    recommendation_object_1,
    recommendation_object_2
  ]
})

Get all recommendations for a specific Business

You may request the data for recommendations made by all GigPark members for a specific Business, based on business' string_id.

http://www.gigpark.com/businesses/string_id/recommendations.json

The call will return an array of recommendations, up to a limit specified. The limit is capped at 100, and the unspecified value defaults to 20. As a convenience the business object is returned as well. The response could be wrapped in a callback function.

The order of recommendations returned is the same as they would appear on their GigPark business page. Typically the newest recommendations will appear earlier in the list, but PRO businesses might choose to reorder the recommendations made for their business.

Sample request

curl 'http://www.gigpark.com/businesses/gigpark/recommendations.json?limit=2&callback=my_function'

Sample response

my_function({
  "business": business_object,
  "recommendations": [
    recommendation_object_1,
    recommendation_object_2
  ]
})

Atom

GigPark also offers several Atom feeds that aggregate recommendations for gigpark, users, and businesses. These Atom feeds can be used in news reader applications (e.g. Google Reader ) or for your own applications.

Getting the feed

Just like the JSON, GigPark Atom feeds can be retrieved from the following URLs. All feeds are requested based on their given string_id.

User Feeds

http://www.gigpark.com/people/string_id.atom

Business Feeds

http://www.gigpark.com/businesses/string_id.atom

GigPark Feed

http://feeds2.feedburner.com/gigpark

Please note that Atom feeds are paginated with 20 items per page.

GigPark