Canonical Data Layer · Job Pool

Canonical job data infrastructure for the Job Pool ecosystem.

Q: Is the JobDataPool API free and public?

Yes. The /v1 API remains public without sign-in, with an anonymous limit of 5 requests and 10 listings per 60 seconds. Verified members receive 60 requests and 30 listings per 60 seconds. API results and successful job redirects share the listing allowance.

Q: Can my job board publish a preferred-access signal toward JobDataPool?

Yes. Publishers expose preferred-access signals through robots.txt comments, HTTP Link headers (RFC 8288), HTML metadata, verification tokens, and feed descriptors. JobDataPool is positioned as a cooperative structured alternative — never as exclusive access, mandatory usage, or an authorization mechanism. See /whitepapers/#publishers for the full pattern.

JobDataPool hosts the public API, OpenAPI contract, JSON Schemas, versioned datasets, and whitepapers that consumer products, transparency surfaces, and contributor tooling read from. JDP-WHITEPAPER-0001 and JDP-WHITEPAPER-0002 draw the boundaries — ingestion, normalization, and provenance live here so job sites, transparency tools, and contributor pipelines do not each reinvent the same plumbing.

Explore the API Download datasets Install MCP

Public by design

Ecosystem usage

A rolling picture of daily traffic and distinct visitors across the ecosystem dashboards. We publish coarse totals only — never raw IPs, never request paths, never anything you could mistake for surveillance.

Bring your product into the pool Meet the members

Daily volume

Requests per day

Window: --
Total: --
Daily avg: --
Peak: --

Loading daily request totals…

Distinct IPs

Unique visitors per day

Window: --
Total: --
Daily avg: --
Peak: --

Loading daily visitor counts…

Built from /v1/launch-metrics Schema: launch-metrics.schema.json Updated hourly.

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

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

Contracts /openapi.json /schemas/*

Live contract

v1 is public, documented, and meant to be cached.

Access: No account is required. Anonymous limits are 5 requests and 10 listings per 60s; signed-in members receive 60 requests and 30 listings per 60s; active supporters receive 120 requests and 2,000 listings per 60s. API results and successful job redirects share the listing allowance.
Boundaries: This domain is for builders and machines. Consumer job search and SEO stay on mewannajob.com and thehiringcafe.com.
Trust: OpenAPI, JSON Schema, whitepapers, dataset pointers, and source metadata are published on the public web for review before integration.

Health Sources

HTTP surface

A small API with contracts you can codegen against

Canonical routes sit on /v1/*; older integrations can keep using /api/*. Every shape worth trusting is spelled out in OpenAPI and JSON Schema.

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

What runs where

Path	Role	Serving Layer
`/api/` and `/v1/`	Lightweight HTTP API	Netlify Functions plus edge controls
`/schemas/*`	Machine-readable contracts	Static hosting
`/datasets/*`	Bulk and snapshot access	Static redirects and download surface
`/docs/*`	API and source-integration documentation	Static docs
`/whitepapers/*`	Trust and architecture records	Static docs

Request contract

Field	Type	Notes
`limit`	number	1-50, defaults to 25
`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`, or `url`
`Authorization`	header	Optional Firebase ID token for account-based quotas

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

curl -s "https://api.jobdatapool.com/v1/health"
curl -s "https://api.jobdatapool.com/v1/sources"

Try it

The playground tries the canonical API host first, then falls back to on-site aliases if needed.

Ready.

[]

For builders

Launch a job product without rebuilding the data plane

JobDataPool handles listings, schemas, and provenance. Focus your product on audience, ranking, editorial UX, and apply-flow conversion.

Prototype against live data

Query /v1/jobs for listings and /v1/sources for source metadata. Point staging at the compatibility host until you are ready to cut over to the canonical API.

Lock shapes with contracts

Generate clients, tests, and tooling from /openapi.json and /schemas/job-listing.schema.json so staging and production share the same validated shapes.

Bootstrap from snapshots

Use versioned CSVs for demos, notebooks, and one-off imports. Use the API for current listings and ongoing sync.

Respect domain boundaries

Do not mirror consumer SEO pages from mewannajob.com. Build your own search and editorial surface, and integrate against JobDataPool for the data contract.

Documentation

Stable documentation and contracts are easy to cite

API reference, publisher discovery signals, crawl etiquette, agent instructions, and the whitepapers that explain why the pool is split across domains.

Start with contracts

Read the API, source catalog, schemas, and CSV releases before building a custom crawler.

Read API docs

Signal from your job board

Publishers can mark preferred access via robots comments, Link headers, HTML tags, verification tokens, and feed metadata.

Read publisher docs

Responsible crawling

Prefer cached structured access, identifiable user agents, visible attribution, and conservative refresh rates.

Read access policy

Coding agent instructions

Cursor, Claude, and Codex use one shared instruction set for this repository.

Open agent docs

Community

Contribute to data quality and governance

Public dashboards have logged 38,822+ requests across the ecosystem. Ongoing work needs human review: source vetting, schema maintenance, listing quality, and a forum where builders can coordinate.

Launch Signal

38,822+ requests so far

1,294avg/day —days 3sites

Fetching the latest public counter…

Community

Discuss on r/jobdatapool

Source reports, listing quality issues, whitepaper discussion, launch updates, and builder coordination.

Review committee

Join the review committee

Volunteer to vet sources, review schema and whitepaper changes, validate listing provenance, improve contributor workflows, or help with community moderation.

Bulk data

Monthly job-listing samples in five formats

Anonymous downloads are reproducible random samples capped at 100,000 masked listings per month. Sign in on the datasets page to reveal complete masked releases and their DVC pointers.

Open datasets home Download latest CSV Open dataset schema Sign in for complete data

Loading versions...

Release	Primary file	Published	Size	Download
Loading...

Schema

One listing shape, many surfaces

The fields below mirror the live CSV contract. The JSON Schema is the authoritative machine-readable copy.

Open schema index Job listing JSON Schema Launch metrics schema Health response schema Error schema

Field	Typical Type	Description
`id`	string	Stable record identifier
`ingestion_date`	date string	First ingest date (YYYY-MM-DD)
`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
`year`	number/string	Dataset release year
`month`	number/string	Dataset release month (1–12)
`validated_on`	date string	Last validation date (YYYY-MM-DD)
`listing_closed`	boolean/string	Closed flag from latest validation
`posting_url`	url string	Masked redirect URL on API responses
`source_business_url`	url string	Business/source site when supplied upstream

Trust · Whitepaper 0001

Verifiable trust signals

JDP-WHITEPAPER-0001 defines provenance, freshness, source-aware records, structured contracts, and controlled openness as requirements. JobDataPool publishes the contracts, domain boundaries, and operational metrics needed to verify those claims.

Provenance in every record

Each listing includes url, apply_link, source_business_url, ingest_utc_date, and ingest_utc_hour for tracing origin and lifecycle.

Contracts you can generate from

The OpenAPI 3.1 spec and JSON Schemas are public and versioned by URL. Point SDKs, agents, and CI at those files instead of parsing page HTML.

Freshness you can see

Ingest timestamps and /v1/launch-metrics show how recently the pool was exercised. The usage panel shares only coarse daily totals — never IPs, never paths.

Open, with guardrails

v1 remains available without sign-in: 5 requests and 10 listings per 60s per IP. Verified members receive account-based limits of 60 requests and 30 listings per 60s; active supporters receive 120 requests and 2,000 listings per 60s. API results and successful job redirects share the listing allowance, per Whitepaper 0001.

Explicit domain roles

mewannajob.com and thehiringcafe.com are for seekers. jobpool.live is for transparency. datapool.work runs ingestion. jobdatapool.com holds the canonical data. Whitepaper 0002 draws the lines.

Public architecture records

The JDP Whitepaper series documents why the ecosystem is split across domains. Stable URLs, a public changelog, and r/jobdatapool support open design discussion.

Sibling sites

Related domains, separate responsibilities

JobDataPool stays infrastructure-first. Each linked domain owns a different slice of the experience.

`mewannajob.com` — for job seekers

Job search and discovery built on pooled listings data.
CSV Lab for poking at releases on desktop and mobile.
Resume and fit workflows for people actually applying.

Explore jobs Open CSV Lab

`jobpool.live` — for transparency

Bulk downloads and DVC-aware release visibility.
Pooled scrapers and contributor onboarding.
Leaderboards that show who shipped what, and when.

View live data Pooled scraper downloads Contribute a source

Ecosystem Topology

Normative flow from ingestion to consumer UX

Matches JDP-WHITEPAPER-0001 domain responsibilities and JDP-WHITEPAPER-0002 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.

FAQ

Frequently asked questions about JobDataPool

Quick answers for builders, researchers, and AI agents evaluating the Job Pool ecosystem. Start with the documentation hub; use trust and architecture, JDP-WHITEPAPER-0001, and JDP-WHITEPAPER-0002 for the durable design record.

What is JobDataPool?

JobDataPool is the canonical data infrastructure layer of the Job Pool ecosystem. It hosts the public /v1 REST API, OpenAPI 3.1 contract, JSON Schemas, versioned CSV datasets, and architecture whitepapers that downstream consumer products, transparency surfaces, and contributor tooling read from.

Is the JobDataPool API free and public?

Yes. The /v1 API remains public without sign-in. Anonymous traffic receives 5 requests and 10 listings per 60 seconds per IP; verified members receive 60 requests and 30 listings per 60 seconds per user; active supporters receive 120 requests and 2,000 listings per 60 seconds. API results and successful job redirects share the listing allowance. See your current estimate and supporter options on the profile page.

How is JobDataPool different from mewannajob.com, thehiringcafe.com, and jobpool.live?

JDP-WHITEPAPER-0002 splits the Job Pool ecosystem across four cooperating domains: mewannajob.com and thehiringcafe.com are the consumer job-search products, jobpool.live is the transparency layer with bulk downloads and scraper outputs, datapool.work runs ingestion operations, and jobdatapool.com is the canonical data infrastructure where the API, schemas, and reviewed datasets live.

How do I become a job data source for the pool?

Three documented integration paths: expose a structured feed for JobPoolBot to crawl, submit a reviewed scraper on jobpool.live/docs/submissions, or upload a CSV that conforms to job-listing.schema.json. The full submission guide lives at /docs/data-sources/.

Is the job listings dataset openly downloadable?

Yes. Anonymous CSV, JSON, Parquet, and API JSON samples are published under /datasets/ and capped at 100,000 masked listings per month. Sign in there for complete masked releases and DVC pointers.

Can my job board publish a preferred-access signal toward JobDataPool?

Yes. Publishers expose preferred-access signals through robots.txt comments, HTTP Link headers (RFC 8288), HTML metadata, verification tokens, and feed descriptors. JobDataPool is positioned as a cooperative structured alternative — never as exclusive access, mandatory usage, or an authorization mechanism. See /whitepapers/#publishers for the full pattern.