Steps to getting started with Coworker.com API
- 1. Read and review our Terms of Service
- 2. Respond via email to [email protected] with the following: a. that you agree to the terms b. where the data as provide via our API will be used, and what the intended purpose will be for c. provide us a static IP address of wherever you are pulling the data from.
Our API is available on a commercial basis only. Price start from $150 /mo for content sites, and $2,500/ mo for enterprise level solutions
Upon approval, we will open up our API to you for full use and integration.
APIs
Nearby Spaces API
We have our Nearby Spaces API call, which returns a listing of all spaces within a specified radius (KM) of a given set of lat/long geo-coordinates. See below for request details. The listing can be delivered in json, xml, html, or csv formats.
The data is updated in real-time whenever the call is made with the latest listings returned.
Example Get REQUEST:
This can run in a browser, but you will likely implement the call using CURL.
This example fetches all the spaces within a 16KM radius from the Geek Offices space in Cambridge, Massachusetts..
It can return in different output formats (specify one of: html, json, csv, or xml) based on the URL part following /format/
Param | Description | Required |
---|---|---|
lat | latitude value Ex, 42.3736016 | yes |
lon | Longitude value Ex, -71.09353620000002 | yes |
rad | Radius in KM Ex, 16 | yes |
** If you want to see the results in a friendlier readable format you can specify xml as the format:
Response:
Param | Description | Required |
---|---|---|
cs_id | unique coworker.com Space Id | 540 |
name | Workspace name | NGIN Workplace |
address | Street address | 210 Broadway |
postal_area | Postcode | MA 02139 |
city | City | Cambridge |
state | State | Massachusetts |
country | Country | United States |
latitude | Lat coord | 42.3659672 |
longitude | Long Coord | -71.0933635 |
image | Main image reference | *end point example provided upon API partner approval |
cw_url | Coworker.com space page | https://www.coworker.com/united-states/massachusetts/cambridge/ngin-workplace |
currency | Local Currency | USD |
day_price | Daily price in local currency | 30 |
week_price | Weekly price in local currency | 150 |
month_price | Monthly price in local currency | 375 |
description | Space description | The key to success starts with a superb work environment -- that's why NGIN Workplace is the chosen home for startups, freelancers, and em... |
star_rating | Coworker.com star rating, blank if not available | 5 |
num_reviews | Coworker.com number of reviews for this space, blank if not available | 36 |
max_capacity | Numerical, Blank if not available | 70 |
private_rooms | Numerical, Blank if not available | 17 |
meeting_rooms | Numerical, Blank if not available | 8 |
additional_images | Up to 3 additional image URLS separated by ";" (Semi-colon) | *end point example provided upon API partner approval |
** If you want to see the results in a friendlier readable format you can specify xml as the format:
Space Reviews API
We have our Space Reviews API call, which returns a listing of all Coworker.com user reviews on a given Coworking space, which is targetted by a set of lat/long geo-coordinates and Space Name.
It is designed to allow you to pull in reviews on spaces that YOU have on your site and should be called when your space page loads to get the latest reviews. The Space name you provide will be searched for within a 1KM radius of the
geo-coordinates you provide using natural language search, meaning the exact words and order of words doesn't have to match with our space names exactly.
See below for request details. The listing can be delivered in json, xml, html, or csv formats.
The data is updated in real-time whenever the call is made with the latest listings returned.
Example Get REQUEST:
This can run in a browser, but you will likely implement the call using CURL.
This example returns the reviews for the space "Impact Hub Birmingham" found on Coworker.com. On YOUR site, you have the same space called "Impact Hub" with lat=52.4769390, long=-1.8878069
It can return in different output formats (specify one of: html, json, csv, or xml) based on the URL part following /format/
Param | Description | Required |
---|---|---|
lat | latitude value stored on YOUR siteEx, 52.4769390 | yes |
lon | Longitude value stored on YOUR siteEx, -1.8878069 | yes |
sp | Space Name as stored on YOUR site Ex, Impact Hub | yes |
** If you want to see the results in a friendlier readable format you can specify xml as the format:
Response:
Param | Description | Example | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
cs_id | unique coworker.com Space Id | 777 | ||||||||||||||||||||||||
name | Space name on Coworker.com | Impact Hub Birmingham | ||||||||||||||||||||||||
city | City | Birmingham | ||||||||||||||||||||||||
latitude on Coworker.com | Lat coord | 52.4769394 | ||||||||||||||||||||||||
longitude on Coworker.com | Long Coord | -1.8878071 | ||||||||||||||||||||||||
cw_url | Coworker.com space page | https://www.coworker.com/united-kingdom/birmingham/impact-hub-birmingham" | ||||||||||||||||||||||||
star_rating | Coworker.com star rating, blank if not available | 5 | ||||||||||||||||||||||||
num_reviews | Coworker.com number of reviews for this space, blank if not available | 16 | ||||||||||||||||||||||||
reviews | List of 0 or more review details | ** Each review detail contains the following:
|
** If you want to see the results in a friendlier readable format you can specify xml as the format:
Commercial: ALL Spaces API
Our All Spaces API call returns a listing of all spaces listed after a given threshold (last Space Id queried). This allows you to pull in only the spaces that have been added since your last All Spaces request and avoid the overhead of re-processing data that has already been catalogued on your end. See below for request details.
The listing can be delivered in json, xml, html, or csv formats. The data is updated in real-time whenever the call is made with the latest listings returned.
Example Get REQUEST:
This can run in a browser, but you will likely implement the call using CURL.
This example returns all spaces with cs_id > 2050 in json format
It can return in different output formats (specify one of: html, json, csv, or xml) based on the URL part following /format/
Param | Description | Required |
---|---|---|
lastId | The highest valued cs_id returned from your last app spaces API call. It is assumed that you will store the data in your own database and query for the highest available cs_id in your database to set as this param on subsequent calls.Ex – 2050 | NO |
** If you want to see the results in a friendlier readable format you can specify xml as the format:
Response:
Param | Description | Required |
---|---|---|
cs_id | unique coworker.com Space Id | 540 |
name | Workspace name | NGIN Workplace |
address | Street address | 210 Broadway |
postal_area | Postcode | MA 02139 |
city | City | Cambridge |
state | State | Massachusetts |
country | Country | United States |
latitude | Lat coord | 42.3659672 |
longitude | Long Coord | -71.0933635 |
image | Main image reference | *end point example provided upon API partner approval |
cw_url | Coworker.com space page | https://www.coworker.com/united-states/massachusetts/cambridge/ngin-workplace |
currency | Local Currency | USD |
day_price | Daily price in local currency | 30 |
week_price | Weekly price in local currency | 150 |
month_price | Monthly price in local currency | 375 |
description | Space descritpion | The key to success starts with a superb work environment -- that's why NGIN Workplace is the chosen home for startups, freelancers, and em... |
star_rating | Coworker.com star rating, blank if not available | 5 |
num_reviews | Coworker.com number of reviews for this space,blank if not available | 36 |
max_capacity | Numerical, Blank if not available | 70 |
private_rooms | Numerical, Blank if not available | 17 |
meeting_rooms | Numerical, Blank if not available | 8 |
additional_images | Up to 3 additional image URLS separated by ";" (Semi-colon) | *end point example provided upon API partner approval |
** If you want to see the results in a friendlier readable format you can specify xml as the format:
Additional Questions
What information is needed from me?
Please review our "Steps to getting started" above.
What are your terms of service for using the API?
Please review our "Terms & Conditions" below.
Is this a REST API?
Yes, it is a REST API using HTTP GET method
How often is the data updated?
The data is kept current on our end, and is up to the receiver to determine how often the data is retrieved. We recommend pulling the data once daily or once weekly to maintain up-to-date content. If you are only interested in retrieving new spaces that have recently been added, you may send the last space ID when you make the call and you will retrieve only new spaces.
How much do you charge to use your API?
Our API is available on a commercial basis only. Price start from $150 /mo for content sites, and $2,500/ mo for enterprise level solutions
Are there any commissions or rev share you offer?
No, we do not monetize the space listings at this point so there is no rev share. In the future we may introduce paid services including instant bookings and would be open to creating a rev share agreement.
What data does the spaces API(s) provide?
- Space name
- Description (capped at 135 characters)
- Photos (3 images, including main)
- Latitude / Longitude
- Cost (daily, weekly, or monthly)
- Reviews (aggregate + star rating)
- # of meeting rooms
- # of private offices
- Max capacity
What format is the data structured in?
The data can be delivered in XML, CSV, or JSON formats. The data can be manipulated and customized to fit your display and template. Please see below a set of sample data.
Terms & Conditions
**potential means of representing the data using our logo for space location points on the map
- Photos > "View All"
- Description > "See More"
- Amenities > "View All"
- Private offices > "See Details"
- Pricing > "See All Pricing"
- Reviews > "See All Reviews"
Please view an example here
Contact and Questions:
Please email [email protected]
Grab Your Spot on The Coworking List
100% good stuff : exclusive coworking special offers, the coolest new spaces and fun opportunities around the world...