API Documentation

List All Agencies

Returns a list of all federal agencies with basic information and latest statistics.

Example Response:

{
  "agencies": [
    {
      "id": 1,
      "name": "Environmental Protection Agency",
      "slug": "epa",
      "display_name": "EPA",
      "short_name": "EPA",
      "latest_word_count": 1234567,
      "word_count_growth_1_year": 2.5,
      "word_count_growth_5_year": 15.3
    }
  ],
  "total": 150
}

Get Single Agency

Returns detailed information for a specific agency, including content hash.

Example Response:

{
  "agency": {
    "id": 1,
    "name": "Environmental Protection Agency",
    "slug": "epa",
    "display_name": "EPA",
    "short_name": "EPA",
    "latest_word_count": 1234567,
    "word_count_growth_1_year": 2.5,
    "word_count_growth_5_year": 15.3,
    "content_hash": "abc123def456...",
    "parent_agency_id": null
  }
}

Get Agency Statistics

Returns comprehensive statistics for a specific agency.

Example Response:

{
  "agency": {
    "id": 1,
    "name": "Environmental Protection Agency",
    "slug": "epa",
    "display_name": "EPA",
    "short_name": "EPA",
    "latest_word_count": 1234567,
    "word_count_growth_1_year": 2.5,
    "word_count_growth_5_year": 15.3
  },
  "stats": {
    "latest_word_count": 1234567,
    "word_count_growth_1_year": 2.5,
    "word_count_growth_5_year": 15.3,
    "content_hash": "abc123def456...",
    "chapters_count": 5,
    "snapshots_count": 20,
    "earliest_snapshot": "2020-01-15",
    "latest_snapshot": "2025-01-15"
  }
}

List All Topics

Returns a list of all regulatory topics with section counts and word counts.

Example Response:

{
  "topics": [
    {
      "id": 1,
      "name": "Environmental Protection",
      "slug": "environmental-protection",
      "sections_count": 2541,
      "latest_word_count": 5432100
    }
  ],
  "total": 20
}

Get Single Topic

Returns detailed information for a specific topic, including description and keywords.

Example Response:

{
  "topic": {
    "id": 1,
    "name": "Environmental Protection",
    "slug": "environmental-protection",
    "sections_count": 2541,
    "latest_word_count": 5432100,
    "description": "Environmental and pollution regulations...",
    "keywords": ["environment", "environmental", "pollution", "emission"]
  }
}

Get Topic Statistics

Returns comprehensive statistics for a specific topic.

Example Response:

{
  "topic": {
    "id": 1,
    "name": "Environmental Protection",
    "slug": "environmental-protection",
    "sections_count": 2541,
    "latest_word_count": 5432100
  },
  "stats": {
    "sections_count": 2541,
    "latest_word_count": 5432100,
    "snapshots_count": 15,
    "earliest_snapshot": "2020-01-15",
    "latest_snapshot": "2025-01-15",
    "growth_percent": 12.5
  }
}

cURL

curl https://regometer.com/api/v1/agencies

JavaScript (fetch)

fetch('https://regometer.com/api/v1/agencies')
  .then(response => response.json())
  .then(data => console.log(data));

Python

import requests

response = requests.get('https://regometer.com/api/v1/agencies')
data = response.json()
print(data)

404 Not Found

{
  "error": "Agency not found"
}