Energy
Mercury NZ logo

Mercury NZ API

mercury.co.nz

Mercury NZ public electricity, gas and broadband pricing

Actions
4
Category
Energy
Login
Not required
Output
JSON

Call the Mercury NZ API

Submit a task, then poll the job until it settles. This example runs act_mercury_co_nz_list_business_plans.

curl -X POST https://api.anakin.io/v1/wire/task \
  -H "X-API-Key: $ANAKIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action_id": "act_mercury_co_nz_list_business_plans",
    "params": {}
  }'

4 actions on mercury.co.nz

Read

  • List business plans

    act_mercury_co_nz_list_business_plansread1 credit / call

    Public small-to-medium business electricity plan types (Flat Rates, Flex Rates) and related documents.

  • List price change notices

    act_mercury_co_nz_list_price_change_noticesread1 credit / call

    Published Mercury electricity price-change notice with summary, sections, and related URLs.

    path
    string
  • List pricing documents

    act_mercury_co_nz_list_pricing_documentsread1 credit / call

    Residential pricing, rates and terms documents with download URLs.

  • Plans and prices by address

    act_mercury_co_nz_plans_prices_by_addressread1 credit / call

    Electricity plan name, daily fixed charge, per-kWh rates, and low/standard user pricing for a New Zealand address.

    address
    string · required
    offer_id
    string

Mercury NZ API questions

Is there an API for Mercury NZ?
Mercury NZ does not offer a public data API for this, but Anakin Wire provides 4 maintained endpoints for mercury.co.nz. You call Anakin's REST API with an action ID and parameters and get structured JSON back; Anakin handles the browser, proxies, anti-bot, and parsing.
How do I scrape Mercury NZ data?
POST to https://api.anakin.io/v1/wire/task with your API key, the action ID, and its parameters, then poll GET /v1/wire/jobs/{id} until the job settles. There is nothing to install and no scraper to maintain — when mercury.co.nz changes its markup, Anakin updates the action.
Do I need a Mercury NZ account?
No. Every Mercury NZ action listed here runs anonymously — no account and no credentials required.
What does the Mercury NZ API cost?
Usage-based credits, charged per call and refunded automatically when a job fails. New accounts start with 300 free credits and no card. See anakin.io/pricing for the current rates.

More Energy APIs

All Energy sites