API

GET /api/v1/ideas
GET /api/v1/ideas    List ideas nearest a point location or within a specified radius of a point location.

Return an array of ideas nearby. There are two options:
1. Return ideas within a specified radius (in miles) around a point. The most popular ideas within the radius will be returned in order of most popular.
2. Return ideas closest to a point. The closest ideas to the point will be returned first.
"minimum" is an optional parameter specifing a minimum threshold of "me toos". "radius" (in miles) is an optional parameter. "lat" and "lon" parameters are required (see below).
Two optional parameters control paging: "page" and "per page" (see below). The default "page" value is 1. The default "per_page" value is 10.

Parameters

lat
The latitude of the location to search.
lon
The longitude of the location to search.
minimum
(optional)
The minimum number of total supporters of ideas. Default is 1.
page
(optional)
The number of the page. Default is 1. Must be between 1 and 10000.
per_page
(optional)
The number of cities returned per page. Default is 10. Must be between 1 and 500.
radius
(optional)
The distance in miles around the center point of ideas to include.

curl Examples

curl https://neighborland.com/api/v1/ideas?lat=40.1234&lon=-99.7899
curl https://neighborland.com/api/v1/ideas?lat=40.1234&lon=-99.7899&radius=1.5
curl https://neighborland.com/api/v1/ideas?lat=40.1234&lon=-99.7899&minimum=10
curl https://neighborland.com/api/v1/ideas?lat=40.1234&lon=-99.7899&radius=50minimum=10
curl https://neighborland.com/api/v1/ideas?lat=40.1234&lon=-99.7899&page=2
curl https://neighborland.com/api/v1/ideas?lat=40.1234&lon=-99.7899&page=2&per_page=5

Example Response

[
  {
    "id": "nola-st-claude-more-live-theater-and-ind",
    "url": "https://neighborland.com/api/v1/ideas/nola-st-claude-more-live-theater-and-ind",
    "alternate_url": "https://neighborland.com/ideas/nola-st-claude-more-live-theater-and-ind",
    "created_at": "2012-03-18 22:12:00 -0600",
    "i_want_text": "I want more live theater and independent film screenings on St. Claude Avenue",
    "latitude": 29.9648338,
    "longitude": -90.0313877,
    "name": "more live theater and independent film screenings",
    "past_month_support_count": 0,
    "support_count": 17,
    "neighbor": {
      "id": "robertfordebrennan",
      "url": "https://neighborland.com/api/v1/neighbors/robertfordebrennan",
      "alternate_url": "https://neighborland.com/neighbors/robertfordebrennan",
      "name": "Robby Brennan",
      "username": "robertfordebrennan",
      "avatar_thumb_url": "https://d3hab8wm9tteb6.cloudfront.net/static/avatars/avatar_medium_2.png",
      "avatar_medium_url": "https://d3hab8wm9tteb6.cloudfront.net/static/avatars/avatar_medium_2.png"
    },
    "city": {
      "id": "nola",
      "url": "https://neighborland.com/api/v1/cities/nola",
      "alternate_url": "https://neighborland.com/cities/nola",
      "name": "New Orleans",
      "state": "LA"
    },
    "neighborhood": {
      "id": "nola-st-claude",
      "url": "https://neighborland.com/api/v1/neighborhoods/nola-st-claude",
      "alternate_url": "https://neighborland.com/neighborhoods/nola-st-claude",
      "name": "St. Claude"
    },
    "question": {
      "id": "142",
      "url": "https://neighborland.com/api/v1/questions/142",
      "alternate_url": "https://neighborland.com/stclaude/about",
      "latitude": 29.9648338,
      "longitude": -90.0313877,
      "name": "St. Claude Avenue",
      "address": "St. Claude Avenue and Poland Avenue",
      "question_text": "How can we make St. Claude Avenue a better place?"
    }
  }
]