The factual-api package

[ Tags: api, bsd3, library, web ] [ Propose Tags ]

This is a driver for the Factual API. It provides a type-safe, easy way to generate queries, setup OAuth authentication and send queries to the API.

[Skip to Readme]


Versions 0.1.0, 0.1.1, 0.1.2, 0.2.0, 0.3.0, 0.3.1, 0.3.2, 0.3.3, 0.4.0, 0.5.0, 0.5.1, 0.5.2, 0.6.0, 0.6.1
Dependencies aeson (>=, attoparsec (>=, base (==4.*), bytestring, containers, hoauth (>=0.3.5), HTTP, MissingH (>=1.0.0), text (>=, unordered-containers (>=, vector (>=0.9.1) [details]
License BSD3
Copyright (c) 2012 Rudiger Lippert
Author Rudiger Lippert <>
Maintainer Rudiger Lippert <>
Category API, Web
Home page
Bug tracker
Source repo head: git clone git://
Uploaded Thu Aug 30 18:51:34 UTC 2012 by RudigerLippert
Distributions NixOS:0.6.1
Downloads 4834 total (72 in the last 30 days)
Rating (no votes yet) [estimated by rule of succession]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
All reported builds failed as of 2016-12-24 [all 7 reports]
Hackage Matrix CI


  • Data
    • Factual
      • Data.Factual.Query
        • Data.Factual.Query.DiffsQuery
        • Data.Factual.Query.FacetsQuery
        • Data.Factual.Query.GeocodeQuery
        • Data.Factual.Query.GeopulseQuery
        • Data.Factual.Query.MatchQuery
        • Data.Factual.Query.ReadQuery
        • Data.Factual.Query.ResolveQuery
        • Data.Factual.Query.SchemaQuery
      • Data.Factual.Response
      • Shared
        • Data.Factual.Shared.Filter
        • Data.Factual.Shared.Geo
        • Data.Factual.Shared.Search
        • Data.Factual.Shared.SortOrder
        • Data.Factual.Shared.Table
      • Data.Factual.Write
        • Data.Factual.Write.Flag
        • Data.Factual.Write.Insert
        • Data.Factual.Write.Submit
  • Network
    • Factual
      • Network.Factual.API


Maintainer's Corner

For package maintainers and hackage trustees

Readme for factual-api-0.5.1

[back to package description]


This is a Haskell driver for Factual's public API.


  • Read Queries
    • Places US
    • Restaurants US
    • Hotels US
    • Global Places
    • Crosswalk
    • Healthcare Providers
    • World Geographies
    • Products CPG
    • Products Crosswalk
    • Monetize
    • Custom Tables
  • Facets Queries
  • Geocode Queries
  • Geopulse Queries
  • Resolve Queries
  • Match Queries
  • Schema Queries
  • Diffs Queries
  • Multi Queries
  • Raw Read Queries
  • Parametric Search
  • Geo Filters
  • Query Debugging



This driver targets ghc 7.4.1 and The Haskell Platform 2012.2.0.0. Please follow the installation instructions for your specific platform to install ghc and The Haskell Platform.

You'll need a Factual account to use this driver. If you don't have one yet, it's free and easy to get one.

Installation from cabal

$ cabal install factual-api

Installation from git

$ git clone
$ cabal install hoauth
$ cabal install aeson
$ cabal install MissingH


Load the tests file into ghci to run the tests:

$ ghci test/Tests.hs

To run the integration tests you'll need an API key and secret, but you can always run the unit tests:

*Main> runUnitTests
Cases: 53  Tried: 53  Errors: 0  Failures: 0
Counts {cases = 53, tried = 53, errors = 0, failures = 0}
*Main> runIntegrationTests "mykey" "mysecret"
Cases: 11  Tried: 11  Errors: 0  Failures: 0
Counts {cases = 11, tried = 11, errors = 0, failures = 0}


You can read library documentation by visiting the Hackage page.

The github wiki also provides thorough documentation and examples for each feature.


See the examples directory for examples of each query type. To run an example go to the project root and execute these commands:

$ ghc -o example examples/ReadExample.hs --make
$ ./example mykey mysecret

In this example replace mykey with your key and mysecret with your secret. Note that compiling the source code generates .o and .hi files in the source directories.



Although there is code in the current version to support API writes, these features have not yet been implemented in the Factual API. Please refrain from attempting to use these features until they have been officially announced.

Crosswalk deprecation

The Crosswalk API endpoint has been migrated into a regular read table. For more information see the Factual V3 documentation.