Hello there, Glendora!

imaneed: Need it, get it: Mobile, Local, Fast & Friendly

Imaneed Simple API

We want you to build an application that pushes requests to Imaneed. We plan to share revenue with developers who deliver valuable (genuine) requests to us via our API.


Imaneed on Google Groups


Needs

http://imaneed.com/simple_api/messages


Get a list of up to 30 of the latest needs

Request Type: GET

Authentication required: NO


Optional parameters:

  • address: string (allows you to get distance_to)
  • within: integer (you can specify a range in miles)
  • query: string (a search string)

Parameters returned:

  • message => {
  • id : integer
  • message_content : string (up to 140 characters)
  • city : string
  • state : string
  • zip : string
  • country : string
  • province : string
  • distance_to : string (miles) or null if not available
  • available: boolean
    • }


curl -X GET -H "Content-Type: application/json" http://imaneed.com/simple_api/messages.js
curl -X GET -H "Content-Type: application/json" http://imaneed.com/simple_api/messages.js?query="job"
[{"message":{"province":"Broward","state":"FL","message_content":"need a PT job, hostess, barista, any!","zip":"33305","country":"USA","city":"Fort Lauderdale","available":true,"distance_to":null,"id":542}}]%
curl --user user_phone_number:user_password -X GET -H "Content-Type: application/json" http://imaneed.com/simple_api/messages.js

RESPONSE: [{"message":{"city":"Oakland Park","country":"USA","distance_to":"null","zip":"33334","state":"FL","province":"Broward","message_content":"I love Imaneed.","id":103}},{"message":{"city":"Oakland Park","country":"USA","distance_to":"No origin provided","zip":"33334","state":"FL","province":"Broward","message_content":"I need API support.","id":102}}]

Get information about a particular need

Request Type: GET /id

Authentication required: NO


Optional parameters:

  • address: string (allows you to get distance_to)

Parameters returned:

  • message => {
  • id : integer
  • message_content : string (up to 140 characters)
  • city : string
  • state : string
  • zip : string
  • country : string
  • province : string
  • distance_to : string (miles) or null if not available
  • available: boolean
    • }

curl -X GET -H "Content-Type: application/json" http://imaneed.com/simple_api/messages/98.js
curl --user user_phone_number:user_password -X GET -H "Content-Type: application/json" http://imaneed.com/simple_api/messages/98.js

RESPONSE: {"message":{"city":"Fort Lauderdale","country":"USA","distance_to":"null","zip":"33316","state":"FL","province":"Broward","message_content":"I want help with the Imaneed API.","id":98}}

Create a new need

Request Type: POST

Authentication required: YES (contact us for your login info)


Parameters required:

  • message_content : string (up to 140 characters)
  • address : string (US address, zip or longitude & latitude)
  • mobile_number : string (only US phone numbers)

Optional parameters:

  • user_login : string
  • user_password : string


curl --user api_username:api_password -X POST -d '{"message_content":"I want help with the Imaneed API.","mobile_number":"5555555555","address":"Your address goes here"}' -H "Content-Type: application/json" http://imaneed.com/simple_api/messages.js
curl --user api_username:api_password -X POST -d '{"message_content":"I want help with the Imaneed API.","mobile_number":"5555555555","address":"Your address goes here","user_login":"the user's optional username","user_password":"the user's optional password"}' -H "Content-Type: application/json" http://imaneed.com/simple_api/messages.js

RESPONSE: nothing

  • Please note that the mobile_number and address data used here must be changed to a real, US mobile phone number and real address respectively for this to work.
  • If you send a correct username and password, we will post the message automatically. If the username and password is not provided, we will send a text message to the phone number for validation. The mobile phone must reply "Y" to post the message.
  • Your API username and password are currently optional. You should get an API username and password so that you can benefit from our affiliate scheme.


    • Calls

    http://imaneed.com/simple_api/calls


    Call the sender of a message

    Request Type: POST


    Parameters required:

    • user_login : string (user must have an account to use this method)
    • user_password : string (user must have an account to use this method)
    • message_id : integer (message you want to call about)
    • phone_number : string (phone number you wish to call from)

    curl --user api_username:api_password -X POST -d '{"message_id":"1","phone_number":"5555555555","user_login":"the user's username","user_password":"the user's password"}' -H "Content-Type: application/json" http://imaneed.com/simple_api/calls.js

    RESPONSE: 200

  • Please note that the mobile_number and address data used here must be changed to a real, US mobile phone number and real address respectively for this to work.
  • If you send a correct username and password, we will call your mobile phone and then call the party that made the request. If the username and password is not provided, we will not make the call.
  • Your API username and password are currently optional. You should get an API username and password so that you can benefit from our affiliate scheme.