API

Autentizace

Každý požadavek nese váš klíč v hlavičce Authorization jako Bearer token. Klíč najdete a aktivujete na stránce účtu.

JSON API

GET /api/agencies — Filtrovaný seznam agentur — stejné parametry jako vyhledávač.

curl -H "Authorization: Bearer AR-XXXX-XXXX-XXXX-XXXX" \
  "https://agencyradar.eu/api/agencies?services=ecommerce&country=SK&limit=20"

GET /api/agencies/{slug} — Úplný profil jedné agentury včetně kontaktů.

curl -H "Authorization: Bearer AR-XXXX-XXXX-XXXX-XXXX" \
  "https://agencyradar.eu/api/agencies/ant-studio"

Parametry filtrování

Kombinujte libovolně; více hodnot oddělte čárkou. Stránkování přes limit a offset (počet na stránku je omezen podle vašeho plánu).

Nejčastější parametry:

q

fulltextové hledání (název, IČO, doména, služby)

country

SK | CZ

services

ecommerce, branding, seo, …

platforms

wordpress, woocommerce, shoptet, …

regions

slugy regionů, oddělené čárkou

sizes

kategorie velikosti týmu

ai

slugy AI služeb

org

agency | studio | freelancer

cities

slugy měst, oddělené čárkou (jako v URL vyhledávače)

langs

kódy komunikačních jazyků (sk, cs, en, …); shoduje se jen se záznamy, které jazyky uvádějí

rate

strop pro zveřejněnou hodinovou sazbu „od“; záznamy bez zveřejněné sazby zůstávají

sort

relevance | score | name | founded | size | revenue | rating | rate

min_capacity_man_days / within_months

třídění podle kapacity: potřebné člověkodny v okně měsíců (volitelně allocation 0,1–1, výchozí 0,5); agentury se známým, ale příliš malým týmem vypadnou, neznámá velikost zůstává a je označena; každý řádek nese `capacity` a model je v `capacity_model`

wl / ent / oss / tenders / reach / sized

příznaky ano/ne, zapíná =1: white-label, enterprise zkušenosti, zveřejňuje open source, veřejné zakázky v registru, má kontaktní údaje, jen s uvedenou velikostí týmu

limit / offset

stránkování

Co se vrátí

JSON obálka s celkovým počtem shod, vyžádanou stránkou, filtry tak, jak je server rozparsoval, a záznamy. `count` je velikost celé množiny shod, ne stránky — stránkujte pomocí `limit` a `offset`.

{
  "count": 1284,          // total matches, before limit/offset
  "offset": 0,
  "limit": 20,
  "page_cap": 20,         // the limit actually applied — your plan's cap clamps it, 500 is the hard ceiling
  "has_more": true,       // more rows past this page
  "next_offset": 20,      // present only while has_more — pass as offset to resume
  "filters": { ... },     // the filters as parsed, so you can confirm what applied
  "results": [
    {
      "slug": "ant-studio",
      "name": "…",
      "registry_id": "…",
      "score": 92, "score_band": "strong", "score_coverage": 0.41,
      "score_capped_by": null,   // 'coverage' | 'vat-unreliable' | 'dormant' when the band is held down
      "email": "…", "phone": "…", "contact_note": "…",
      "currency": "EUR"
      // …every other field of the full profile
    }
  ]
}

Každý záznam je úplný profil: registrová fakta, finance, reference, lokality, zdroje, AgencyRadar Score s pásmem a pokrytím a kontakty prefiltrované podle práva. Pole je null, když ho nikdo nezjistil — null nikdy nečtěte jako „ne“. Na endpointu jednoho záznamu (`/api/agencies/{slug}`) nezjištěné pole ZCELA CHYBÍ místo null — řádek je kompaktovaný jako v MCP. Peněžní pole nesou `currency`.

Chyby

Selhání jsou běžné HTTP kódy s tělem v JSON, které vysvětluje, co změnit.

401

Chybějící klíč, nebo klíč po expiraci či zrušený. Zkontrolujte hlavičku Authorization.

429

Vyčerpaný denní limit požadavků, nebo příliš mnoho požadavků za minutu. Zkuste to za minutu; denní limit se obnovuje v 00:00 UTC.

404

Žádná agentura s tímto slugem. Slugy pocházejí z odpovědi se seznamem, ne z názvu firmy.

Hromadný export

Stejné filtry jako API, ale vrátí výběr jako CSV nebo JSON — nejvýše počet záznamů podle limitu vašeho plánu na požadavek. Přidejte &format=csv nebo &format=json. Export se počítá jako 5 požadavků z denního limitu.

curl -H "Authorization: Bearer AR-XXXX-XXXX-XXXX-XXXX" \
  "https://agencyradar.eu/api/export?services=ecommerce&country=SK&format=csv"

Oba formáty nesou stejná plochá pole. Strukturovaná fakta zůstávají jen v JSON-u, aby se nedeformovala do buňky: awards (program, rok, titul a zdroj na řádek), external_reviews, pobočky mimo sídlo, socials, detail open_source za sloupcem oss_status a částky v původní měně (as-filed). Pokud je potřebujete, použijte format=json.

Zdroje dat a podmínky dalšího použití

Tyto endpointy vracejí fakta sestavená z veřejných registrů a zveřejněných stránek. Některé z těchto zdrojů váží na DALŠÍ POUŽITÍ podmínky — uvedení zdroje, které musí putovat s daty všude, kde se reprodukují. Pokud to, co dostanete, znovu zveřejňujete nebo šíříte, přenášejte s tím i prohlášení níže.

data from Slovak Register of Financial Statements (registeruz.sk) (Open API, CC0); Register of Legal Entities (Statistical Office of the SR) (Open API, CC-BY 4.0 — attribution: ŠÚ SR / RPO); Financial Administration of the SR (opendata.financnasprava.sk) (CC-BY 4.0 — attribution: Finančné riaditeľstvo SR); Business Register of the SR (orsr.sk) (public register, free access); Registr smluv (data.smlouvy.gov.cz) (open data, CC0); ARES (Czech business register) (Czech open data); Czech VAT-payer register — unreliable-payer flag (adisrws.mfcr.cz) (public register web service (Finanční správa ČR), free access); GitHub (github.com) (public API, per GitHub terms of service — facts only, linked to the profile); Pretlak (pretlak.com) (public web pages, no formal licence — read under robots.txt (User-agent: * / Disallow: empty), facts only, attributed and linked to the profile they came from); Na volné noze (navolnenoze.cz) (public web pages, no formal licence — read under robots.txt (which disallows /hledej, /menu/, /soubory/, /temp/ and the document paths, none of which this crawl touches), facts only, attributed and linked to the profile they came from); Agency websites and public directories (public web pages, no formal licence — facts only, attributed and linked to source)

Úplné podmínky včetně toho, co licenční klíč dovoluje: Obchodní podmínky

Limity podle plánu