StartupJobs DEV

Postavte si kariérní web nad nabídkami ze StartupJobs nebo importujte kandidáty do vlastního systému, oboje snadno zvládnete s naším API!

Public API

Pokuď máte zájem o vyzkoušení StartupJobs API, napište na support@startupjobs.cz.
  1. Sledujte změny v API

    Při změnách našeho API vás upozorněníme e-mailem.

  2. Autorizace

    Autorizace probíhá pomocí Bearer tokenu, který musí být posílán v hlavičce každého requestu na API endpointy. Každá firma obdrží unikátní token.

    Authorization: Bearer <token>
  3. Seznam nabídek

    Endpoint vrací seznam aktivních nabídek firmy

    • Endpoint URL
      GET
      https://api.startupjobs.cz/company/offers
    • Query Parameters
      none
    • Request example
      https://api.startupjobs.cz/company/offers
    • Response
      200 OK
    • Headers
      Content-type: application/json
    • Body
                [
    {
        "id": "9629f28d-78b5-4194-90f9-996cd6cf2aa9",
        "links": [
            {
                "url": "https://www.startupjobs.cz/nabidka/1234",
                "lang": "cs"
            },
            {
                "url": "https://www.startupjobs.cz/en/job/1234",
                "lang": "en"
            }
        ],
        "names": [
            {
                "name": "StartupJobs PHP žralok",
                "lang": "cs"
            },
            {
                "name": "StartupJobs PHP shark",
                "lang": "en"
            }
        ],
        "internal_name": "PHP programátor",
        "descriptions": [
            {
                "description": "<p>Pojď pracovat s námi! StartupJobs</p>",
                "lang": "cs"
            },
            {
                "description": "<p>Come work with us! StartupJobs</p>",
                "lang": "en"
            }
        ],
        "locations": [
            "Praha, Česko"
        ],
        "shifts": [
            {
                "name": "FULL_TIME",
                "hours": 160
            },
            {
                "name": "PART_TIME",
                "hours": 80
            }
        ],
        "collaborations": [
            {
                "id": 1,
                "collaboration": "external"
            },
            {
                "id": 2,
                "collaboration": "remote"
            },
            {
                "id": 3,
                "collaboration": "internship"
            }
        ],
        "seniorities": [
            {
                "id": 1,
                "seniority": "junior"
            }
        ],
        "areas": [
            {
                "id": 1,
                "area": "Vývoj"
            },
            {
                "id": 2,
                "area": "Back-End"
            },
            {
                "id": 4,
                "area": "PHP"
            }
        ],
        "salary": {
            "min": 50000,
            "max": 80000,
            "measure": "monthly",
            "currency": "CZK"
        },
        "benefits": [
            {
                "id": 1,
                "benefit": "13. a 14. plat"
            },
            {
                "id": 6,
                "benefit": "Čas na inovace"
            },
            {
                "id": 7,
                "benefit": "Čas na vlastní projekt"
            }
        ],
        "created_at": "2020-07-08T13:46:45",
        "updated_at": "2020-07-08T13:59:47",
        "valid_until": "2020-08-07T13:47:24"
    }
]
  4. Seznam kandidátů

    Endpoint vrací seznam všech kandidátů firmy

    • Endpoint URL
      GET
      https://api.startupjobs.cz/company/applications
    • Query Parameters
      Name Description
      offeruuid of the offer
      created_at.gt returns candidates created after given date
      created_at.lt returns candidates created before given date
    • Request example
      https://api.startupjobs.cz/company/applications?offer=1e8c1d7b-673a-42b6-9da9-5eeb2a8ce308&created_at.gt=2020-04-01&createad_at.lt=2020-05-01
    • Response
      200 OK
    • Headers
      Content-type: application/json
    • Body
                  [
    {
        "id": "3e51e86d-9562-4611-a8a4-97412569f446",
        "name": "Pan Žralok",
        "created_at": "2020-07-08T13:56:43",
        "offer": {
            "id": "9629f28d-78b5-4194-90f9-996cd6cf2aa9",
            "names": [
                {
                    "name": "StartupJobs PHP zralok",
                    "lang": "cs"
                },
                {
                    "name": "StartupJobs PHP shark",
                    "lang": "en"
                }
            ],
            "created_at": "2020-07-08T13:46:45"
        }
    }
]
  5. Detail kandidáta

    Endpoint vrací detailní informace o kandidátovi

    • Endpoint URL
      GET
      https://api.startupjobs.cz/company/applications/{candidate uuid}
    • Query Parameters
      none
    • Request example
      https://api.startupjobs.cz/company/applications/3e51e86d-9562-4611-a8a4-97412569f446
    • Response
      200 OK
    • Headers
      Content-type: application/json
    • Body
                  {
    "id": "5bf84a69-3a5c-4ddb-8cea-ae111bd262c5",
    "name": "Pan Žralok",
    "email": "zralok@startupjobs.cz",
    "phone": "123 456 789",
    "linkedin": {
        "url": "https://www.linkedin.com/panzralok"
    },
    "text": "Umím skvěle programovat v PHP!",
    "attachments": [
        {
            "url": "https://www.startupjobs.cz/uploads/panzralok.png"
        }
    ],
    "notes": null,
    "status": "new",
    "offer": {
        "id": "9629f28d-78b5-4194-90f9-996cd6cf2aa9",
        "name": [
            {
                "name": "StartupJobs PHP žralok",
                "lang": "cs"
            },
            {
                "name": "StartupJobs PHP shark",
                "lang": "en"
            }
        ],
        "internal_position_name": "PHP programátor"
    },
    "created_at": "2020-07-08T13:59:47"
}
  6. Přihlášení k odběru nových nabídek

    Endpoint umožňuje zaregistrovat e-maily uživatelů, kteří obdrží upozornění, jakmile firma přidá novou nabídku.

    Máte zájem o využití tohoto endpointu? Kontaktujte prosím support@startupjobs.cz.

Webhooks

Na StartupJobs můžete využít webhooks pro získání informací o přihlášených zájemcích.
  1. Jak webhook nastavit?

    Při přidání/úpravě nabídky v sekci Další možnosti můžete zadat URL adresu (webhook), na kterou vám budeme zasílat informace o zájemcích ihned po jejich přihlášení.

    Webhook musí vracet HTTP response code 200, 201, 202, 204 nebo 422, jinak webhook automaticky odmažeme.

  2. JSON payload

    Informace o zájemci posíláme ve formátu JSON.

            {
    "date": "2017-09-11T18:19:15+02:00",
    "candidateID": 12345,
    "offerID": 1234,
    "name": "Pan Žralok",
    "position": "Vývojář webhooků",
    "why": "<p>Chci se stát vývojářem webhooků na StartupJobs.cz, protože mě to baví!</p>",
    "phone": "+420 725 875 752",
    "email": "dev@startupjobs.cz",
    "details": "https://www.startupjobs.cz/admin/company/zajemce/32437/pan-zralok?oid=1234",
    "linkedin": "https://linkedin.com/pan-zralok",
    "internalPositionName": "JOB1",
    "files": [
        "https://www.startupjobs.cz/download/file.pdf"
    ],
    "gdpr_accepted": true
}
  3. Testovací payload

    Při nastavení webhooku (přidání/úprava nabídky sekce Další možnosti) můžete poslat testovací request (simulace přihlášení kandidáta). Payload testovacího requestu obsahuje navíc hodnotu "test":true.

            {
    "date": "2017-09-11T18:19:15+02:00",
    "candidateID": 12345,
    "offerID": 1234,
    "name": "Mr. Shark",
    "position": "Webhook developer",
    "why": "<p>Hello from StartupJobs. This is not a real candidate, just testing your webhook.</p>",
    "phone": "+420 725 875 752",
    "email": "dev@startupjobs.cz",
    "details": "https://www.startupjobs.cz/",
    "linkedin": "https://linkedin.com/",
    "internalPositionName": "JOB1",
    "files": [
        "https://www.startupjobs.cz/favicon.ico"
    ],
    "gdpr_accepted": true,
    "test": true
}
    V případě dotazů nás neváhejte kontaktovat na support@startupjobs.cz.
Přihlaste se k newsletteru a posuňte se vpřed!
Posun vpředZnalostní testyStartupTalkCo je startupO násInzerce práceStartup Program
CeníkVOPOsobní údajeCookiesPro médiaKontakt
© 2012 – 2025 StartupJobs.com s.r.o.