# Search Texas Bill Atlas

`GET https://agent.billatlas.org/search?q=<words>` returns matching bills as Markdown; add `&format=json` for JSON.

- Words match their forms (firearm, firearms; school, schools). Quote a phrase: `q="water rights"`.
- Common synonyms find each other: gun, firearm, handgun, rifle and weapon return the same bills; voucher, "school
  choice" and "education savings account" do too; aquifer and groundwater; marijuana, cannabis, THC and hemp.
- Every word must match. OR separates alternatives, each matched on its own: `q=lottery OR casino OR sports betting`
  finds bills about lotteries, casinos, or sports betting (both words); `q=school safety OR "school police"` works
  too. To keep a word in every alternative, repeat it: `q=property tax senior OR property tax elderly`. The results
  page shows how the query was read. If no bill matches every word of a query without OR, the bills matching the
  most words are shown, with a count for each word on its own, and the page says which words matched nothing.
- Misspelled member names get a "did you mean" (`q=jonson` suggests Ann Johnson). A name with no bills says so.
- Bill numbers work: `q=HB 5` or `q=sb12`.
- Filters (with or without q): `chamber=House|Senate`, `topic=<topic name, or part of one>`, `agency=<id, or words of its name>`,
  `location=<part of a place name, e.g. Harris>`, `party=democratic|republican|bipartisan`, `reviewed=yes|no`,
  `filed_from=YYYY-MM-DD`, `filed_to=YYYY-MM-DD`. A location matches a place the full-text review names, or the place
  named in the title or caption; unreviewed bills that affect a place without naming it are not found.
- Bills filed in the last few days: `filed_from=<date>` with no q (all of them, most recent action first).
- Paging: `limit` (default 50, at most 200) and `offset`.
- Tracker links: the tracker's explorer keeps its filters in the address. `https://billatlas.org/explorer?topic=Education&agency=tea`
  is the same view as `https://agent.billatlas.org/search?topic=Education&agency=tea`; the topic, agency and chamber values carry over.
  `query=` becomes `q=`.

Topic names (exact values; anything else matches part of a name): `Agriculture`, `Business regulation`, `Civil rights`, `Criminal justice`, `Data centers`, `Economic development`, `Education`, `Elections`, `Energy & utilities`, `Environment & water`, `Government operations`, `Healthcare`, `Housing & property`, `Immigration`, `Labor & workforce`, `Local government`, `Medicaid`, `Parks & conservation`, `Public safety`, `School choice`, `State spending`, `Taxes`, `Technology & privacy`, `Transportation`.

Searched: titles and captions, topics, agencies, Luna full-text summaries and search terms, member names, affected groups, locations,
impacts and recorded actions. Only 1722 bills have a full-text review so far; for
the rest only the caption and caption-based tags are searchable.

Examples: [https://agent.billatlas.org/search?q=groundwater](https://agent.billatlas.org/search?q=groundwater) ·
[https://agent.billatlas.org/search?q=gun](https://agent.billatlas.org/search?q=gun) ·
[https://agent.billatlas.org/search?q=data+center&agency=puc](https://agent.billatlas.org/search?q=data+center&agency=puc) ·
[https://agent.billatlas.org/search?filed_from=2026-11-10](https://agent.billatlas.org/search?filed_from=2026-11-10)
