# MagangHub Explorer

> Public, read-only internship search for a snapshot of Program Magang Nasional lowongan. Indonesian and English queries are supported by the search design; check returned sources and relevance.

Data snapshot: 2026-10-31. This is not the official Kemnaker website or live vacancy data. The snapshot application deadline is 2026-11-04. Verify availability at the official source before advising someone to apply. Missing descriptions are null; do not invent requirements. Online interview does not imply remote/WFH work.

The initial snapshot can receive incremental bot updates. Check meta.dataMode, meta.revision and meta.lastIngestedAt. lastIngestedAt is the time the most recent batch was committed, not a guarantee that all jobs were refreshed. Each job's observedAt records when its data was observed; null means the initial snapshot. Cite observedAt when available, otherwise snapshotDate. Reads are not cached by this API.

## API
- [API guide](https://maganghub.ngerti.in/api-docs): Parameters, examples, pagination, and limitations.
- [OpenAPI schema](https://maganghub.ngerti.in/openapi.json): Machine-readable API contract, no authentication required.
- [Search jobs](https://maganghub.ngerti.in/api/v1/jobs?q=data%20analyst): Hybrid keyword and semantic search. Use mode=keyword for keyword-only retrieval.
- [Filter values](https://maganghub.ngerti.in/api/v1/facets): Read valid province/city values before applying location filters.
- [Job details](https://maganghub.ngerti.in/api/v1/jobs/{id}): Replace {id} with a job ID from search results. Includes official sourceUrl.

## Usage
Use q for role, skills, or interests. Use explicit filters for location and eligibility; natural-language text is not a guaranteed filter parser. q is limited to 250 characters, limit to 50 (default 12). Follow page/pages for pagination. In hybrid mode total counts keyword matches plus up to 200 qualified semantic candidates, not every possible semantic match. Results must satisfy all supplied filters. Check meta.mode and meta.fallbackReason: provider outages may return keyword results. Observe HTTP 429 and Retry-After. Rank scores are not acceptance probabilities. Cite sourceUrl and the snapshot date. Fetch detail before stating requirements.

Unknown query parameters, including tracking parameters added by AI platforms, are ignored and do not act as filters. Use the documented parameter names. Invalid or repeated documented search parameters return HTTP 400.

Categories cover 22 fields including healthcare, finance, law, education, HR, agriculture, logistics, and engineering. Read valid category values from facets. Categories are inferred from position titles, not official employer classifications; unrecognized titles use category=lain. Check detail before assuming field or eligibility. meta.categoryVersion identifies the taxonomy version.

## Sources
- [Official MagangHub](https://maganghub.kemnaker.go.id/): Authority for current vacancy and application information.