Socio-demo API

o2 · Company

Company No Auth Free & Open telecom

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 in O2 mobile network.

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET Information about versions of application and data.

Information about versions of application and data.

https://api.apis.guru/v2/specs/o2.cz/sociodemo/1.2.0/info

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/o2.cz/sociodemo/1.2.0/info"

import requests
response = requests.get(
    "https://api.apis.guru/v2/specs/o2.cz/sociodemo/1.2.0/info",
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/o2.cz/sociodemo/1.2.0/info';

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.apis.guru/v2/specs/o2.cz/sociodemo/1.2.0/info"
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/o2.cz/sociodemo/1.2.0/info")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/o2.cz/sociodemo/1.2.0/info";
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Presence in a location aggregated by age

Get count of people in a given location and an hour, aggregated by age.

https://api.apis.guru/v2/specs/o2.cz/sociodemo/1.2.0/age/{location}?hour=example&ageGroup=example&occurenceType=example

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/o2.cz/sociodemo/1.2.0/age/{location}?hour=example&ageGroup=example&occurenceType=example"

import requests
params = {
    "hour": "example",
    "ageGroup": "example",
    "occurenceType": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/o2.cz/sociodemo/1.2.0/age/{location}",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/o2.cz/sociodemo/1.2.0/age/{location}');
url.searchParams.set('hour', 'example');
url.searchParams.set('ageGroup', 'example');
url.searchParams.set('occurenceType', 'example');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/o2.cz/sociodemo/1.2.0/age/{location}")
	q := baseURL.Query()
	q.Set("hour", "example")
	q.Set("ageGroup", "example")
	q.Set("occurenceType", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/o2.cz/sociodemo/1.2.0/age/{location}")
uri.query = URI.encode_www_form({
  "hour" => "example",
  "ageGroup" => "example",
  "occurenceType" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/o2.cz/sociodemo/1.2.0/age/{location}?" . http_build_query([
    "hour" => "example",
    "ageGroup" => "example",
    "occurenceType" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Presence in a location aggregated by gender

Get count of people in a given location and an hour, aggregated by gender.

https://api.apis.guru/v2/specs/o2.cz/sociodemo/1.2.0/gender/{location}?g=example&hour=example&occurenceType=example

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/o2.cz/sociodemo/1.2.0/gender/{location}?g=example&hour=example&occurenceType=example"

import requests
params = {
    "g": "example",
    "hour": "example",
    "occurenceType": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/o2.cz/sociodemo/1.2.0/gender/{location}",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/o2.cz/sociodemo/1.2.0/gender/{location}');
url.searchParams.set('g', 'example');
url.searchParams.set('hour', 'example');
url.searchParams.set('occurenceType', 'example');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/o2.cz/sociodemo/1.2.0/gender/{location}")
	q := baseURL.Query()
	q.Set("g", "example")
	q.Set("hour", "example")
	q.Set("occurenceType", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/o2.cz/sociodemo/1.2.0/gender/{location}")
uri.query = URI.encode_www_form({
  "g" => "example",
  "hour" => "example",
  "occurenceType" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/o2.cz/sociodemo/1.2.0/gender/{location}?" . http_build_query([
    "g" => "example",
    "hour" => "example",
    "occurenceType" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with Socio-demo API?

Socio-demo API is a Company API. Developers commonly use company APIs for:

enriching CRM records with company firmographics
building lead-generation and prospecting tools
verifying business identity and registration details
monitoring competitors and market intelligence
powering B2B data enrichment pipelines

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Socio-demo API is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗