# Socio-demo API

**Provider:** Socio-demo
**Category:** maps
**Base URL:** `https://developer.o2.cz/sociodemo/sandbox/api`
**Auth:** oauth2 — `Authorization: Bearer YOUR_ACCESS_TOKEN`
**Rate Limit:** 4,000 API calls/min (authenticated)
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://developer.o2.cz/sociodemo/sandbox/api

## Description

Socio-demo API can be used to obtain time-aggregated data representing groups of people on the given location in the Czech Republic. Having a location, the API can return count of people belonging to age group or gender aggregated by hours. The socio-demo data is based on presence of mobile stations

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://developer.o2.cz/sociodemo/sandbox/api/age/{location}` | Presence in a location aggregated by age |
| GET | `https://developer.o2.cz/sociodemo/sandbox/api/gender/{location}` | Presence in a location aggregated by gender |
| GET | `https://developer.o2.cz/sociodemo/sandbox/api/info` | Information about versions of application and data. |

## Authentication

OAuth 2.0 or JWT (Server Authentication) for machine-to-machine

```
Authorization: Bearer YOUR_ACCESS_TOKEN
```

## Sample Request

```bash
curl -X GET 'https://developer.o2.cz/sociodemo/sandbox/api/age/{location}' \
  -H '# No auth required'
```

## Sample Response

```json
{}
```

## Pricing Details

Individual: free (10GB). Business Starter: $15/user/mo (unlimited storage). Business: $20/user/mo. Enterprise: custom.

---

*Source: [API Map](https://apimap.dev/apis/socio-demo/) — CC BY 4.0*