# Proletaria

Proletaria is a labor-market analytics terminal publishing daily, source-grounded data
about companies, skills, and open roles, built from a polite daily diff of employers'
own careers sites and ATS APIs. 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-09-07
- History start: 2026-08-12
- Days of history: 27
- Companies tracked: 1,780
- Active listings: 276,002
- Listings observed (all-time): 389,754
- Last ingest: 2026-09-07T10:13:40.706759Z

## 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/*; documented in the API contract:
https://github.com/bennysc/proletaria-backend/blob/main/docs/api-contract.md

## 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
public on each employer's own careers site. 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.