Fibre Compare

Check which fibre and broadband deals are available at a UK postcode (or exact address via UPRN/UDPRN) using fibrecompare.com. Returns providers, download speeds, monthly prices, contract lengths, key features and a sign-up link for each deal. Optionally filter by minimum speed, maximum price, provider or contract length.

{
  "type": "object",
  "properties": {
    "postcode": {
      "type": "string",
      "minLength": 5,
      "maxLength": 10,
      "description": "UK postcode to check, e.g. 'SW1A 1AA'. Spacing and case do not matter."
    },
    "address": {
      "type": "string",
      "maxLength": 120,
      "description": "House number/name and optionally street, e.g. '12', 'Flat 3, 12', 'Rose Cottage'. If it matches one premises at the postcode the check is done at address level in this same call."
    },
    "address_key": {
      "type": "string",
      "description": "An address_key from a previous result's addresses list. Runs the check for that exact premises."
    },
    "uprn": {
      "type": "string",
      "description": "Unique Property Reference Number for the exact premises, if known. Gives an address-level rather than postcode-level answer."
    },
    "udprn": {
      "type": "string",
      "description": "Royal Mail Unique Delivery Point Reference Number, if known and no UPRN is available."
    },
    "min_download_mbps": {
      "type": "number",
      "minimum": 0,
      "description": "Only return deals whose average download speed is at least this many Mbps (e.g. 100, 500, 900)."
    },
    "max_monthly_cost_gbp": {
      "type": "number",
      "minimum": 0,
      "description": "Only return deals costing at most this much per month in GBP."
    },
    "max_contract_months": {
      "type": "integer",
      "minimum": 0,
      "description": "Only return deals with a contract of at most this many months (0 = rolling/no contract)."
    },
    "provider": {
      "type": "string",
      "description": "Only return deals from providers whose name contains this text, e.g. 'BT', 'Hyperoptic'."
    },
    "sort": {
      "type": "string",
      "enum": [
        "recommended",
        "value",
        "price",
        "speed",
        "site"
      ],
      "description": "Ordering: 'recommended' (default; fibrecompare.com's editorial ranking), 'value' (cheapest effective monthly cost), 'price' (cheapest headline monthly cost), 'speed' (fastest first) or 'site' (backend order)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Maximum number of deals to return (default 5). The full list is always available at view_more_url."
    },
    "visitor_id": {
      "type": "string",
      "maxLength": 20,
      "description": "The visitor_id from a previous result in this conversation. Reuse it so checks and deal clicks are attributed to the same visit. Omit on the first call."
    }
  },
  "required": [
    "postcode"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "postcode": {
      "type": "string"
    },
    "display_address": {
      "type": "string"
    },
    "uprn": {
      "type": "string"
    },
    "udprn": {
      "type": "string"
    },
    "address_level": {
      "type": "string",
      "enum": [
        "premises",
        "postcode"
      ]
    },
    "addresses": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "address_key": {
            "type": "string"
          },
          "address": {
            "type": "string"
          }
        },
        "required": [
          "address_key",
          "address"
        ],
        "additionalProperties": false
      },
      "description": "For postcode-level results: the premises at this postcode. Pass one's address_key back to get an exact-address check."
    },
    "addresses_note": {
      "type": "string"
    },
    "total_deals": {
      "type": "number"
    },
    "returned_deals": {
      "type": "number"
    },
    "deals": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "product_id": {
            "type": "number"
          },
          "provider": {
            "type": "string"
          },
          "provider_slug": {
            "type": "string"
          },
          "provider_logo_url": {
            "type": "string"
          },
          "provider_accent_colour": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "technology": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "average_download_mbps": {
            "type": [
              "number",
              "null"
            ]
          },
          "estimated_speed": {
            "type": [
              "string",
              "null"
            ]
          },
          "data_allowance_gb": {
            "type": [
              "number",
              "null"
            ]
          },
          "speed_class": {
            "type": [
              "string",
              "null"
            ]
          },
          "monthly_cost_gbp": {
            "type": [
              "number",
              "null"
            ]
          },
          "monthly_cost_after_contract_gbp": {
            "type": [
              "number",
              "null"
            ]
          },
          "setup_cost_gbp": {
            "type": [
              "number",
              "null"
            ]
          },
          "initial_cost_gbp": {
            "type": [
              "number",
              "null"
            ]
          },
          "initial_period_months": {
            "type": [
              "number",
              "null"
            ]
          },
          "contract_length_months": {
            "type": [
              "number",
              "null"
            ]
          },
          "effective_monthly_cost_gbp": {
            "type": [
              "number",
              "null"
            ]
          },
          "first_year_cost_gbp": {
            "type": [
              "number",
              "null"
            ]
          },
          "total_contract_cost_gbp": {
            "type": [
              "number",
              "null"
            ]
          },
          "cost_basis": {
            "type": "string",
            "enum": [
              "backend",
              "estimated"
            ],
            "description": "Whether the cost figures come from fibrecompare's computed pricing (models price rises) or are a local estimate."
          },
          "pricing_summary": {
            "type": [
              "string",
              "null"
            ]
          },
          "offer_ends": {
            "type": [
              "string",
              "null"
            ]
          },
          "qualification": {
            "type": [
              "string",
              "null"
            ]
          },
          "features": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "extras": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "deal_url": {
            "type": "string"
          }
        },
        "required": [
          "product_id",
          "provider",
          "name",
          "title",
          "technology",
          "average_download_mbps",
          "estimated_speed",
          "data_allowance_gb",
          "speed_class",
          "monthly_cost_gbp",
          "monthly_cost_after_contract_gbp",
          "setup_cost_gbp",
          "initial_cost_gbp",
          "initial_period_months",
          "contract_length_months",
          "effective_monthly_cost_gbp",
          "first_year_cost_gbp",
          "total_contract_cost_gbp",
          "cost_basis",
          "pricing_summary",
          "offer_ends",
          "qualification",
          "features",
          "extras"
        ],
        "additionalProperties": false
      }
    },
    "view_more_url": {
      "type": "string",
      "description": "fibrecompare.com results page for this address, listing every available deal."
    },
    "visitor_id": {
      "type": "string",
      "description": "Pass back as visitor_id on later calls in this conversation."
    }
  },
  "required": [
    "postcode",
    "address_level",
    "total_deals",
    "returned_deals",
    "deals",
    "view_more_url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Compatibility tool for clients that require search/fetch (e.g. ChatGPT deep research). Prefer check_fibre_availability. Searches fibrecompare.com for broadband deals available at a UK postcode contained in the query; returns deal ids for fetch.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text query containing a UK postcode, e.g. 'fibre deals at SW1A 1AA' or 'Hyperoptic EC2A 1AA'."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "results"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Compatibility tool paired with search. Retrieves the full details of one broadband deal returned by search, by its id.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "A deal id returned by search (format '<postcode>|<product_id>')."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "text": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "metadata": {
      "type": "object",
      "additionalProperties": {}
    }
  },
  "required": [
    "id",
    "title",
    "text",
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}