# RankFabrik

> Four independent data-collection REST APIs run from Paris — Places (local businesses), Jobs (job postings), Captions (video transcripts), and Verify (email verification). Each response reports a per-field fill-rate/completeness percentage, and calls returning no result are never billed.

Generated by API Evangelist from the RankFabrik public documentation on 2026-09-14. RankFabrik does not publish its own llms.txt (https://rankfabrik.com/llms.txt returned 404) or a machine-readable OpenAPI (specs are provided on request by email and via Apify marketplaces). Authentication is a product-scoped API key in the `x-cle-api` header (keys prefixed `rf_`).

## Products

- [Places API](https://places.rankfabrik.com): Local business data collection via geo point + radius sweep with dedup on place ID; optional email extraction. Routes: /rechercher, /balayer, /villes. Billed per place returned. €1 / 1,000 units.
- [Jobs API](https://jobs.rankfabrik.com): Job posting collection that segments by publish window/area to exceed the public 1,000-result cap. Routes: /offres, /collecte, /balayer, /fiche, /fiches, /completes, /societe, /societes. Billed per posting returned. €2.50 / 1,000 units.
- [Captions API](https://captions.rankfabrik.com): Timestamped/segmented video transcript retrieval, up to 50 videos per call. Routes: /inspecter, /transcrire, /lot, /chercher, /moisson. Billed per transcript returned. €2 / 1,000 units.
- [Verify API](https://verify.rankfabrik.com): Email verification via syntax, disposable-domain, MX and SMTP dialogue checks (no message sent), up to 100 addresses per call. Routes: /verifier, /verifier-lot. Billed per address settled. €4 / 1,000 units.

## Documentation

- [Documentation](https://rankfabrik.com/documentation): Endpoints, auth, response headers, error codes.
- [Pricing](https://rankfabrik.com/tarifs): Trial / Artisan / Studio tiers per product, EUR, monthly, no rollover, no overage.
- [Terms](https://rankfabrik.com/conditions): Terms of service.
- [Sign up](https://rankfabrik.com/inscription): Free trial key (500 units/month, no card).
- [Sign in](https://rankfabrik.com/connexion): Account login.

## Conventions

- Auth: `x-cle-api` header, key prefix `rf_`, product-scoped.
- Metering headers: `x-appel-facture` (billable?), `x-unites-restantes` (remaining monthly units), `mesures` (duration/bytes/units).
- Response fields: `completude` (fill-rate %), `motif` (empty reason), `truncated` (time budget hit).
- Errors: custom JSON `{"error": "<message>"}` (French), status 400/401/404/429. Not RFC 9457.
- Quota: monthly unit quota by plan; 429 on exhaustion; nothing billed past quota; a call returning nothing consumes nothing.