Classifieds For Free API Help Page

Introduction

Classifieds For Free API is a REST API that uses JSON/XML for data exchange format. To use the API, you need to register as a Classifieds For Free user and obtain an access token. The access token must be sent in a custom header for each HTTP call. The API supports GET,POST,PUT, and DELETE and each call is autheitcated against the custom header present in the call. If no custom header is present or an invalid authorization token in the custom header will return a HTTP 409 response.

API	Description
GET docs/Ads	Get authenticated user ads
GET docs/Ads?user={user}&page={page}	Get all ads posted by a user. user is the user id and page is the page number Each page returns 100 ads. Example: /ads?user=asdf&page=1, where asdf is the user id The client making the request must provide asdf's authorzation token
GET docs/Ads?id={id}	Returns an ad for any user, posted in any country/state/city Example: /ads/12345 (returns an ad whose id is 12345)
GET docs/Ads?hour={hour}&distinct={distinct}	Returns a collection of ads posted in the past number of hours, filtered by a distinct filter Example: /ads?hour=3&distinct=user Filter parameter: user: (distinct user), pic: (distinct user with pic), video: (distinct user with video), true: (distinct ads), false: (all ads) Limited to 100 ads only.
GET docs/Ads?hour={hour}&page={page}	Get ads in the past hour by page
POST docs/Ads	No Documentation Found.
DELETE docs/Ads?id={id}	Delete an ad. The authentication token must match the user id of the ad.
PUT docs/Ads	No Documentation Found.
GET docs/Ads?number={number}	Returns an array of video ads
GET docs/Ads?category={category}&skip={skip}&take={take}	All disctinct ads in a category
GET docs/Ads?place={place}&skip={skip}&take={take}	All distinct ads from a place
GET docs/Ads?place={place}&category={category}&skip={skip}&take={take}	All distinct ads from a place in a category
GET Ads	Get authenticated user ads
GET Ads?user={user}&page={page}	Get all ads posted by a user. user is the user id and page is the page number Each page returns 100 ads. Example: /ads?user=asdf&page=1, where asdf is the user id The client making the request must provide asdf's authorzation token
GET Ads/{id}	Returns an ad for any user, posted in any country/state/city Example: /ads/12345 (returns an ad whose id is 12345)
GET Ads?hour={hour}&distinct={distinct}	Returns a collection of ads posted in the past number of hours, filtered by a distinct filter Example: /ads?hour=3&distinct=user Filter parameter: user: (distinct user), pic: (distinct user with pic), video: (distinct user with video), true: (distinct ads), false: (all ads) Limited to 100 ads only.
GET Ads?hour={hour}&page={page}	Get ads in the past hour by page
POST Ads	No Documentation Found.
DELETE Ads/{id}	Delete an ad. The authentication token must match the user id of the ad.
PUT Ads	No Documentation Found.
GET Ads?number={number}	Returns an array of video ads
GET Ads?category={category}&skip={skip}&take={take}	All disctinct ads in a category
GET Ads?place={place}&skip={skip}&take={take}	All distinct ads from a place
GET Ads?place={place}&category={category}&skip={skip}&take={take}	All distinct ads from a place in a category

Countries

API	Description
GET docs/Countries	Get All supported countries Example: /countries
GET Countries	Get All supported countries Example: /countries

Gallery

API	Description
GET docs/Gallery	Get all images of an authenticated user. Example: /gallery
DELETE docs/Gallery?id={id}	Deletes a user image. Example: /gallery/image_name The image must belong to the user authentication token
POST docs/Gallery	Post a collection of images to authenticated user gallery
GET Gallery	Get all images of an authenticated user. Example: /gallery
DELETE Gallery/{id}	Deletes a user image. Example: /gallery/image_name The image must belong to the user authentication token
POST Gallery	Post a collection of images to authenticated user gallery

Users

API	Description
GET docs/Users	Get authenticated user information
GET docs/Users?user={user}&password={password}&appid={appid}	Get an api token for a locally registered user at ClassifiedsForFree Example: /api/users?user=asdf&password=pwd&apid=xxxx, where asdf is the user id and password is the asdf's password and appid is the application id maeking the request on behalf of user
GET Users	Get authenticated user information
GET Users?user={user}&password={password}&appid={appid}	Get an api token for a locally registered user at ClassifiedsForFree Example: /api/users?user=asdf&password=pwd&apid=xxxx, where asdf is the user id and password is the asdf's password and appid is the application id maeking the request on behalf of user

API	Description
GET docs/Categories	Get all supported pretty categories Example: /categories
GET docs/Categories?category={category}	Get a url friendly category using a category name
GET Categories	Get all supported pretty categories Example: /categories
GET Categories?category={category}	Get a url friendly category using a category name

States

API	Description
GET docs/States	Get all supported US States Example: /states
GET States	Get all supported US States Example: /states

Swagger

API	Description
GET docs/Swagger	No Documentation Found.
GET Swagger	No Documentation Found.

Jobs

API	Description
GET docs/Jobs?job={job}	No Documentation Found.
GET Jobs?job={job}	No Documentation Found.

Cities

API	Description
GET docs/Cities?id={id}	Get all supported cities. Example: cities/Illinois
GET Cities/{id}	Get all supported cities. Example: cities/Illinois