Canonical Data Infrastructure Layer

The canonical API, schema, and dataset hub for open job data.

This domain is the reference documentation surface for APIs, schemas, and versioned datasets. It supports `mewannajob.com` consumer flows and `jobpool.live` transparency workflows while keeping infrastructure documentation in its own lane. The first API layer is intentionally lightweight and no-auth, with Netlify edge rate limiting plus cache controls.

Who this is for

For developers, researchers, builders, and contributors who need consistent access to structured job data without account-gated onboarding.

Start with API Browse dataset versions See transparency layer

Canonical Endpoint https://api.jobdatapool.com/v1/jobs

Compatibility Alias https://jobdatapool.com/api/jobs

Contracts /openapi.json + /schemas/*

Lightweight HTTP Layer

Public no-auth API with versioned contracts

Canonical paths live on `/v1/*` with compatibility aliases on `/api/*`, backed by documented OpenAPI and JSON Schema contracts.

Open canonical `/v1/jobs` Open `/api/jobs` alias Open `/v1/health` Open `/v1/sources` OpenAPI spec Job schema

Runtime shape

Path	Role	Serving Layer
`/api/` and `/v1/`	Lightweight HTTP API	Netlify Functions + edge controls
`/schemas/*`	Machine-readable contracts	Static hosting
`/datasets/*`	Bulk and snapshot access	Static redirects/download surface
`/rfc/*`	Architecture and reasoning layer	Static docs

Request

Field	Type	Notes
`limit`	number	1-500, defaults to 50
`industries`	csv or array	Case-insensitive partial match
`country_code`	string	2-letter ISO style code, example `US`
`distinct_by`	string	Optional dedupe key (`job_title`, `apply_link`, `url`)
`auth`	none	No auth in v1 surface

curl -s "https://api.jobdatapool.com/v1/jobs?limit=5&country_code=US"

curl -s -X POST "https://api.jobdatapool.com/v1/jobs" \
  -H "Content-Type: application/json" \
  -d '{"limit":10,"industries":["Software","Government"]}'

curl -s "https://jobdatapool.com/api/jobs?limit=5"
curl -s "https://api.jobdatapool.com/v1/health"
curl -s "https://api.jobdatapool.com/v1/sources"

Try it (no auth)

Queries run against the canonical endpoint first, then fallback to local compatibility paths.

Ready.

[]

Versioned Datasets

Release pointers and CSV locations

Versions are discovered from the jobpool data repository DVC pointers, then resolved to CSV URLs. This section includes the exact source repo used by `mewannajob` and `jobpool.live`, exposed through a static download surface.

Open datasets home Download latest CSV Open dataset repository Open latest DVC pointer

Loading versions...

Version	CSV URL	DVC
Loading...

Schema

Canonical listing fields

Current schema reflects the live CSV contract used across downstream surfaces and is published as stable machine-readable docs.

Open schema index Job listing JSON Schema Jobs query request schema Health response schema Error schema

Field	Typical Type	Description
`id`	string	Stable record identifier
`job_title`	string	Role title
`company_name`	string	Hiring company
`job_location`	string	Listed location text
`job_seniority_level`	string	Seniority tag
`job_employment_type`	string	Employment type
`job_industries`	string or array-like text	Industry tags
`job_summary`	string	Summary text
`job_base_pay_range`	string	Compensation text
`job_posted_date`	date string	Posting date
`competitiveness_score`	number/string	Optional model score
`skills`	string	Skill list text
`certifications`	string	Certification text
`industries`	string	Alternate industries field
`achievements`	string	Optional metadata
`url`	url string	Source URL
`apply_link`	url string	Application URL
`country_code`	string	Country code
`ingest_utc_date`	date string	Pipeline ingest date
`ingest_utc_hour`	number/string	Pipeline ingest hour
`source_business_url`	url string	Business/source site

Downstream Surfaces

Unique content from each sibling domain

This domain stays infrastructure-first while explicitly linking into the content each other domain uniquely owns.

`mewannajob.com` consumer layer

Data-first job discovery UI and conversion flows.
CSV Lab desktop/mobile and dashboard exploration surfaces.
Resume and fit-oriented user workflows.

Explore jobs Open CSV Lab

`jobpool.live` transparency layer

Bulk dataset downloads and DVC-aware release visibility.
Pooled scraper distribution and contributor entry points.
Preprod/prod contribution leaderboard and transparency model.

Open live layer Open pooled scraper downloads Access canonical API

Ecosystem Topology

Normative flow from ingestion to consumer UX

Matches JPE-RFC-0001 domain responsibilities and linking strategy.

datapool.work

Ingestion Operations

Scraper orchestration, contributor ops, moderation workflows.

jobdatapool.com

Canonical Infrastructure

API, schemas, versioned datasets, documented contracts.

jobpool.live

Transparency Layer

Bulk downloads, scraper docs, contributor visibility.

mewannajob.com

Consumer Product

Job search, alerts, and conversion outcomes.