The aeson package

[Tags: bsd3, library]

A JSON parsing and encoding library optimized for ease of use and high performance.

To get started, see the documentation for the Data.Aeson module below.

Parsing performance on an early 2011 MacBook Pro (2.2GHz Core i7), running 64-bit GHC 7.6.3, for mostly-English tweets from Twitter's JSON search API:

Handling heavily-escaped text is a little more work. Here is parsing performance with Japanese tweets, where much of the text is entirely Unicode-escaped.

Encoding performance on the same machine and data:

(A note on naming: in Greek mythology, Aeson was the father of Jason.)

[Skip to ReadMe]


Versions0.1.0.0,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,, (info)
Change logchangelog
Dependenciesattoparsec (>=, base (==4.*), blaze-builder (>=, bytestring, containers, deepseq, dlist (>=0.2), ghc-prim (>=0.2), hashable (>=, mtl, old-locale, scientific (==0.2.*), syb, template-haskell (>=2.4), text (>=, time (<1.5), unordered-containers (>=, vector (>=0.7.1) [details]
Copyright(c) 2011-2014 Bryan O'Sullivan (c) 2011 MailRank, Inc.
AuthorBryan O'Sullivan <>
MaintainerBryan O'Sullivan <>
CategoryText, Web, JSON
Home page
Bug tracker
Source repositoryhead: git clone git://
head: hg clone
UploadedWed May 14 04:20:20 UTC 2014 by BryanOSullivan
UpdatedSat Apr 11 14:06:41 UTC 2015 by AdamBergmark to revision 1
DistributionsDebian:, Fedora:, FreeBSD:, LTSHaskell:, NixOS:, Stackage:
Downloads228246 total (327 in last 30 days)
8 []
StatusDocs available [build log]
Successful builds reported [all 1 reports]




developeroperate in developer modeDisabledAutomatic
blaze-builderUse blaze-builder instead of bytestring >= 0.10DisabledAutomatic
new-bytestring-builderUse the new bytestring builder available in bytestring >=

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info


Maintainers' corner

For package maintainers and hackage trustees

Readme for aeson-

Welcome to aeson

aeson is a fast Haskell library for working with JSON data.

Join in!

We are happy to receive bug reports, fixes, documentation enhancements, and other improvements.

Please report bugs via the github issue tracker.

Master git repository:

There's also a Mercurial mirror:

(You can create and contribute changes using either git or Mercurial.)


This library is written and maintained by Bryan O'Sullivan,