URL: /docs/examples/introduction

---
title: Examples
description: Runnable end-to-end code against the Revised API.
---

Complete, runnable programs rather than snippets. The [guides](/docs/guides/finding-domains) show one call at a time; these show a whole job.

<CardGroup cols={1}>
  <Card title="Python walkthrough" icon="code" href="/docs/examples/python-walkthrough">
    A Jupyter notebook that pages the directory with a cursor, flattens the banded metrics, ranks what comes back on transparent weights, reveals a name and exports an open-tier shortlist to CSV. Runs with or without an API key — it bundles 30 real open-tier listings so every cell executes offline.
  </Card>
</CardGroup>

## Shorter snippets, in context

The guides carry working code for individual jobs:

- [The paging loop](/docs/guides/finding-domains#page-with-the-cursor) — cursor, page cap, rate-limit pause.
- [The band parser](/docs/guides/evaluating-a-domain#the-metrics-are-bands) — `"10-50"`, `"<100"`, `"250+"`, `"1K-5K"`.
- [A weighted ranking that drops missing components](/docs/guides/evaluating-a-domain#missing-is-not-zero) rather than zeroing them.
- [The incremental sync loop](/docs/guides/incremental-sync#every-row-is-idempotent) — watermark, tombstones, idempotent upsert.
- [The republishing guard](/docs/guides/republishing-rules#the-pattern-filter-at-the-source-assert-at-the-boundary) — in Python, pandas and `jq`.

Every example uses real endpoint paths and real field names. If one stops working, the [API reference](/docs/api/introduction) is generated from the live spec and wins.