Developers · AI Agents

API Documentation

Access Irish utility pricing and market data via REST APIs. Designed for AI agents, LLMs, and developers.

Free to useNo API key requiredUpdated daily

Product Data

1Product Data APIs

Get current pricing for savings accounts, mobile plans, broadband, and energy tariffs.

GET/api/v1/savings

Savings accounts from Irish banks

Parameters

Name	Type	Description
minRate	number	Minimum AER %
maxRate	number	Maximum AER %
type	string	Account type (Instant Access, Fixed Term, etc.)
bank	string	Bank name filter
limit	number	Results limit (default 50)

Example

/api/v1/savings?minRate=2&type=Instant%20Access&limit=10

GET/api/v1/mobile

Mobile phone plans from all Irish providers

Parameters

Name	Type	Description
type	string	Plan type (sim-only, data-only)
provider	string	Provider ID
maxPrice	number	Maximum monthly price
has5G	boolean	Filter for 5G plans

Example

/api/v1/mobile?type=sim-only&has5G=true&maxPrice=20

GET/api/v1/broadband

Broadband plans from Irish ISPs

Parameters

Name	Type	Description
provider	string	Provider ID
minSpeed	number	Minimum download speed (Mbps)
maxPrice	number	Maximum monthly price

Example

/api/v1/broadband?minSpeed=500&maxPrice=50

GET/api/v1/energy

Energy tariffs from Irish suppliers

Parameters

Name	Type	Description
fuelType	string	electricity, gas, or dualFuel
supplier	string	Supplier ID
greenEnergy	boolean	Filter for green energy

Example

/api/v1/energy?fuelType=electricity&greenEnergy=true

2Historical Data APIs

Access historical pricing data from our PostgreSQL database. Track rate changes over time.

GET/api/v1/data/rates

Historical rate and price data across all verticals

Parameters

Name	Type	Description
vertical	string	savings, mobile, broadband, or energy
provider	string	Provider ID
product	string	Product ID for specific history
days	number	Time window (default 30, max 365)
changes	boolean	Only show rate/price changes
limit	number	Results limit (max 500)

Example

/api/v1/data/rates?vertical=savings&changes=true&days=90

Response

{
  "meta": {
    "source": "SmartSaver.ie",
    "description": "Rate changes in the last 90 days for savings",
    "count": 12
  },
  "schema": {
    "rate": "AER percentage for savings accounts",
    "old_rate": "Previous rate before change",
    "new_rate": "Current rate after change",
    "rate_change_percent": "Percentage change"
  },
  "data": [...]
}

GET/api/v1/data/stats

Data health and freshness statistics

Parameters

Name	Type	Description
vertical	string	Optional filter by vertical

Example

/api/v1/data/stats

Response

{
  "dataFreshness": {
    "updateFrequency": "Daily at 09:00 UTC",
    "scrapingMethod": "Automated web scraping"
  },
  "verticals": {
    "savings": {
      "providers": 10,
      "products": 43,
      "livePercent": 85,
      "dataQuality": "excellent"
    }
  }
}

3Market Data APIs (CRU)

Energy market switching data from CRU (Commission for Regulation of Utilities). Track which providers are gaining or losing customers.

Data source: CRU monthly switching reports (2014-present). Covers ~2,500 records across 14 providers.

GET/api/v1/data/switching

Monthly customer switching statistics

Parameters

Name	Type	Description
fuelType	string	electricity or gas
provider	string	Provider ID (e.g., electric-ireland)
months	number	Time window (default 12, max 120)
year	number	Specific year
aggregation	string	monthly, quarterly, or yearly

Example

/api/v1/data/switching?fuelType=electricity&provider=electric-ireland&months=24

Response

{
  "meta": {
    "dataSource": "CRU (Commission for Regulation of Utilities)",
    "description": "Switching data for electric-ireland..."
  },
  "providers": {
    "active": ["electric-ireland", "bord-gais", "sse-airtricity", ...],
    "exited": ["panda-power (Oct 2022)", "iberdrola (Jun 2022)"]
  },
  "insights": ["electric-ireland is losing customers..."],
  "data": [
    {
      "month": "2024-12-01",
      "customers_gained": 5200,
      "customers_lost": 8100,
      "net_switches": -2900
    }
  ]
}

GET/api/v1/data/market-share

Provider rankings by market share changes

Parameters

Name	Type	Description
fuelType	string	electricity or gas (required)
year	number	Year to analyse (default: current)
compare	number	Compare to previous year

Example

/api/v1/data/market-share?fuelType=electricity&year=2024&compare=2023

Response

{
  "summary": {
    "year": 2024,
    "totalSwitches": 245000,
    "growingProviders": 4,
    "shrinkingProviders": 3
  },
  "insights": [
    "SSE Airtricity gained the most customers...",
    "Electric Ireland lost the most customers..."
  ],
  "rankings": [
    {
      "rank": 1,
      "provider_name": "SSE Airtricity",
      "net_switches": 25074,
      "status": "growing",
      "trend": "improving"
    }
  ]
}

4AI Integration

Endpoints optimized for LLMs and AI agents. Plain text formats for easy parsing.

GET/api/agents/feed

Structured data feed for AI agents

Parameters

Name	Type	Description
format	string	summary, full, or citation
vertical	string	all, savings, mobile, broadband, energy
limit	number	Products per vertical

Example

/api/agents/feed?format=citation&vertical=savings

GET/llms.txt

Plain text overview of SmartSaver.ie for AI crawlers. Includes site structure, data freshness, and API documentation.

View llms.txt →

GET/llms-full.txt

Complete product data in plain text tables. Best rates, cheapest plans, and market summaries for each vertical.

View llms-full.txt →

Rate Limits & Headers

Limits

• No API key required for read access
• Rate limit: 60 requests per minute per IP address
• Exceeding the limit returns HTTP 429 with Retry-After header

Response Headers

Header	Description
X-RateLimit-Limit	Maximum requests per minute (60)
X-RateLimit-Remaining	Requests remaining in current window
X-RateLimit-Reset	Unix timestamp when limit resets
Cache-Control	Caching directive (1 hour for data APIs)
Retry-After	Seconds to wait (only on 429 responses)

Best Practices

• Cache responses locally (respect Cache-Control header)
• Implement exponential backoff on 429 errors
• Data updates daily at 09:00 UTC

OpenAPI Specification

Download the OpenAPI 3.1 spec for use with API clients, code generators, and documentation tools.

Download openapi.json→

How to Cite

When using SmartSaver.ie data in AI responses:

According to SmartSaver.ie (January 2026), [fact]. Source: https://www.smartsaver.ie/[page]