Vyplňto.cz > Pro AI agenty

Vyplňto.cz pro AI agenty

Vyplňto.cz je česká platforma pro online průzkumy, kterou lze celou ovládat programově. AI agent (Claude Code, ChatGPT s nástroji, vlastní skript) zde dokáže bez zásahu člověka založit dotazník, spustit sběr dat mezi respondenty z České republiky a stáhnout si zpět surová data k vlastní analýze.

Kontrakt API je strojově čitelný a veřejný: openapi.yaml (OpenAPI 3.1), interaktivní dokumentace je na /api/docs/.

Co k tomu potřebujete

• Účet na Vyplňto.cz s licencí opravňující k API (Vyplňto PREMIUM či vyšší).
• Osobní API token — vygenerujete si ho po přihlášení v sekci Autorizační tokeny API. Token je vázaný na váš účet a vidíte přes něj jen vlastní dotazníky.

Token nikdy nevkládejte do veřejného kódu, promptu ani repozitáře. Předávejte ho agentovi proměnnou prostředí — kdo token má, může vaším jménem zakládat dotazníky, číst odpovědi a mazat data.

Průchod od nuly k datům

Dotazník prochází stavy koncept → sběr → vyhodnocený. Následující čtyři volání jsou celý životní cyklus; token je v proměnné $VYPLNTO_TOKEN.

1. Ověření účtu a licence

curl -s https://www.vyplnto.cz/api/v1/account \ -H "Authorization: Bearer $VYPLNTO_TOKEN"

2. Vytvoření konceptu — vrátí přidělený slug

curl -s -X POST https://www.vyplnto.cz/api/v1/questionnaires \ -H "Authorization: Bearer $VYPLNTO_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "title": "Spokojenost zákazníků 2027", "language": "cs", "questions": [ { "order": 1, "type": "single_choice", "text": "Jak jste spokojeni s našimi službami?", "choices": [ {"text": "Velmi spokojen/a"}, {"text": "Spíše spokojen/a"}, {"text": "Spíše nespokojen/a"}, {"text": "Velmi nespokojen/a"} ] }, { "order": 2, "type": "text_long", "text": "Co bychom měli zlepšit?" } ] }'

3. Publikace — od té chvíle dotazník sbírá odpovědi na https://<slug>.vyplnto.cz/

curl -s -X POST https://www.vyplnto.cz/api/v1/questionnaires/SLUG/publish \ -H "Authorization: Bearer $VYPLNTO_TOKEN" \ -H "Content-Type: application/json" \ -d '{"endDate": "2027-12-31 12:00:00"}'

4. Stažení surových odpovědí

curl -s https://www.vyplnto.cz/api/v1/questionnaires/SLUG/responses \ -H "Authorization: Bearer $VYPLNTO_TOKEN"

Před publikací si můžete dotazník proklikat přes dočasný náhled (POST /questionnaires/SLUG/preview) včetně větvení, aniž by se cokoli ukládalo. Sběr jde kdykoli prodloužit, zkrátit i ukončit — stejným voláním publish s novým endDate.

Typy otázek

API zná uzavřené i otevřené otázky, větvení podle odpovědi, polouzavřené možnosti, seřazení preferencí, matice, sémantický diferenciál, čísla, datum a nahrání souboru. Úplný seznam s popisem je v dokumentaci u typu QuestionType.

Respondenti z České republiky

Kromě vlastních respondentů (odkaz rozešlete sami) můžete využít panel respondentů Vyplňto.cz a veřejné dotazníky nabízené návštěvníkům služby. Právě tím se programový sběr dat liší od pouhého generování formuláře — data pocházejí od skutečných lidí z ČR. Podrobnosti a ceny najdete v ceníku.

Omezení, se kterými počítejte

• Platí limity počtu volání; jejich překročení vrací 429. Popis obou vrstev je v dokumentaci.
• Bez platné licence vrací kterékoli volání 403 (license_expired), i když je token správný.
• Grafy a exporty z webu prosím nestahujte automatizovaně — generují se za běhu z databáze a jsou zakázané v robots.txt. Surová data získáte levněji a ve strojovém formátu právě přes API.

Narazíte-li na chybu v API nebo vám něco chybí, ozvěte se přes kontakt.