Quick Start

What Bordfeed Does

Bordfeed is an API-first job feed platform for tracking active, structured job postings. It combines scraped ATS and job-board sources with normalized company, role, salary, location, and enrichment fields so teams can build alerts, lead lists, dashboards, and workflow automations on top of fresh hiring data.

Core Concepts

• Jobs: Normalized postings with source metadata, status, timestamps, compensation, workplace, and enrichment fields.
• Companies: Hiring organizations linked to jobs, ATS connections, and enrichment snapshots.
• Feeds: Saved filters that can be polled, exported, emailed, or delivered by webhook.
• API keys: Organization-scoped credentials for the public REST API.
• Templates: Public starter filters that let developers preview the data before creating their own feeds.

First API Call

Health and template endpoints are public:

curl https://bordfeed.com/api/v1/health
curl https://bordfeed.com/api/v1/templates
curl https://bordfeed.com/api/v1/templates/remote-writing/preview

Authenticated endpoints require an API key:

curl https://bordfeed.com/api/v1/companies \
  -H "Authorization: Bearer bf_live_..."

Local Development

Useful commands while working on Bordfeed:

bun run dev
bun run test
bun run test:e2e
bun run scraper:check
bun run scraper:list

See the API Reference for the full OpenAPI surface.