The Mine Works — Data API Examples

Runnable Python examples for The Mine Works Apify actors — a portfolio of pay-per-result data APIs built on official, open government, finance, and research sources. No anti-bot fragility, no monthly rental, and your first 25 results are free on every actor.

Built for AI agents too. Every actor runs as an MCP tool inside Claude, ChatGPT, and any MCP-compatible agent — so you can give your agent live SEC filings, federal spending, clinical trials, or trade data with one call.

Apify profile: apify.com/themineworks · Site: themineworks.com

---

What's here

Actor	What it does	Source	Example
SEC EDGAR Filings	10-K/10-Q/8-K + XBRL financials + RAG-ready text	data.sec.gov	sec_edgar.py
USAspending Federal Awards	US contracts, grants, loans by agency/NAICS/recipient	usaspending.gov	usaspending.py
ClinicalTrials.gov	Trials by condition, drug, sponsor, phase, site	clinicaltrials.gov	clinicaltrials.py
Global Trade Data	Bilateral imports/exports by country + product	World Bank WITS	global_trade.py
Socrata Open Data	Any US gov portal (CDC, HHS, NY, NYC…)	Socrata	socrata.py
India Government Data	Any data.gov.in dataset (trade, prices, census…)	data.gov.in	india_data_gov.py
EU VAT Validator (VIES)	Bulk-validate EU VAT numbers → company name/address	EU VIES	vies.py
GLEIF LEI Lookup	Legal Entity Identifiers + company legal data	GLEIF	gleif.py

Plus: Federal Register (US rules/notices), FDA Recalls (drug/device/food), OpenAlex (250M research papers), RAG Crawler (web → chunked markdown), Reddit, Threads, ATS Jobs.

---

Quickstart

pip install -r requirements.txt
export APIFY_TOKEN=...   # from console.apify.com/account/integrations
python sec_edgar/sec_edgar.py

Every example follows the same shape:

from apify_client import ApifyClient
import os

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("themineworks/<actor-name>").call(run_input={ ... })
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

---

Why pay-per-result

• First 25 results free on every actor — no card, no trial clock.
• Zero charge on failure — an empty search or unknown input costs you nothing.
• No monthly rental — you pay only for results delivered.
• Official sources — these hit governments' and registries' own APIs, so they're reliable and legitimate (not scrapers fighting anti-bot walls).

Use with an AI agent (MCP)

Because these run on Apify, they're available as MCP tools. Point your Claude/ChatGPT agent at the Apify MCP server and it can call, e.g., themineworks/sec-edgar-filings to pull a company's latest 10-K mid-conversation. See Apify's MCP docs.

---

Issues and example requests welcome — open an issue.