Main Page
From Sharing API
Contents |
The Sharing API
Listing properties
These are the stuff that an API request would return from each service.
- item local ID unique key combo
- service_name unique key combo
- owner local ID
- title (mandatory)
- url (mandatory)
- description (optional)
- image (optional)
- type (mandatory)
- date created (auto)
- date expiry (optional)
- condition
- offer
- request
- share_method (mandatory, listing can have several of these)
- buy
- sell
- rent
- share (i.e. borrow or lend)
- swap
- gift (i.e. free)
- category
- item
- space
- skill_or_service
- transportation
- latitude (optional)
- longitude (optional)
- price (optional)
- local currency local ID
- rate (optional)
- hourly
- weekly
- montly
- one time payment
- keywords/tags (optional)
- language? (there should be a way to search from content on other languages!)
An example JSON that a search query would return:
[
{
"owner":"jerry",
"title":"Power drill",
"service_name":"Kassi",
"url": "http://randomcommunity.kassi.eu/listings/167"
"description":"A regular power drill I seldom use",
"type":"offer",
"share_method":"lend"
"category":"item"
"latitude":40.71455
"longitude":-74.007124
},
{
"title":"Bike repair",
"service_name":"Sharedearth.net",
"url": "http://www.sharedearth.net/listings/1022"
"description":"I am good at repairing bikes and good lend neighbor a hand",
"type":"offer",
"share_method":"offer_for_free"
"category":"skill_or_service"
},
]
Methods
Search
Parameters
- api_key (mandatory)
- query
- order_by (return results either newest first or nearest first, default newest first)
- If ordered by nearest first, skip all listings without a location
- current_location (of the searcher, to make searching by location possible, both lat and long)
- radius
- limit (default = 50, ordered by the nearest first)
- different listing properties
Send message to user
- Example URL:
