Equaldex offers free non-commercial APIs so researchers, journalists, educators, and developers can access LGBTQ+ rights data. You're welcome to use them for non-commercial purposes. Equaldex is a volunteer-run project that doesn't generate revenue.

Guidelines

• The API is currently in beta: Please keep this in mind when using it. If you're planning to use Equaldex for a larger project, please reach out so we can discuss it.
• LGBTQ+ rights have many nuances: These complexities don't always fit perfectly into a structured database. Equaldex aims to provide information in a structured format, but relevant context should always be included. For example, homosexuality may be legal in a country while LGBTQ+ people are still prosecuted in certain contexts or regions. Editors often provide this context in the description field.
• Equaldex is a community-built knowledge base: While we aim to provide accurate and up-to-date information, some information may be outdated or incorrect and not yet fixed, or a new law may not yet be reflected on Equaldex. Please keep this in mind when displaying Equaldex data.

API Policies

• 🏷️ Attribution is required: Content must include a link to the corresponding Equaldex region page, whose URL is included in the API response. Including Equaldex's logo is preferred. Attribution must be visible, close to the content, and clearly identify Equaldex as the data source.
• 🏎️ Rate limiting: Equaldex's API is not designed to scale. Please limit the number of consecutive requests.
• 💾 Please cache responses: If you display Equaldex content when loading a page or app, cache the API responses to prevent excessive requests.
• 📦 Do not store data for longer periods: You may not store Equaldex data, whether obtained through the API or by other means, for more than 30 days. Equaldex content is updated frequently, so stored content can become stale.
• 💰 Must not be used for commercial purposes: You may not sell the data, offer it to paying users, or display it in a paid app or website. Displaying Equaldex information on a page or app supported by advertising is acceptable. Please contact Equaldex with questions about these policies.
• 📋 Do not replicate the Equaldex service: You may not use Equaldex's API to recreate a similar service.

Equaldex API

• JSON API »
  Programmatic access to region data, laws, and more.

Embed Equaldex on your site

• Widget »
  Embed Equaldex data on your own site.

Equality Index API & Download

Equality Index Terms of Use

• You must credit Equaldex. When displaying an Equality Index value, you must include a link to Equaldex or the Equality Index page.
• Do not track the index over time or publish comparisons of historical scores. The Equality Index reflects current laws and the most recently available public opinion data. As more public opinion data is added, scores can shift because their accuracy has improved—not because equality has necessarily progressed or regressed.

API Parameters

• parent_id — Specify an ISO 3166-1 Alpha-2 country code to return states, provinces, or administrative divisions of that country. Examples include US and AU. Equality Index data may be limited for some administrative divisions due to limited public opinion data.
• dependent_territories — Set to 1 to include dependent territories. The default is 0. This parameter works at both the country and top levels.

API Return Values

• region_id — The region's unique identifier, using ISO 3166-1 Alpha-2 country codes.
• name — The name of the country or region.
• ei — The overall Equality Index score, calculated by averaging the unrounded ei_legal and ei_po values.
• ei_legal — The Legal Equality Index.
• ei_po — The Public Opinion Equality Index.
• rank — The region's position in the ranking based on its raw, unrounded Equality Index score.