Comparing Integration Options
At a Glance
| Recruiting Portal | Web Components | API Client | REST API | |
|---|---|---|---|---|
| Time to market | Hours | Days | Weeks | Weeks to months |
| Development effort | None | Low | Medium | High |
| Design customization | Limited (configurator) | Limited (CSS overrides) | Full | Full |
| SEO | Good (SSR) | Poor (Shadow DOM) | Good (with SSR) | Your responsibility |
| Accessibility | Built-in | Built-in (WCAG) | Your responsibility | Your responsibility |
| Hosting | MindKey subdomain | Your website | Your website | Your infrastructure |
| Required skills | None (configuration only) | HTML / CMS | JavaScript / TypeScript | Any programming language |
| Maintained by | MindKey | MindKey | MindKey (library) + You (UI) | You |
Which Option Fits Your Scenario?
| Scenario | Recommended approach |
|---|---|
| Get a career website online without a development team | Recruiting Portal |
| Add vacancies to a WordPress or CMS site | Web Components |
| Build a fully branded career page in React, Angular, or Vue | API Client |
| Create an SEO-optimized career site with Next.js or Nuxt | API Client (server-side) |
| Sync vacancy data into an internal HR system | REST API |
| Feed vacancies to a job board aggregator | REST API |
| Display vacancies on a static HTML site | Web Components |
| Build a custom multi-step application form | API Client |
| Embed vacancies into Sitecore or Umbraco | Web Components |
| Build a mobile app with recruiting features | REST API |
| Integrate recruiting data from a C#, Python, or PHP backend | REST API |
Recruiting Portal
A complete, ready-to-use career website hosted by MindKey. Configure it directly in the MindKey application — no development work required. Includes vacancy listings, details, application forms, job agent subscriptions, and unsolicited applications. Server-side rendered for full search engine indexing.
Teams without developers who need a branded career site online quickly, or when your existing website cannot host recruiting content (no CMS access, restrictive IT policies).
Pros & Cons
Pros
- No development required — configure everything through the MindKey application.
- Server-side rendered — good SEO out of the box.
- Multi-language support with built-in translations.
- Branded experience with configurable colors, fonts, logos, and hero images.
- Built-in responsive design and accessibility.
- Social media sharing and social media links.
- Hosted and maintained by MindKey — no infrastructure to manage.
Cons
- Hosted on a MindKey subdomain — not on your own domain.
- Customization is limited to the portal configurator (colors, fonts, logos, show/hide elements, layout options).
- Fixed page structure — you cannot add custom pages, change the navigation flow, or inject custom content.
- No custom CSS or HTML.
Web Components
Pre-built UI elements you embed directly into your existing website. Add a script tag and a few HTML elements — the components handle vacancy display, application forms, and more.
Available components: vacancy list, vacancy details, application form, job agent, vacancy explorer.
Embedding recruiting content into a CMS-managed site (WordPress, Sitecore, Umbraco) or static site with minimal effort, while keeping everything on your own domain.
Pros & Cons
Pros
- Low development effort — add a script tag and a few HTML elements to your page.
- Maintained and updated by MindKey.
- Built-in responsive design and accessibility (WCAG compliant).
- Works with any website technology.
- Recruiting content lives on your own domain.
Cons
- Limited visual customization — styling can be adjusted through CSS overrides and theming options, but layout and interaction patterns are fixed.
- Content rendered inside the components is not visible to search engines — poor SEO for vacancy pages.
- New features and changes depend on MindKey's release cycle.
API Client (JavaScript Library)
A typed JavaScript/TypeScript library for fetching vacancy and application data. Your team builds a fully custom UI on top. Runs both in the browser and server-side in Node.js, making it suitable for client-rendered apps and SSR frameworks like Next.js or Nuxt.
Development teams building a custom-branded career page with full design control, especially when SEO matters and you want server-side rendering.
Pros & Cons
Pros
- Full control over design and user experience — your career page looks and feels like the rest of your brand.
- Typed API — reduces integration errors and speeds up development.
- Runs in the browser and in Node.js — use it client-side or server-side.
- Good SEO when used with server-side rendering.
- Full control over accessibility standards.
- Recruiting content lives on your own domain.
Cons
- Requires a development team with JavaScript/TypeScript skills.
- You are responsible for building, testing, and maintaining the UI.
- Accessibility compliance is your responsibility.
- Coupled to the client library's release cycle for new API features.
REST API (Direct Integration)
The underlying REST API that powers the portal, web components, and the API client. Any system that can make HTTP requests can use it — no MindKey libraries required.
Non-JavaScript platforms (C#, Python, PHP, Java), backend integrations, mobile apps, or scenarios where you need full control and no dependency on MindKey libraries.
Pros & Cons
Pros
- Works with any programming language or platform — no technology restrictions.
- Maximum flexibility — full control over data handling, caching, and presentation.
- No additional dependencies.
- Full control over SEO — render vacancy pages entirely on the server for full search engine indexing.
- Full control over accessibility.
Cons
- Highest development effort — your team handles HTTP requests, error handling, and response parsing.
- No built-in type safety unless you generate a client from the OpenAPI specification.
- Accessibility compliance is entirely your responsibility.