Category Archives: Reviews API

Developer Opportunity: Pinterest + CityGrid

Pinterest is blowing up, its one of those new app crazes that has really struck a chord, primarily with women. Its all over the media and blogosphere, and everyone is talking about staggering user counts and how much traffic can drive to a website.

I started playing with the Pinterest API to see what the potential of the platform is beyond just the consumer side. The API is simple, yet robust and each and every pin potentially has latitude, longitude and other location information associated with it.

To date the consumer side of Pinterest is is organized by category and very photo based for exploration and discovery. The local potential of Pinterest doesn’t even seem tapped at all yet, leaving huge opportunity for developers to build something cool that allows users to explore interesting things in a map, by city, neighborhood, zip code or in real-time via their mobile phone.

With this opportunity I’m adding it to my developer opportunity list. Seems like Pinterest API combined with CityGrid Places, Offers and Reviews APIs, you could make some interesting user experiences allowing web and mobile users to explore interesting things right around them.

You could easily monetize just by showing CityGrid places along with Pinterest content, and if you wanted to further monetize with CityGrid local advertising. I’m going to play with some PHP, Python and Ruby samples for Pinterest + CityGrid integrations, then maybe some mobile samples as well.

Let me know if you have any ideas as well.

More Control Over CityGrid Review API Requests

I had a CityGrid developer post on the forum today, that they were concerned about the age of some of the reviews they were getting back with API requests.

When they did a search for the Old Spaghetti Factory in Portland, OR–one of the reviews was nine years old.

When making a detail request against the CityGrid Places API you get reviews back with the business listing, without much control over how many, or which reviews when making the request.

Alternatively you can make a request against the CityGrid Reviews API, requesting a broad “where” or longtitue/latitude search for reviews, or specifically request the reviews for a specific places ID.

Three of the primary request fields you can adjust when making a CityGrid Reviews API request are:

  • rating – minimal rating for reviews
  • days – maximum age i days for the reviews
  • rpp – number of results to be returned

Using the CityGrid Reviews API you can get more granular level control over the reviews you display for a city, neighborhood, zip code, specific categories and for specific businesses you are profiling.

Make sure and think about how you will handle reviews for your web or mobile application, and better deliver business reviews for your users, using the CityGrid Reviews API in addition to the CityGrid Places API.

Hyp3r0cal for WordPress

I wanted a way to make the rich content available via CityGrid APIs accessible to anyone, even if you weren’t a developer.

CityGrid has some great iOS and Android software development kits (SDK) available for building local, mobile applications.  I’ve also built some samples and starter kits for building local web applications in PHP, Python and Ruby.

WordPress seemed like the perfect next step to reach a larger audience, so I took the PHP Hyp3rL0cal directory that uses CityGrid Places API, and deployed it as a WordPress Plugin.

Now you can launch a quick section on your WordPress blog or site that allows you to display businesses for your area, in whatever category you wish.

This CityGrid Hyp3rL0cal WordPress Plugin is meant to be a project that developers can learn from and even deploy their own local WordPress Plugins that use CityGrid APIs.  However its completely functional and could be deployed by any non-developer as well.

Right now you can download or fork at Github, as I stabilize it further I will publish to the CityGrid developer center code samples page.

If you have any questions or need help, visit the CityGrid Developer Forums or ping us on Twitter via @citygridapiteam.