Documentation
Open data
Six reference-grade sources, all 1¢ flat: the Internet Archive’s Wayback Machine, Wikipedia + Wikidata, USPTO patents, the GDELT global news firehose, the OpenAlex scholarly graph, and the US Federal Register. These are primary or canonical sources. Prefer them over web search when the question is historical, encyclopedic, patent-, regulation-, or registry-shaped, and cite them over aggregators when they conflict. A set of MPP merchants adds normalized datasets on top: vehicles, drugs, clinical trials, product recalls, flights, sneaker markets, and paid Substack posts.
When to use which
| Need | Call |
|---|---|
| What a page said at some date; deleted pages; dead links | wayback/snapshots → wayback/fetch |
| A full encyclopedia article as clean text | wikipedia/search → wikipedia/page |
| Disambiguate an entity; structured facts + cross-registry ids | wikidata/search → wikidata/entity |
| Set-shaped answers (“all X founded after Y in Z”) | wikidata/sparql |
| Patent portfolios, prior-art scans | uspto/patents · uspto/assignees |
| Non-US/non-English press; coverage shape over time | gdelt/news · gdelt/timeline |
| Most-cited papers, author profiles, citation graph | openalex/works · openalex/work · openalex/authors |
| US proposed + final rules, comment periods | fedreg/search · fedreg/document |
| Normalized vehicles, drugs, trials, recalls | apex-db · rxatlas · trialbase-db · recallradar (search → get) |
| Real-time flight status, airport boards | aviationstack/flights · aviationstack/timetable |
| Sneaker and streetwear market data | kicksdb/product-search · kicksdb/sales-history |
| One paid Substack post, summarized | dripstack/post |
wayback: the internet’s history
- Price
- 1¢ per action
- Source
- Internet Archive
wayback/snapshots: list archived captures of aurl; optionalfrom/totimestamp prefixes (like2023) andlimit. Returns rows with timestamps to feed to fetch.wayback/available: the closest single snapshot to atimestamp(YYYYMMDD). The quick rung.wayback/fetch: the archived page itself ({ url, timestamp }), original bytes without archive chrome.
curl -X POST https://vaaya.ai/api/run/wayback/fetch \
-H "Authorization: Bearer $VAAYA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/pricing", "timestamp": "20240101"}'Use for: what a pricing/docs/landing page said at some date, deleted posts, dead links from old citations, product pivots over time. Compare two snapshots of the same URL to diff messaging. Timestamps are UTC YYYYMMDDhhmmss prefixes.
wikipedia + wikidata: canonical facts & entity resolution
- Price
- 1¢ per action
wikipedia/search(q, optionallang) → titles;wikipedia/page(title) → the full article as clean plain text, cheaper than scraping.wikidata/search(q) → Q-ids. Start here to disambiguate any entity before fanning out to other sources.wikidata/entity(id, e.g.Q95) → all structured claims: founding date, HQ, subsidiaries, execs, and cross-registry identifiers (LEI, tickers, Crunchbase, ROR).wikidata/sparql(query) → set-shaped answers no search engine can do. Keep queriesLIMITed; the upstream timeout is 60s, so small queries only.
uspto: US patents
- Price
- 1¢ per action
- Coverage
- applications + grant metadata, newest-first
uspto/patents:qis a plain full-text string ("machine learning") or field-qualified (applicationMetaData.inventionTitle:"neural network"). Optionaldate_gte/date_lte(effective-filing-date window),limit(≤100),offset.uspto/assignees: passorganization; returns that applicant’s filings. The “does X hold patents” lookup before a patents sweep.
Use for patent portfolios in company research, prior-art scans, and who’s patenting in a space. EU trademarks are a different register: /x402/eu-trademark-search (75¢) on Compliance & KYB.
gdelt: global news firehose
- Price
- 1¢ per action
- Coverage
- 65 languages, ~15-min latency
gdelt/news: search worldwide press.querysupports inline operators:sourcecountry:chile,sourcelang:spanish,domain:reuters.com,"exact phrase". Window viatimespan(1d,2w,3m) orstartdatetime/enddatetime(YYYYMMDDhhmmss).maxrecords≤250.gdelt/timeline: coverage-volume or tone series (mode: timelinevol | timelinetone) for narrative tracking and event detection.
curl -X POST https://vaaya.ai/api/run/gdelt/news \
-H "Authorization: Bearer $VAAYA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "lithium sourcecountry:chile", "timespan": "2w", "maxrecords": 50}'Use GDELT when the story is non-US/non-English or you need press-coverage shape over time. For mainstream recent headlines, brave/news is still the first rung; see Web search.
openalex: the scholarly graph
- Price
- 1¢ per action
- Coverage
- 250M+ works
openalex/works:searchand/orfilter(from_publication_date:2024-01-01,is_oa:true,cited_by_count:>100),per_page≤50. Metadata + abstracts + citation counts + OA links.openalex/work: one work byW…id or DOI: authorships, per-year citations, referenced/related works.openalex/authors: disambiguated researcher profiles (h-index, affiliations) for expert-finding and founder/team technical due diligence.
OpenAlex adds the citation graph and filters on top of quick keyword paper lookups. Use it when you need “most-cited since X”, author-centric views, or open-access full-text links. For managed multi-step research runs, see Research.
fedreg: US Federal Register
- Price
- 1¢ per action
- Coverage
- proposed + final rules since 1994
fedreg/search:term+ optionaltype(RULE | PRORULE | NOTICE | PRESDOCU),agencyslug (e.g.securities-and-exchange-commission),date_gte/date_lte,per_page.fedreg/document: full metadata by document number: abstract, docket ids, CFR refs, comment deadlines, full-text links.
Use for upstream regulatory signal (rules while still PRORULE), comment-period tracking, and what an agency has done about X. Pairs with the edgar/* actions on Public records for what companies filed in response. EU-side equivalents (eu-regulation-search, eu-ai-act-classify) live on Compliance & KYB. fedreg tracks rulemaking; for the current CFR text, use GovLaws on Public records.
Normalized data merchants
Four merchants publish normalized datasets behind one shape: search (10¢) takes query params and returns matching records, then get (2.5¢) fetches one record by id from a prior search. Every service in this section and the three below is an MPP merchant: no API key, you pay the merchant’s actual charge per call, and the listed prices are caps.
| Service | Data | Search params |
|---|---|---|
apex-db | Vehicle variants: specs, emissions, recalls, source-linked | make, model, year, q |
rxatlas | US drug products from FDA, DailyMed, and RxNorm | q (name or ingredient), ndc |
trialbase-db | Clinical trials from ClinicalTrials.gov, CTIS, and EudraCT | q (condition or intervention), status, phase |
recallradar | Consumer-product safety notices from six public authorities | q (product or brand) |
curl -X POST https://vaaya.ai/api/run/rxatlas/search \
-H "Authorization: Bearer $VAAYA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q": "semaglutide"}'aviationstack: flight status
- Price
- ~0.5¢ per action
aviationstack/flights: real-time flight status. Query params includeflight_iata(likeAA100),dep_iata,arr_iata, andairline_iata.aviationstack/timetable: an airport’s departure or arrival board. Params:iataCode(airport) andtype(departureorarrival).
kicksdb: sneaker and streetwear markets
- Price
- ~0.05¢ per action
kicksdb/product-search: search products on one marketplace. Params:marketplace(stockx,goat,shopify,snkrs,kream,novelship) andquery.kicksdb/product-detail: one product bymarketplace+id. Supports stockx, goat, shopify, kream.kicksdb/sales-history: sales history for a product bymarketplace+id. Supports stockx and goat.
dripstack: paid Substack content
- Price
- $0.05 to $1 per post, set by the publisher
dripstack/post buys the synthesized summary of one Substack post. Params: publication (a publication slug like chipstrat.com) and post (the post slug). Posts priced above $1 are refused.