API

Autentifikácia

Každá požiadavka nesie váš kľúč v hlavičke Authorization ako Bearer token. Kľúč nájdete a aktivujete na stránke účtu.

JSON API

GET /api/agencies — Filtrovaný zoznam agentúr — rovnaké parametre ako vyhľadá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 jednej agentúry vrátane kontaktov.

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

Parametre filtrovania

Kombinujte ľubovoľne; viac hodnôt oddeľte čiarkou. Stránkovanie cez limit a offset (počet na stránku je obmedzený podľa vášho plánu).

Najčastejšie parametre:

q

fulltextové hľadanie (názov, IČO, doména, služby)

country

SK | CZ

services

ecommerce, branding, seo, …

platforms

wordpress, woocommerce, shoptet, …

regions

slugy regiónov, oddelené čiarkou

sizes

kategórie veľkosti tímu

ai

slugy AI služieb

org

agency | studio | freelancer

cities

slugy miest, oddelené čiarkou (ako v URL vyhľadávača)

langs

kódy komunikačných jazykov (sk, cs, en, …); vyberie len záznamy, ktoré svoje jazyky uvádzajú

rate

horná hranica zverejnenej hodinovej sadzby „od“; záznamy bez zverejnenej sadzby zostávajú vo výsledku

sort

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

min_capacity_man_days / within_months

triedenie podľa kapacity: potrebné človekodni v okne mesiacov (voliteľne allocation 0,1–1, predvolene 0,5); agentúry so známym, no primalým tímom vypadnú, neznáma veľkosť zostáva a je označená; každý riadok nesie `capacity` a model je v `capacity_model`

wl / ent / oss / tenders / reach / sized

príznaky áno/nie, zapína =1: white-label, enterprise skúsenosti, zverejňuje open source, verejné zákazky v registri, má kontaktné údaje, len s uvedenou veľkosťou tímu

limit / offset

stránkovanie

Čo sa vráti

JSON obálka s celkovým počtom zhôd, vyžiadanou stránkou, filtrami tak, ako ich server rozparsoval, a záznamami. `count` je veľkosť celej množiny zhôd, nie stránky — stránkujte pomocou `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é fakty, financie, referencie, lokality, zdroje, AgencyRadar Score s pásmom a pokrytím a kontakty prefiltrované podľa práva. Pole je null, keď ho nikto nezistil — null nikdy nečítajte ako „nie“. Na endpointe jedného záznamu (`/api/agencies/{slug}`) nezistené pole ÚPLNE CHÝBA namiesto null — riadok je kompaktovaný ako v MCP. Peňažné polia nesú `currency`.

Chyby

Zlyhania sú bežné HTTP kódy s telom v JSON, ktoré vysvetľuje, čo zmeniť.

401

Chýbajúci kľúč, alebo kľúč po expirácii či zrušený. Skontrolujte hlavičku Authorization.

429

Vyčerpaný denný limit požiadaviek, alebo priveľa požiadaviek za minútu. Skúste to o minútu; denný limit sa obnovuje o 00:00 UTC.

404

Žiadna agentúra s týmto slugom. Slugy pochádzajú z odpovede so zoznamom, nie z názvu firmy.

Hromadný export

Rovnaké filtre ako API, ale vráti výber ako CSV alebo JSON — najviac počet záznamov podľa limitu vášho plánu na požiadavku. Pridajte &format=csv alebo &format=json. Export sa počíta ako 5 požiadaviek 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 nesú rovnaké ploché polia. Štruktúrované fakty ostávajú len v JSON-e, aby sa nedeformovali do bunky: awards (program, rok, titul a zdroj na riadok), external_reviews, pobočky mimo sídla, socials, detail open_source za stĺpcom oss_status a sumy v pôvodnej mene (as-filed). Ak ich potrebujete, použite format=json.

Zdroje dát a podmienky ďalšieho použitia

Tieto endpointy vracajú fakty zostavené z verejných registrov a zverejnených stránok. Niektoré z týchto zdrojov viažu na ĎALŠIE POUŽITIE podmienky — uvedenie zdroja, ktoré musí putovať s dátami všade, kde sa reprodukujú. Ak to, čo dostanete, znovu zverejňujete alebo šírite, prenášajte s tým aj vyhlásenie nižšie.

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é podmienky vrátane toho, čo licenčný kľúč dovoľuje: Obchodné podmienky

Limity podľa plánu