> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poddata.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# The sources PodData reads

> Every source PodData reads in production, by category: what it reads, what it holds, how often, and the id to ask for it by.

For a diligence, PodData reads public sources about a company through the links a person on your team has confirmed: its domain, its places, its listings and accounts, its numbers at registries. Three kinds of thing come back, each with its own day and its page on the source's site:

| Kind | What it is | Route | MCP tool |
| - | - | - | - |
| Records | Registrations, licences, inspections, recalls, breaches, cases and deals | `GET /companies/{id}/records` | `company_records` |
| Signals | Reviews, ratings, listings, ads, stories, community posts and web-traffic estimates | `GET /companies/{id}/signals` | `company_signals` |
| Documents | A company's own filings, decks, releases and pages, read whole on their own route | `GET /documents` | `list_documents` |

Pass a source's id below as `source` to narrow a list to it. The [number tools](https://docs.poddata.ai/number-tools.md) count records and signals for you, beside a company's confirmed rivals.

## What's been read for a company

1. **Every source, live.** `GET /integrations` (`list_integrations`) lists each source with when it last ran and how much PodData holds from it; `GET /integrations/{id}/items` (`source_items`) lists what it holds, item by item.
2. **For one of your targets.** `GET /targets/{company}/coverage` (`target_coverage`) says, source by source, whether it has read the target and its confirmed rivals, what it holds and over which days, and which kind of link a source still waits on.
3. **As files.** A target's folder gives a CSV a source and kind: see [A target's folder](https://docs.poddata.ai/folder.md). Where a source's file is held back, `held` says why, and its rows read as JSON.

A source reads a company only through a link of the kind it needs: a review site through the company's listing there, a registry through its number. Confirming the right links is what makes a source read. Data your team reads through its own licence to a vendor is by request today.

## Every source production reads

### Company filings

| Source | Its id | What PodData reads | Holds | How often |
| - | - | - | - | - |
| A company's own website | `company-site` | The pages of a target's own site and its confirmed rivals' that say what each sells, charges and serves, where it is, who runs it and what it's hiring for: home, products, pricing, customers, about, leadership, locations, careers, news, security and terms, at most 25 pages a site, kept by day | Documents | weekly |
| Company newsrooms | `newsrooms` | Releases and posts that never reach EDGAR, from Alphabet's, Microsoft's, Salesforce's and Tesla's own newsroom feeds | Documents | every half hour |
| Slide decks | `decks` | The results decks companies file on EDGAR, and those only on their own investor sites, read slide by slide | Documents | hourly; investor sites every six hours |
| Company events | `company-events` | Earnings calls and investor days from each listed company's own event calendar and 8-Ks, with the replay it posts; a diligence target reads the quotes in them that name it, its rivals or its listed comparable | Documents | every six hours |
| SEC EDGAR filings (submissions and XBRL APIs) | `edgar` | Filings and their exhibits from the SEC, each with its form, its day, its pages and its passages | Documents | every five minutes, each company's list at least every half hour |
| OpenFIGI | `openfigi` | Each listing's FIGIs, the open identifiers Bloomberg gives every security, for the listed companies that file with the SEC | Records | hourly, 20 companies a run, each read again after a day |
| SEC EDGAR full-text search | `edgar-full-text` | Other companies' filings that name a target by a confirmed link's own value (its domain, or its legal name as its registry writes it), each as a mention: the filing, its 80 words and its page | Records | daily: three years back on a company's first run, then the last month |
| USPTO trademark filings | `uspto-trademarks` | The trademarks a confirmed owner files and each day they change: the word mark, its days, its status, its classes and its goods and services, from USPTO's daily applications files back to Jan 1, 2025 | Records | hourly, a daily file a run: the newest every fourth run, and the older days back to Jan 1, 2025 in turn, all in about 38 days |
| California attorney general data breach list | `ca-breaches` | Data breach notices filed with California's attorney general: the organisation, the days of the breach and the day it was reported, with a link to its notice | Records | daily, for what's new |
| Washington attorney general data breach notifications | `wa-breaches` | Data breach notices filed with Washington's attorney general: the entity, the days it was discovered, began, ended and was reported, how many Washingtonians, its cause and the kind of attack | Records | daily, for what's new |
| Delaware attorney general security breach notifications | `de-breaches` | Data breach notices filed with Delaware's attorney general: the organisation, the days of the breach and the day it was reported, how many Delawareans, and the notice letter | Records | daily, for what's new |
| South Carolina Department of Consumer Affairs security breach notices | `sc-breaches` | Data breach notices filed with South Carolina's Department of Consumer Affairs: the organisation, the day it was reported, how many South Carolinians, and the consumer letter | Records | daily, for what's new |
| Idaho attorney general security breach notifications | `id-breaches` | Data breach notices filed with Idaho's attorney general: the agency or company and the day it notified, with its letter | Records | daily, for what's new |
| Vermont attorney general security breach notices | `vt-breaches` | Data breach notices filed with Vermont's attorney general from April 17, 2026: the organisation, its sector, the day it was reported, how many Vermonters, and the kinds of data breached | Records | daily, for what's new |
| Iowa attorney general security breach notifications | `ia-breaches` | Data breach notices filed with Iowa's attorney general from 2011: the business, its industry, the day it was reported, and its initial and supplemental notices | Records | daily, this year's and last year's pages, and one older year a run |
| Maryland attorney general security breach notices | `md-breaches` | Data breach notices filed with Maryland's attorney general, 2022 to March 2025: the organisation, the day received, how many Marylanders, what was breached and how, and the letter | Records | weekly, every year from 2022 |
| Florida's Sunbiz corporate filings | `fl-sunbiz` | A Florida company's record and filing events from the daily files: status, kind, formation, registered agent and officers, by its document number | Records | daily |
| Florida's federal tax lien filings | `fl-federal-liens` | Federal tax liens filed in Florida against a debtor, with their filings and events | Records | daily |
| New York's active corporations (data.ny.gov) | `ny-active-corps` | A New York corporation's filing date, type, jurisdiction, process address, chief executive and registered agent | Records | monthly |
| Texas's active franchise taxpayers (data.texas.gov) | `tx-franchise-taxpayers` | Whether a Texas company is registered and may transact business, with its Secretary of State file number and status | Records | daily |
| Texas Comptroller's franchise tax API | `tx-comptroller-api` | A confirmed Texas company's registered agent and the officers on its franchise tax report | Records | weekly |
| Florida's Secured Transaction Registry | `fl-ucc` | UCC financing statements filed in Florida against a company, filed and lapsed: who holds security over its assets, the days and the events | Records | weekly |

### Health

| Source | Its id | What PodData reads | Holds | How often |
| - | - | - | - | - |
| HHS OCR breach portal | `hhs-breach-portal` | Breaches of health records affecting 500 or more people: the entity, its state, how many people, the day it was reported, the kind of breach, where the data was and, for a closed case, OCR’s summary | Records | daily: every open case, and the archive a slice a day |
| CMS NPPES NPI registry | `nppes-npi` | A clinic network's providers and locations: each organisation a person has confirmed by its NPI, and every clinician and organisation practising at its addresses, with the number, name, specialty and practice address | Records | monthly, for each confirmed organisation |
| Medicare physician and other practitioners, by provider | `medicare-utilization` | What Medicare paid each of a clinic network's providers in the latest year, and for which services, from Part B fee-for-service claims | Records | yearly: CMS posts a year in May or June |
| CMS Open Payments | `open-payments` | What drug and device makers paid a clinic network's clinicians in the latest program year, by maker and kind of payment, read by provider number | Records | yearly: CMS publishes a program year by June 30 |
| Medicare physician fee schedule rules (Federal Register) | `medicare-fee-schedule` | Each year's proposed and final Medicare physician fee schedule rule, as documents filed under CMS, in GPO's text from govinfo.gov: the conversion factor and what each service is worth, with each passage's printed Federal Register page | Documents | weekly: the last year’s rules, and one earlier year of five in turn |

### Food and product safety

| Source | Its id | What PodData reads | Holds | How often |
| - | - | - | - | - |
| openFDA enforcement reports (food, drugs, devices) | `openfda-enforcement` | Every recall of food, drugs and devices the FDA has classed, 2004 on: the firm and its city, the product, the class, the reason, the states it shipped to and its days | Records | daily: the last two weeks’ reports, and one month of five years in turn |
| FDA warning letters | `fda-warning-letters` | Every warning letter the FDA posts: the firm, the issuing office, the subject, the days it was issued and posted, and whether a response or close-out letter followed; the letters themselves as documents once a link can tie them | Records, Documents | daily: the newest letters, and an older page in turn |
| NHTSA recalls | `nhtsa-recalls` | Every safety recall of vehicles, equipment, tyres and car seats NHTSA has received, 1966 on: the maker, the component, how many units, the defect, the consequence and the remedy | Records | daily: the last thirty days, and one month of five years in turn |
| CDC foodborne outbreak data (NORS) | `cdc-outbreaks` | Foodborne outbreaks health departments reported to CDC, by state and year: each one’s month, cause, setting, illnesses, hospitalisations, deaths and the food blamed | Records | monthly: CDC publishes a year at a time |
| EPA WaterSense products and partners | `epa-watersense` | The irrigation products that carry EPA's WaterSense label (weather-based irrigation controllers, spray sprinkler bodies and soil moisture-based controllers), and the program's partners with their type and the states and areas they serve | Records | weekly: every product of the three irrigation categories and every partner |
| CPSC recalls | `cpsc-recalls` | Consumer product recalls naming a firm as maker, importer, distributor or retailer: the hazard, the units and the remedy | Records | daily |
| EPA's enforcement and compliance data (ECHO) | `epa-echo` | A facility's permits and compliance in EPA's and the states' programs, its inspections, actions and penalties, and its federal enforcement cases with their alleged violations, by its FRS registry ID | Records | weekly |
| FMCSA's motor carrier census, inspections and crashes | `fmcsa-carriers` | A carrier's fleet, operating authority, roadside inspections, out-of-service orders and crashes, by its USDOT number | Records | daily |

### Labour and building

| Source | Its id | What PodData reads | Holds | How often |
| - | - | - | - | - |
| DOL H-2B disclosure files | `dol-h2b` | Every H-2B case DOL decided in the last three fiscal years: the employer's name, city, state and NAICS code, the job, the workers asked for and certified, the worksite, the wage and DOL's decision | Records | daily, two slices of 2,000 cases in turn, from the files the Mac converts when DOL posts a quarter |
| Census Bureau building permits survey | `census-building-permits` | New private housing units authorised each month in every county: buildings, units and value, and units by building size, from the county files | Records | daily: the newest month, and one of the last five years in turn |
| Bureau of Labor Statistics (QCEW) | `bls` | An industry's establishments, jobs and wages in every county each quarter, private employers only, from the Quarterly Census of Employment and Wages; occupational wages (OEWS) aren't read yet | Records | weekly: the newest quarter, and one of the five years before it in turn |
| California Contractors State License Board | `ca-cslb` | A contractor's California licence: its status in the board's words, classifications, contractor's bond, workers' compensation and any complaint disclosure | Records | weekly |
| Nevada State Contractors Board | `nv-contractors-board` | A contractor's Nevada licence: its status and the day it took it, classifications, limitation, monetary limit, bonds and any discipline the page shows | Records | weekly |
| OSHA inspections, violations and penalties | `osha-inspections` | A workplace's OSHA inspections, its violations with their seriousness, and the penalties | Records | weekly |
| NLRB unfair labour practice and representation cases | `nlrb-cases` | Charges against an employer, union petitions and elections, each case with its allegations and how it ended | Records | daily |
| California's water shortage levels by utility (State Water Board) | `ca-water-shortage-levels` | Each California urban water supplier's shortage level and irrigation demand, month by month | Records | monthly |
| Utilities' own watering-rule pages | `utility-watering-rules` | The watering days, hours and limits a utility sets, from its own page: Los Angeles, Denver and the Las Vegas Valley | Records | weekly |

### Telecom

| Source | Its id | What PodData reads | Holds | How often |
| - | - | - | - | - |
| FCC National Broadband Map | `fcc-broadband-map` | The locations a provider tells the FCC it serves, in each state and county, by technology, in the two latest collections, and the change between them: the provider's own claim | Records | weekly, for each provider with a confirmed FCC provider id; a new collection comes twice a year, and the FCC re-releases files between |
| BEAD subgrantee awards | `bead-awards` | BEAD awards from each state's own copy of NTIA's final-proposal files: the provider, its UEI, the locations it must reach by technology, and the BEAD dollars and match. Texas, California and Virginia so far | Records | daily, one state in turn, so each state is read every three days |

### Gaming

| Source | Its id | What PodData reads | Holds | How often |
| - | - | - | - | - |
| Illinois Gaming Board monthly casino and video-gaming reports | `igb-reports` | Each Illinois casino's monthly admissions, adjusted gross receipts from tables and machines, and the state's and the town's shares of tax, from July 2020 | Records | daily, for a month's report when the board posts it |
| Illinois Gaming Board meeting minutes | `igb-minutes` | The Illinois Gaming Board's minutes and agendas of its open meetings, as documents filed under the board, from November 2024: a licence's renewal, a casino's deadline, a change of owner, a fine | Documents | weekly, for minutes the board has posted since |
| New Jersey DGE casino financial reports | `nj-dge-financials` | Each New Jersey casino's quarterly report to the Division of Gaming Enforcement, as a document, and its statement of income for the quarter as figures linked to their page: net revenue, gross operating profit, income from operations, net income | Documents, Records | weekly |
| Pennsylvania Gaming Control Board monthly revenue | `pa-pgcb-revenue` | Each Pennsylvania casino's monthly figures for slots, table games and online play, as the board's workbooks give them: wagers, payouts, gross revenue, taxes and counts | Records | weekly |
| Nevada Gaming Control Board monthly revenue reports | `nv-gcb-revenue` | Nevada's monthly gaming win by county, area and revenue range (the Las Vegas Strip's casinos winning \$72 million a year and over, say): each kind of game and machine's locations, units, win and win percent, the total, and the taxable revenue, from January 2024. No figures by casino | Records | daily, for a month's report when the board posts it, about four weeks after the month ends |

### News, wires and deals

| Source | Its id | What PodData reads | Holds | How often |
| - | - | - | - | - |
| Written interviews | `articles` | Written interviews with the people we follow, once the outlet is cleared, and news about the watch list's listed companies from the main US outlets, each kept from the outlet's own page | Documents | hourly |
| GDELT DOC 2.0 news API | `gdelt` | News stories that name a target or a rival, each read from its outlet's own page and kept only when its day and its company check out there | Signals | daily |
| Press-release wires (PR Newswire, Business Wire, GlobeNewswire) | `wires` | A target's and its rivals' releases on Business Wire and GlobeNewswire, found by Exa's search held to the wire and the week, each with its text, and read through Firecrawl where Exa gives no words; each dated by its dateline, tied by the domain it gives, and kept as its link, its day and at most 80 words. PR Newswire's come through the daily sweep (gdelt) | Signals, Documents | weekly |
| The weekly web pass | `web-news` | Each week, the stories about a target or a rival a research agent finds on the open web at any outlet, each page read by PodData's fetcher (Firecrawl where a site refuses it) and kept only when its day and its company check out there | Signals | weekly |
| Trade press by industry | `trade-press` | Trade stories that name a target or a rival, read from the cleared outlets of its industry: Athletech News by its terms, and the 14 conditional outlets on Rushabh's call of Nov 17, 2026, seven of them by their own feeds | Signals, Documents | daily |
| Ownership and deal facts from the parties' own pages | `deal-pages` | A target's latest change of owner, read from the buyer's, seller's, sponsor's or adviser's own announcement where its terms allow it, each fact with its link | Records, Documents | weekly |
| Crunchbase (by request: your team's own licence) | `crunchbase` | Deals and funding, on a team's own Crunchbase licence | Records | weekly |
| PitchBook (by request: your team's own licence) | `pitchbook` | Deals and funding, on a team's own PitchBook licence | Records | weekly |
| Tracxn (by request: your team's own licence) | `tracxn` | Deals and funding, on a team's own Tracxn licence | Records | weekly |

### Reviews

| Source | Its id | What PodData reads | Holds | How often |
| - | - | - | - | - |
| Google Maps reviews and listings | `google-maps` | A location's Google profile: its rating, its count and its reviews' histogram | Signals | weekly |
| Angi | `angi` | A business's Angi profile: its reviews, and Angi's own total, average and shares a star | Signals | weekly |
| Better Business Bureau | `bbb` | A business's BBB profile: its customer reviews, and BBB's own review count and average | Signals | weekly |
| Thumbtack | `thumbtack` | A pro's Thumbtack profile: its reviews, and Thumbtack's own total, average and shares a star | Signals | weekly |
| Yelp | `yelp` | A business's Yelp profile and its score on the day | Signals | weekly |
| Trustpilot | `trustpilot` | A company's Trustpilot reviews and score | Signals | weekly |
| Capterra | `capterra` | A software product's Capterra reviews and rating | Signals | weekly |
| G2 | `g2` | A software product's G2 reviews and rating | Signals | monthly |
| Gartner Peer Insights | `gartner-peer-insights` | A software product's Gartner Peer Insights reviews, and Gartner's own review count, average and count a star | Signals | weekly |

### Retail

| Source | Its id | What PodData reads | Holds | How often |
| - | - | - | - | - |
| Amazon product pages and reviews | `amazon` | A product's newest Amazon reviews, and its rating, count and share a star | Signals | weekly |
| Target product pages | `target` | A product's written reviews on Target, and Target's own rating, count and count a star | Signals | weekly |
| Walmart product pages | `walmart` | A product's newest Walmart reviews, and its rating, count and count a star | Signals | weekly |
| Keepa (Amazon rank, price and badge history) | `keepa` | An Amazon product's price, rank, rating and "bought in past month" history, two years back | Signals | weekly |

### Social

| Source | Its id | What PodData reads | Holds | How often |
| - | - | - | - | - |
| Posts on Bluesky | `posts-bluesky` | Public posts of the official accounts of the people and companies we follow, through Bluesky’s own open API | Signals | every 15 minutes |
| Posts on Mastodon | `posts-mastodon` | Public posts of the official accounts we follow on Mastodon’s servers, only where an account lets itself be found | Signals | every 15 minutes |
| Posts on X | `posts-x` | Public posts of the official X accounts of the people and companies we follow, through a vendor’s API | Signals | every 15 minutes |
| Instagram | `instagram` | A brand's own Instagram account, as its site links it and a person confirms it: its follower count and post total, and each of its own posts from the last 90 days with its day, its likes, comments and views, and at most 80 words, read weekly | Signals | weekly |
| TikTok | `tiktok` | A brand's own TikTok account, as its site links it and a person confirms it: its follower count, likes and video total, and each of its own videos from the last 90 days with its day, its views, likes, comments, shares and saves, whether TikTok marks it an ad, and at most 80 words, read weekly | Signals | weekly |
| Reddit | `reddit` | What's said about a company on Reddit: each post and comment that names one of its confirmed search terms, with its community, its day, its score and at most 80 words, and no username, read weekly | Signals | weekly |

### Ads

| Source | Its id | What PodData reads | Holds | How often |
| - | - | - | - | - |
| Meta Ad Library | `meta-ad-library` | A brand's US ads running in Meta's library, snapshot weekly: each ad's link, its start day, where it runs and its words, and the library's own count | Signals | weekly |
| Google Ads Transparency Center | `google-ads-transparency` | The ads pointing to a brand's domain in Google's Ads Transparency Center, shown in the US, snapshot weekly: each ad's link, its first day shown and its format | Signals | weekly |
| LinkedIn Ad Library | `linkedin-ad-library` | A brand's ads shown to the US in LinkedIn's Ad Library, snapshot weekly: each ad's link, its start day, its format, its impressions band and its words | Signals | weekly |

### Search interest

| Source | Its id | What PodData reads | Holds | How often |
| - | - | - | - | - |
| Google Trends | `google-trends` | Weekly search interest in a target and its rivals | Signals | monthly: five years by week, three runs averaged |
| Web traffic estimates (Ahrefs search traffic) | `web-traffic` | Ahrefs' estimate of the search traffic a target's site gets each month, organic and paid: modelled from its rankings, not visits | Signals | monthly: five years by month |

### Shows and video

| Source | Its id | What PodData reads | Holds | How often |
| - | - | - | - | - |
| Podcast feeds | `podcast-feeds` | New episodes of the shows we follow, from each show's own feed, with the audio at the address the feed gives; a diligence target reads the quotes in them that name it, its rivals or its listed comparable | Documents | hourly |
| Companies' own podcasts | `company-podcasts` | Podcasts the companies we follow publish, every episode or only those with someone we follow in them; a diligence target reads the quotes in them that name it, its rivals or its listed comparable | Documents | hourly |
| Business TV interviews | `business-tv` | Full episodes six CNBC shows and The Information’s TITV publish as podcasts, kept only when someone we follow appears; a diligence target reads the quotes in them that name it, its rivals or its listed comparable | Documents | hourly |
| Congressional hearings | `hearings` | Hearings where someone we follow testifies, from the committees' own schedules, with the witnesses and the recording; a diligence target reads the quotes in them that name it, its rivals or its listed comparable | Documents | every six hours |
| The Fed's press conferences | `fed-press` | The Chair's press conference after each FOMC meeting, with the Fed's own transcript and recording; a diligence target reads the quotes in them that name it, its rivals or its listed comparable | Documents | every six hours |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.