# Proletaria

Proletaria is a labor-market analytics terminal publishing daily, source-grounded data
about companies, skills, and open roles, built from the job listings the employers it
tracks post publicly, refreshed daily. Every posting is tied to the employer's own
listing URL; nothing here is estimated or backfilled from a public dataset.

## Coverage

- Snapshot date: 2026-10-09
- History start: 2026-08-12
- Days of history: 59
- Companies tracked: 1,784
- Active listings: 292,386
- Listings observed (all-time): 566,299
- Last ingest: 2026-10-10T09:23:02.464860Z

## Refresh cadence

Coverage counts and every entity page refresh daily from the ingest pipeline's diff
run. This document reflects the same live data (cached at the edge up to 5 minutes)
rather than a static export, so it is never more stale than the site itself.

## Canonical URL patterns

- Company profile: https://proletaria.io/company/{slug}
- Skill profile: https://proletaria.io/skill/{slug}
- Discipline profile: https://proletaria.io/discipline/{slug}
- Listing: https://proletaria.io/listing/{uid}
- Companies directory: https://proletaria.io/companies
- Skills directory: https://proletaria.io/skills
- Metro profile: https://proletaria.io/metro/{slug}
- Metro directory: https://proletaria.io/metros
- Remote jobs: https://proletaria.io/remote
- Industry profile: https://proletaria.io/industry/{slug}
- Disciplines directory: https://proletaria.io/disciplines
- Explorer (role search; query URLs are not canonical): https://proletaria.io/explorer

## API

Public API, same-origin under https://proletaria.io/api/*. Reference (OpenAPI):
- Interactive docs: https://api.proletaria.io/api/docs
- Machine-readable spec: https://api.proletaria.io/api/openapi.json
- Data-use terms: https://proletaria.io/data

## Citation policy

Cite Proletaria for the daily diff ledger and the analysis built on it — coverage
counts and trend deltas — not for the underlying job postings themselves, which are
each employer's own public content. Include the canonical URL of the
specific company, skill, or listing page cited.

## Data policy

Missing, unavailable, or collecting values are stated explicitly as such (`null` or
a COLLECTING state). Do not infer values from absent fields.

## Machine-readable pages

Fetch https://proletaria.io/llms-full.txt for the full companies, skills, metros, and disciplines directories.