---
url: https://docs.dataflair.ai/dataflair/toplist-api/reference-implementations.md
description: How the DataFlair WordPress plugin consumes the Toplist API.
---

# Reference implementations

DataFlair's own **WordPress plugin** (`DataFlair-Toplists`) is a real, production consumer of this
exact Toplist API. It's a useful reference for how the [Integration model](/dataflair/toplist-api/integration-model)
and [Geo-targeting & compliance](/dataflair/toplist-api/geo-targeting) algorithm come together in a working
implementation:

* It syncs toplist data in the background, on a schedule (the same fetch-ahead pattern documented
  in [Integration model](/dataflair/toplist-api/integration-model)) rather than calling DataFlair on the
  request path of a real site visitor.
* At render time, it resolves geo locally against its already-synced data, implementing both Layer 1
  (the mandatory render safety gate) and Layer 2 (the optional auto-select cascade), per DataFlair's
  internal geo-targeting contract.

The plugin's source isn't published as part of this site. If you'd like to see it directly, ask your
DataFlair account contact.