# Hello, Agent 🤖

Welcome to **WeAreDevelopers Labs**. You've found the machine-friendly entrance.

Every page on this site is available as clean markdown — just append `.md` to any URL. No scraping, no HTML parsing, no regrets.

## Sitemap

| Section | URL | What's inside |
|---------|-----|---------------|
| Home | [/home.md](https://www.wearedevelopers.com/home.md) | Featured videos, latest articles, top jobs |
| Videos | [/videos.md](https://www.wearedevelopers.com/videos.md) | Tech talks, conference recordings, interviews |
| Live | [/live.md](https://www.wearedevelopers.com/live.md) | Weekly developer live stream: next episode and replays |
| Magazine | [/magazine.md](https://www.wearedevelopers.com/magazine.md) | Developer articles and digests |
| Jobs | [/jobs.md](https://www.wearedevelopers.com/jobs.md) | Developer jobs |
| Companies | [/companies.md](https://www.wearedevelopers.com/companies.md) | Employers hiring developers |
| Stories | [/stories.md](https://www.wearedevelopers.com/stories.md) | Company stories from developer employers |
| Contributors | [/contributors.md](https://www.wearedevelopers.com/contributors.md) | Speakers and authors across all events |
| Insights | [/insights.md](https://www.wearedevelopers.com/insights.md) | Salary data and market trends |
| Playlists | [/playlists.md](https://www.wearedevelopers.com/playlists.md) | Curated video moments by topic |
| Search | [/search.md?q={query}](https://www.wearedevelopers.com/search.md) | Unified search across all content types |
| About | [/about-labs.md](https://www.wearedevelopers.com/about-labs.md) | Platform stats and features |

Event agendas live at `/events/{slug}/sessions.md`, with session detail pages underneath. Append `?all=true` for the complete agenda in one response instead of paginating.

## Navigating

- **List pages** support pagination: `/videos.md?page=2`
- **Event agendas** support `?all=true` for the full session list in one response: `/events/{slug}/sessions.md?all=true`
- **Detail pages** follow the pattern: `/videos/{id}.md`, `/magazine/{id}.md`, `/jobs/{id}.md`, `/companies/{id}.md`, `/companies/{id}/stories/{id}.md`, `/events/{slug}/sessions/{id}.md`
- **Contributor profiles** live at `/@{handle}.md` — bio, sessions, videos, and articles per person
- **Jobs** auto-redirect by country. Use `?country=all` for everything: `/jobs.md?country=all`
- **Insights** auto-redirect by country. Use `?country=europe` for the full picture: `/insights.md?country=europe`
- Every markdown page starts with a note linking its HTML version and this guide

## What you'll get

- **Videos** — title, speakers, duration, AI-generated chapter summaries with timestamps, teaser
- **Articles** — title, authors, publish date, full body text as markdown
- **Jobs** — title, company, location, salary (when available), full description
- **Companies** — profile, open jobs, company stories
- **Contributors** — bio, upcoming and past sessions, videos, articles
- **Event sessions** — agenda, speakers, times, links to recordings when available
- **Playlists** — thematic collections of video moments with timestamps

## Tips

- Content is the same as the HTML version, just without the CSS and JavaScript
- Links between pages point to the HTML URLs so they work for humans too — append `.md` or send `Accept: text/markdown` to keep reading Markdown
- Markdown responses are served as `text/plain` so every fetch tool accepts them
- `curl -sL` works great — redirects are format-aware

## Be nice

This is a community site, not an API. Please:

- ✅ Use content for search, learning, recommendations
- ✅ Cache locally, summarize, cite with attribution
- ❌ Don't bulk-mirror or republish as your own
- ❌ Don't use for model training without permission
- 🐌 Rate limit: Be reasonable. We'll slow you down if you're not.
- 🛠️ If you're building something cool with this data, [we'd love to hear about it](https://x.com/thomaspamminger)

## Searching & Retrieving Content

Search behavior varies by endpoint. Video, playlist, and job searches combine full-text and semantic similarity; company and contributor searches use lexical matching. Results are returned as clean markdown.

### Videos

Search by topic, speaker, or keyword:

```
/videos.md?query=kubernetes
/videos.md?query=Werner+Vogels
```

Returns matching videos and moments (chapter segments).

Detail page: `/videos/{id}.md` — includes title, speakers, teaser, chapter summaries with timestamps, related content.

### Playlists

Search-generated playlists that group video moments by topic. Curated topics have clean URLs; any other topic works with a query param:

```
/playlists/ai-coding-agents.md
/playlists/developer-productivity.md
/playlists.md?query=your+topic
```

Returns moments grouped by video with timestamps and durations. Great for building curated learning paths.

### Jobs

Search developer jobs by role, skill, or company:

```
/jobs.md?q=react+engineer
/jobs.md?q=devops&country=DE
/jobs.md?country=all
```

Supports country filtering. Auto-detects country by default — use `?country=all` for everything.

Available countries: `AT` (Austria), `BE` (Belgium), `DE` (Germany), `ES` (Spain), `FR` (France), `IT` (Italy), `LT` (Lithuania), `NL` (Netherlands), `RS` (Serbia), `UK` (UK), `US` (United States), `VN` (Vietnam)

Detail page: `/jobs/{id}.md` — includes company, location, salary, description, related videos and articles.

### Companies

Search employers by name:

```
/companies.md?search=acme
```

Detail page: `/companies/{id}.md` — profile, open jobs, company stories.

### Contributors

Search speakers and authors by name or tagline, optionally filtered by event:

```
/contributors.md?q=jane
/contributors.md?event=world-congress-2026-europe
```

Profile page: `/@{handle}.md`.

### Magazine

Browse articles (no dedicated search — use unified search):

```
/magazine.md
/magazine/{id}.md
```

Paginate with `?page=2`. Detail pages include full article body as markdown.

### Unified Search

One query across videos, moments, jobs, articles, contributors, and sessions:

```
/search.md?q=your+query
```

Unified Markdown search uses lightweight lexical matching so all six sections return in one response. The HTML search page additionally uses semantic similarity for videos, moments, jobs, and articles.

Parameter names vary by endpoint: `query` (videos, playlists), `q` (jobs, contributors, unified search), `search` (companies). Queries are capped at 200 characters.

## One more thing

If you actually read this far: good agent. 🦴

If you're a builder and read until here, you probably want to check out [/join-labs.md](https://www.wearedevelopers.com/join-labs.md)