Coworkies API Reference

# Recommended: X-API-Key header
curl https://api.coworkies.com/v2/jobs \
  -H "X-API-Key: your_api_key"

# Alternative: Bearer token
curl https://api.coworkies.com/v2/jobs \
  -H "Authorization: Bearer your_api_key"

const response = await fetch('https://api.coworkies.com/v2/jobs', {
  headers: { 'X-API-Key': 'your_api_key' }
});
const data = await response.json();

import requests

response = requests.get(
    'https://api.coworkies.com/v2/jobs',
    headers={'X-API-Key': 'your_api_key'}
)
data = response.json()

<?php
$ch = curl_init('https://api.coworkies.com/v2/jobs');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-API-Key: your_api_key',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

Make a GET request to the Coworkies API to list jobs.

API details:
- Base URL: https://api.coworkies.com/v2
- Endpoint: GET /v2/jobs
- Auth: Send header "X-API-Key: your_api_key"
- Response: JSON with { success: bool, status: int, data: { jobs: [...] } }

Write a function that fetches jobs from this API. Use the X-API-Key header for authentication. Parse the JSON response and return the jobs array. Handle errors by checking the "success" field.

{
  "success": true,
  "status": 200,
  "data": {
    "jobs": [...],
    "pagination": { ... }
  }
}

{
  "success": false,
  "status": 422,
  "error": {
    "code": "validation_error",
    "message": "Validation failed",
    "details": [
      "Job title is required",
      "City ID is required"
    ]
  }
}

const response = await fetch('https://api.coworkies.com/v2/jobs', {
  headers: { 'X-API-Key': 'your_api_key' }
});

const json = await response.json();

if (!json.success) {
  console.error(`${json.error.code}: ${json.error.message}`);
  if (json.error.details) {
    json.error.details.forEach(d => console.error(`  - ${d}`));
  }
}

<?php
$ch = curl_init('https://api.coworkies.com/v2/jobs');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: your_api_key'],
]);

$response = curl_exec($ch);
curl_close($ch);

$json = json_decode($response, true);

if (!$json['success']) {
    error_log(sprintf(
        '%s: %s',
        $json['error']['code'],
        $json['error']['message']
    ));
    if (!empty($json['error']['details'])) {
        foreach ($json['error']['details'] as $detail) {
            error_log("  - {$detail}");
        }
    }
}

import requests

response = requests.get(
    'https://api.coworkies.com/v2/jobs',
    headers={'X-API-Key': 'your_api_key'}
)

data = response.json()

if not data['success']:
    print(f"{data['error']['code']}: {data['error']['message']}")
    for detail in data.get('error', {}).get('details', []):
        print(f"  - {detail}")

Add error handling for Coworkies API responses.

The API returns JSON with this structure:
- Success: { "success": true, "status": 200, "data": { ... } }
- Error: { "success": false, "status": 4xx/5xx, "error": { "code": "string", "message": "string", "details": ["array of strings"] } }

Error codes: bad_request (400), unauthorized (401), forbidden (403), not_found (404), method_not_allowed (405), conflict (409), validation_error (422), rate_limit_exceeded (429), server_error (500).

Requirements:
1. After every API call, check if response.success is false
2. If error, extract error.code and error.message for logging
3. If error.details exists (array), iterate and display each validation message
4. For 429 (rate limit), implement exponential backoff retry
5. For 401, surface "invalid API key" to the user
6. Wrap in a reusable error handler/middleware

{
  "data": {
    "jobs": [...],
    "pagination": {
      "total": 142,
      "limit": 20,
      "offset": 0,
      "current_count": 20,
      "total_pages": 8,
      "current_page": 1,
      "has_next": true,
      "has_previous": false
    }
  }
}

curl "https://api.coworkies.com/v2/jobs?q=developer&remote=1&per_page=5" \
  -H "X-API-Key: your_api_key"

const params = new URLSearchParams({
  q: 'developer',
  remote: '1',
  per_page: '5'
});

const response = await fetch(
  `https://api.coworkies.com/v2/jobs?${params}`,
  { headers: { 'X-API-Key': 'your_api_key' } }
);

const { data } = await response.json();

import requests

response = requests.get(
    'https://api.coworkies.com/v2/jobs',
    headers={'X-API-Key': 'your_api_key'},
    params={'q': 'developer', 'remote': '1', 'per_page': '5'}
)

data = response.json()['data']

<?php
$params = http_build_query([
    'q' => 'developer',
    'remote' => '1',
    'per_page' => '5',
]);

$ch = curl_init("https://api.coworkies.com/v2/jobs?{$params}");

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-API-Key: your_api_key',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true)['data'];

Write a function to search jobs on the Coworkies API.

API spec:
- Endpoint: GET https://api.coworkies.com/v2/jobs
- Auth header: X-API-Key: your_api_key
- Query params: q (search term), job_type (fulltime|parttime|freelance|internship), remote (1 for remote only), city (city slug), page (int), per_page (int, max 50)
- Response shape: { success: bool, status: int, data: { jobs: Array<{ id_job, title, company, job_type, tags, is_remote, page_url, external_url, apply_url, company_logo, date_added, expiration_date, city_name, city_slug, space_name, sal_min, sal_max, currency, url }>, pagination: { total, current_page, has_next, has_previous } } }

Requirements:
1. Accept search query, job type filter, remote flag, and city as parameters
2. Send request with X-API-Key header
3. Parse response and return the jobs array
4. Handle errors: check response.success, throw/log if false with error.code and error.message
5. Support pagination: accept page parameter

{
  "success": true,
  "status": 200,
  "data": {
    "jobs": [
      {
        "id_job": 1234,
        "title": "Remote Software Developer",
        "company": "Tech Solutions Inc.",
        "job_type": "fulltime",
        "tags": "javascript,react,node",
        "is_remote": true,
        "page_url": "remote-software-developer-1234",
        "external_url": "https://example.com/apply?ref=coworkiesjobs",
        "apply_url": "https://example.com/careers/apply",
        "company_logo": "logo_1234.png",
        "date_added": "2026-05-15T10:30:00Z",
        "expiration_date": "2026-06-15T00:00:00Z",
        "city_name": "Berlin",
        "city_slug": "berlin",
        "space_name": null,
        "sal_min": "65000",
        "sal_max": "85000",
        "currency": "EUR",
        "url": "https://www.coworkies.com/jobs/remote-software-developer-1234/details"
      }
    ],
    "pagination": {
      "total": 42,
      "current_page": 1,
      "has_next": true
    }
  }
}

curl https://api.coworkies.com/v2/jobs \
  -X POST \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Community Manager",
    "company": "Coworking Studio",
    "description": "Lead member experience at our Berlin location.",
    "job_type": "fulltime",
    "city_name": "Berlin",
    "tags": "community,events,hospitality",
    "external_url": "https://example.com/careers/cm",
    "apply_url": "https://example.com/careers/cm/apply",
    "is_remote": 0,
    "currency": "EUR",
    "sal_min": 35000,
    "sal_max": 45000
  }'

{
  "success": true,
  "status": 201,
  "data": {
    "job_id": 567,
    "page_url": "community-manager-567",
    "hash_identifier": "a1b2c3d4e5f6...",
    "status": "active",
    "action": "created",
    "dedupe_hash": "f7a8b9...",
    "is_paid": true,
    "city": { "id": 42, "name": "Berlin" },
    "apply_url": null,
    "plan_price": 0,
    "expiration_days": 30,
    "message": "Job created and published successfully.",
    "view_url": "https://www.coworkies.com/jobs/community-manager-567/details",
    "payment_url": null,
    "edit_url": "https://www.coworkies.com/jobs/community-manager-567/edit?job_hash=a1b2c3...",
    "unpublish_url": "https://www.coworkies.com/jobs/community-manager-567/unpublish?job_hash=a1b2c3..."
  }
}

curl "https://api.coworkies.com/v2/cities?search=berlin" \
  -H "X-API-Key: your_api_key"

{
  "success": true,
  "status": 200,
  "data": [
    {
      "id_city": "42",
      "city_name": "Berlin",
      "city_slug": "berlin",
      "latitude": "52.5200",
      "longitude": "13.4050"
    }
  ]
}

curl "https://api.coworkies.com/v2/spaces?q=berlin" \
  -H "X-API-Key: your_api_key"

{
  "success": true,
  "data": [
    {
      "space_name": "Example Coworking",
      "space_url": "example-coworking",
      "space_address": "Sample Street 12",
      "latitude": "52.5200",
      "longitude": "13.4050",
      "city_name": "Berlin"
    }
  ]
}

curl "https://api.coworkies.com/v2/blog?category=careers&limit=5" \
  -H "X-API-Key: your_api_key"

{
  "success": true,
  "data": {
    "title": "Launching The Coworking Salary Survey 2026",
    "slug_url": "launching-the-coworking-salary-survey-6",
    "categories": ["careers"],
    "tags": ["coworking-career", "coworking-jobs"],
    "date": "2026-03-07T13:29:51Z",
    "authors": [{
      "name": "Pauline Roussel",
      "username": "pauline"
    }],
    "reading_time": 5
  }
}

{
  "success": true,
  "data": {
    "status": "ok",
    "php_version": "8.4.0",
    "memory_usage": 2097152,
    "redis": {
      "status": "connected",
      "version": "7.0.4"
    }
  }
}

curl "https://api.coworkies.com/v2/jobs?per_page=5" \
  -H "X-API-Key: your_api_key"

curl https://api.coworkies.com/v2/jobs \
  -X POST \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Frontend Developer",
    "company": "Remote Co",
    "description": "Build beautiful interfaces.",
    "job_type": "fulltime",
    "city_name": "Lisbon",
    "tags": "react,typescript,remote",
    "is_remote": 1
  }'

async function postJob(jobData) {
  const response = await fetch(
    'https://api.coworkies.com/v2/jobs',
    {
      method: 'POST',
      headers: {
        'X-API-Key': 'your_api_key',
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(jobData),
    }
  );

  const result = await response.json();

  if (!result.success) {
    throw new Error(result.error.message);
  }

  return result.data;
}

<?php
function postJob(array $jobData): array
{
    $ch = curl_init('https://api.coworkies.com/v2/jobs');

    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => json_encode($jobData),
        CURLOPT_HTTPHEADER => [
            'X-API-Key: your_api_key',
            'Content-Type: application/json',
        ],
    ]);

    $response = curl_exec($ch);
    curl_close($ch);

    $result = json_decode($response, true);

    if (!$result['success']) {
        throw new \RuntimeException($result['error']['message']);
    }

    return $result['data'];
}

import requests

def post_job(job_data: dict) -> dict:
    response = requests.post(
        'https://api.coworkies.com/v2/jobs',
        headers={
            'X-API-Key': 'your_api_key',
            'Content-Type': 'application/json',
        },
        json=job_data
    )

    result = response.json()

    if not result['success']:
        raise Exception(result['error']['message'])

    return result['data']

Build a complete Coworkies API client that can create job postings.

API spec for POST /v2/jobs:
- URL: https://api.coworkies.com/v2/jobs
- Method: POST
- Headers: X-API-Key: your_api_key, Content-Type: application/json
- Required body fields: title (string), company (string), description (string), job_type (fulltime|parttime|freelance|internship), tags (comma-separated string), and either id_city (int) or city_name (string)
- Optional fields: external_url, apply_url, is_remote (0|1), inv_email, currency (EUR|USD|GBP), sal_min (int), sal_max (int), id_space (int), id_plan (int, default 5)

Key behaviors:
- Tags are auto-normalized (trimmed, lowercased, deduplicated)
- city_name is resolved to id_city server-side (exact match then prefix)
- external_url gets "?ref=coworkiesjobs" appended automatically
- Deduplication: if same title+company+city+external_url exists, job is UPDATED not duplicated
- Status is always "draft" (server-enforced)
- sal_min cannot exceed sal_max

Response (201): { success: true, data: { job_id, page_url, hash_identifier, status: "draft", action: "created"|"updated", city: {id, name}, edit_url, unpublish_url } }
Error (422): { success: false, error: { code: "validation_error", message, details: [...] } }

Requirements:
1. Create a postJob() function accepting job data object
2. Validate required fields client-side before sending
3. Send POST with JSON body and X-API-Key header
4. Parse response, check success field
5. On error, throw with error details array
6. Return the created job data with edit_url