# SportsTechJobs - Full API Documentation

> The leading job board for sports technology, health tech, and fitness industry positions.

SportsTechJobs aggregates 66,245+ jobs from 510+ companies in the sports technology industry. Jobs are automatically scraped from company career pages, enriched with AI-extracted skills, and include salary estimations.

## Base URL

https://sportstechjobs.com/api/v1

All endpoints return JSON. No authentication required for read access. Rate limited to 120 requests per minute.

---

## GET /api/v1/jobs

Search and list job postings.

### Query Parameters

| Parameter | Type | Description |
|---|---|---|
| q | string | Full-text search across position, company, and description |
| location | string | Filter by location (e.g. "New York", "London", "Remote") |
| company | string | Filter by company name |
| skills | string | Comma-separated skills (e.g. "python,react,aws") |
| remote | string | Set to any value to filter remote jobs only |
| label | string | Filter by job label/category |
| experience_level | string | Filter by experience level |
| employment_type | string | Filter by employment type (full-time, part-time, contract) |
| page | integer | Page number (default: 1) |
| limit | integer | Results per page (default: 20, max: 100) |

### Response

```json
{
  "data": [
    {
      "id": "...",
      "slug": "senior-data-engineer-at-nfl",
      "position": "Senior Data Engineer",
      "company": "NFL",
      "companySlug": "nfl",
      "location": "New York, NY",
      "description": "Full job description...",
      "skills": ["python", "sql", "aws", "spark"],
      "labels": ["Data Engineering"],
      "benefits": ["Health Insurance", "401k"],
      "experienceLevel": "Senior",
      "employmentType": "Full-time",
      "industry": "Sports",
      "salary": "$150,000 - $180,000",
      "salaryEstimation": {
        "min": 150000,
        "max": 180000,
        "currency": "USD",
        "confidence": 0.85
      },
      "link": "https://careers.nfl.com/...",
      "url": "https://sportstechjobs.com/senior-data-engineer-at-nfl",
      "postedAt": "2026-05-10T12:00:00.000Z",
      "updatedAt": "2026-05-10T12:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1250,
    "pages": 63
  }
}
```

### Examples

- All jobs: `GET /api/v1/jobs`
- Search for "data scientist": `GET /api/v1/jobs?q=data+scientist`
- Remote Python jobs: `GET /api/v1/jobs?remote=1&skills=python`
- Jobs in London: `GET /api/v1/jobs?location=London`
- Page 2 with 50 results: `GET /api/v1/jobs?page=2&limit=50`

---

## GET /api/v1/jobs/{slug}

Get a single job posting by its URL slug.

### Response

```json
{
  "data": {
    "id": "...",
    "slug": "senior-data-engineer-at-nfl",
    "position": "Senior Data Engineer",
    "company": "NFL",
    ...
  }
}
```

---

## GET /api/v1/companies

List all companies that have active job postings, with job counts and locations.

### Response

```json
{
  "data": [
    {
      "name": "NFL",
      "slug": "nfl",
      "jobCount": 15,
      "latestJob": "2026-05-10T12:00:00.000Z",
      "locations": ["New York, NY", "Los Angeles, CA"],
      "url": "https://sportstechjobs.com/jobs-at-nfl"
    }
  ],
  "total": 200
}
```

---

## GET /api/v1/companies/{slug}

Get a company's details and all their active job postings.

### Response

```json
{
  "data": {
    "name": "NFL",
    "slug": "nfl",
    "url": "https://sportstechjobs.com/jobs-at-nfl",
    "jobCount": 15,
    "jobs": [...]
  }
}
```

---

## GET /api/v1/skills

List all skills extracted from job postings, ranked by frequency.

### Response

```json
{
  "data": [
    { "skill": "python", "jobCount": 320 },
    { "skill": "javascript", "jobCount": 280 },
    { "skill": "sql", "jobCount": 250 }
  ],
  "total": 200
}
```

---

## GET /api/v1/locations

List all job locations, ranked by number of postings.

### Response

```json
{
  "data": [
    { "location": "New York, NY", "jobCount": 120 },
    { "location": "Remote", "jobCount": 95 },
    { "location": "London, UK", "jobCount": 80 }
  ],
  "total": 200
}
```

---

## GET /api/v1/stats

Get site-wide statistics.

### Response

```json
{
  "data": {
    "totalJobs": 1250,
    "totalCompanies": 200,
    "jobsThisWeek": 85,
    "lastUpdated": "2026-05-11T10:00:00.000Z"
  }
}
```

---

## Website Pages

These pages are available for browsing:

- Homepage: https://sportstechjobs.com
- All jobs: https://sportstechjobs.com (with search/filter)
- Job detail: https://sportstechjobs.com/{job-slug}
- Company jobs: https://sportstechjobs.com/jobs-at-{company-slug}
- Companies directory: https://sportstechjobs.com/companies-directory
- Skills overview: https://sportstechjobs.com/skills
- Sport-specific pages:
  - https://sportstechjobs.com/jobs-in-football
  - https://sportstechjobs.com/jobs-in-soccer
  - https://sportstechjobs.com/jobs-in-basketball
  - https://sportstechjobs.com/jobs-in-baseball
  - https://sportstechjobs.com/jobs-in-golf
  - https://sportstechjobs.com/jobs-in-running
- Jobs market trends: https://sportstechjobs.com/jobs-market