Skip to main content

AskAmerica

Query 17 US government datasets — SEC filings, FEC campaign finance, Census, weather, energy, crime, and more — with a single line of Python.

Install

pip install 'askamerica[engine]'
askamerica login            # get your free API key

The query engine JAR (~80 MB) is downloaded automatically on first use. To pre-download it explicitly (useful for CI or Docker):

askamerica install-engine   # optional — runs automatically on first query otherwise

Set your API key as an environment variable (or let askamerica login store it):

export ASKAMERICA_API_KEY=aa_free_...

Query

One-liner — returns a pandas DataFrame:

import askamerica as aa

df = aa.query("SELECT company_name, value_dollars FROM sec.financial_facts WHERE canonical_name = 'Revenue' ORDER BY value_dollars DESC FETCH FIRST 10 ROWS ONLY")
print(df)

Raw JDBC connection:

import askamerica as aa

conn = aa.connect()
stmt = conn.createStatement()
rs = stmt.executeQuery("SELECT cik, company_name FROM sec.filing_metadata ORDER BY filing_date DESC FETCH FIRST 5 ROWS ONLY")
while rs.next():
    print(rs.getString("company_name"))
conn.close()

Claude Desktop (MCP)

pip install 'askamerica[mcp]'
askamerica install-engine
askamerica mcp-config       # writes Claude Desktop config snippet

Sign up for a free API key at askamerica.ai.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

askamerica-0.43.0.tar.gz (16.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

askamerica-0.43.0-py3-none-any.whl (21.8 kB view details)

Uploaded Python 3

File details

Details for the file askamerica-0.43.0.tar.gz.

File metadata

  • Download URL: askamerica-0.43.0.tar.gz
  • Upload date:
  • Size: 16.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for askamerica-0.43.0.tar.gz
Algorithm Hash digest
SHA256 8373efc74b17b8f99d9e7cefac15ec4f8bdc58b773f804def1b9cbb3264526ef
MD5 a7dad3b26b20be4c214010aa8cca84a4
BLAKE2b-256 ddcce64243e2e2ff4abe4b8ecaa8fddd917526e24a50882b4c8a498d2a3c4523

See more details on using hashes here.

Provenance

The following attestation bundles were made for askamerica-0.43.0.tar.gz:

Publisher: askamerica-engine.yml on kenstott/calcite

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file askamerica-0.43.0-py3-none-any.whl.

File metadata

  • Download URL: askamerica-0.43.0-py3-none-any.whl
  • Upload date:
  • Size: 21.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for askamerica-0.43.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d2d8f0a4e0a486871c357023b95f4d68ad0b2d36cc0bb8d71d4a686d420cd2f2
MD5 1b331b01dc240c3eed3a9c5d2759fe7b
BLAKE2b-256 ec3b4af4f325596de9326992b123ede31a08922e78c5a0fb0294a0355eb8e6eb

See more details on using hashes here.

Provenance

The following attestation bundles were made for askamerica-0.43.0-py3-none-any.whl:

Publisher: askamerica-engine.yml on kenstott/calcite

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page