Coworker API Overview

The Coworker API (REST API using HTTP GET method) provides data from over 5500 coworking spaces around the world. It is ideal for applications and platforms that are interested in showing meaningful content of workspaces near locations. The data can add value to your platform by making locations more desirable through proximity to great coworking spaces. Our data set is the largest in the world and contains official coworking spaces only. It does not include cafes or other public workspace. The intended use includes having coworker.com space pages as end points (deep links).

Steps to getting started with Coworker.com API

  • 1. Read and review our Terms of Service
  • 2. Respond via email to api@coworker.com 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.

If we approve your entity for API use, we will send setup your account access and send across a sample of the raw data for you to pull in and test at which point we request a review of how the data has been used for pubic view.

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.

picpicpicpic

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..

*end point example provided upon API partner approval

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.

picpicpicpic

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

*end point example provided upon API partner approval

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:
Param Description Example
fname Reviewers first name Chris
title Review title Vibrant and diverse bunch of "doers" working on amazing things
comment The full review I have been using the co-working space and its break out rooms for a year now, just by being here I have gown a broad network of friends, found more work for my business and impressed every client that has been to visit. The space is hosted by amazing members that bring so much passion to the Hub it's hard not to feel like you can really change the world from the second you walk in the door. I'd defiantly recomend this place for anyone who wants/needs more than just a co-working space, this is a place for people with a mission.
o_rate Reviewers Overall Rating 5
review_id Coworker.com unique review ID 100
nprofile Profile pic URL of the reviewer //graph.facebook.com/10154116870902018/picture?width=100&height=100
user_id Coworker.com unique reviewer user ID 58

** 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

*end point example provided upon API partner approval

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

Q1.
What information is needed from me?

Please review our "Steps to getting started" above.

Q2.
What are your terms of service for using the API?

Please review our "Terms & Conditions" below.

Q3.
Is this a REST API?

Yes, it is a REST API using HTTP GET method

Q4.
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.

Q5.
How much do you charge to use your API?

There are no fees to use our "Spaces Nearby" API and "Reviews" API, however please see our T&C's below about using the data for commercial purposes or syndicating the data to 3rd parties. Our commercial API starts from $2500 / month.

Q6.
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.

Q7.
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
Q8.
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.

pic
pic

Terms & Conditions

The data set in general must have end points (deep links) to the specific content residing on coworker.com platform.
The data for any mapping applications must be presented remarked with coworker.com, or our logo/mark to represent the originator of the data.
pic

**potential means of representing the data using our logo for space location points on the map

If the receiver of the data has full detail pages of the spaces, these must be at least 3 button clicks that reside in end points to the originating space page on coworker.com. Options include:
  • 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

Put another way for the terms above, the data can not be masked or remarked in anyway that would make the user believe that the data originated outside of coworker.com
The relationship with the spaces must always reside with coworker.com. Receivers of the data must not permitted to allow spaces to "claim", "verify", or in anyway add onto the existing data, manage or take ownership of it.
If our data is used in any commercial form without consent, we have the right to take legal action for damages.
Coworker has the sole discretion to discontinue our API service to you within 24 hours of written notice via email.
If the use of the API is terminated by either party for any reason, the previous receiver must remove all remnants of the data which originated from coworker.com

Contact and Questions:

Please email api@coworker.com

Grab Your Spot on The Coworking List

100% good stuff : exclusive coworking special offers, the coolest new spaces and fun opportunities around the world...