EMMA Municipal Bonds Scraper

Scrape municipal bond securities from EMMA (Electronic Municipal Market Access) — the official SEC-designated disclosure platform for the US municipal securities market, operated by the Municipal Securities Rulemaking Board (MSRB).

What It Does

This actor navigates emma.msrb.org — the authoritative, freely accessible repository of US municipal bond data. For each bond security it extracts:

• Issuer Name — name of the municipal bond issuer (city, county, state agency, utility district, etc.)
• Security Description — series name and bond type (e.g. "SR-MEASURE BB", "GO BONDS SERIES A")
• State — full state name and two-letter state code
• Principal Amount — total face value of the bond offering (e.g. $4,785,000)
• Coupon Rate — annual interest rate paid to bondholders (e.g. 5%)
• Maturity Date — date when the bond principal is repaid (MM/DD/YYYY)
• Dated Date — date from which interest begins to accrue (MM/DD/YYYY)
• Offering Price — initial price as a percentage of par value (e.g. 102.167%)
• Offering Yield — yield to maturity at the offering price (e.g. 1.53%)
• Credit Ratings — whether Fitch, Moody's, S&P Global, and KBRA ratings exist for the bond
• Security URL — direct EMMA page link for full prospectus and disclosure documents

Use Cases

• Fixed-income research — build structured databases of municipal bond offerings by state, issuer, or yield
• Credit analysis tools — identify rated vs. unrated bonds and cross-reference rating agencies
• Investment screening — filter bonds by state, maturity horizon, coupon level, or principal size
• Public finance analytics — track municipal borrowing activity by jurisdiction over time
• Compliance and due-diligence — verify offering details against EMMA's official disclosure records

Before You Start — You Must Accept MSRB's Terms Yourself

EMMA serves data only to visitors who have accepted MSRB's Terms of Use. This Actor does not accept those Terms on your behalf — it never submits MSRB's disclaimer form. You accept them personally, in your own browser, and supply the resulting cookie:

1. Open emma.msrb.org in your browser.
2. Read MSRB's Terms of Use. If — and only if — you agree to them, accept the disclaimer.
3. Open DevTools → Application → Cookies → https://emma.msrb.org, and copy the value of the Disclaimer6 cookie.
4. Paste that value into the disclaimerCookie input field.

The cookie is valid for about a year, so this is a one-time step per browser.

You are responsible for your own use of EMMA under the Terms you accept, including any restrictions they place on automated access. If you do not agree to MSRB's Terms, do not use this Actor — consider MSRB's licensed data products instead.

Input

Field	Type	Default	Description
disclaimerCookie	string	—	Required. The value of your own Disclaimer6 cookie — see above.
states	array of strings	["CA"]	Two-letter US state/territory codes to scrape (e.g. ["CA", "NY", "TX"]). Accepts all 50 states plus DC, GU, PR, VI.
maxItems	integer	100	Maximum number of bond records to return. Set to 10 for a quick test. No upper limit — set it high to pull an entire state.

Pulling a whole state. There is no cap on maxItems, but the crawl is deliberately paced to stay light on EMMA, so large pulls take a long time. California alone is on the order of a million securities and will run for many hours; the Actor's timeout allows for it.

Output

Each item in the dataset contains:

{
  "issuerName": "ALAMEDA COUNTY TRANSPORTATION COMMISSION",
  "securityDescription": "SR-MEASURE BB",
  "stateName": "California",
  "stateCode": "CA",
  "principalAmount": "$4,785,000",
  "couponRate": "5%",
  "maturityDate": "03/01/2023",
  "datedDate": "07/14/2022",
  "offeringPrice": "102.167%",
  "offeringYield": "1.53%",
  "fitchRating": "",
  "moodysRating": "",
  "spRating": "",
  "kbraRating": "",
  "securityUrl": "https://emma.msrb.org/Security/Details/A60477195F2E8C188281BB5745B77C8EE",
  "scrapedAt": "2026-06-05T14:55:54.680Z"
}

Rating fields contain "rated" if a rating from that agency exists for the bond, or an empty string if unrated. MSRB renders the actual rating values as images for licensing reasons — the presence/absence signal is available from the data.

About EMMA

EMMA is operated by the Municipal Securities Rulemaking Board (MSRB) under SEC designation as the official disclosure repository for US municipal securities. All data is sourced directly from official MSRB disclosures.

No account, subscription or payment is required to view EMMA — but access is conditioned on accepting MSRB's Terms of Use, which you do yourself (see above). This Actor also emits no CUSIP numbers and no credit-rating values: MSRB renders both as images for licensing reasons, so the output carries only a rating presence/absence signal and an opaque MSRB URL slug.

---

For issues or feature requests, contact actor-support@orbtop.com