> For the complete documentation index, see [llms.txt](https://developer.parvenu.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.parvenu.io/enrichments/commercial-or-residential.md).

# Commercial or Residential

Find out whether a company works for commercial clients, homeowners or both, read from its own website. One company at a time or across an entire Parvenu list.

Commercial or Residential reads a company's own website and says who it works for: `commercial`, `residential`, `both` or `unknown`, with one short sentence of evidence from the site.

It works for any trade that can sell to businesses, homeowners or both, such as roofing, remodeling, HVAC, plumbing and cleaning.

The answer comes from the company's own website: the homepage and a few pages on the same site. It never runs a web search. OpenAI reads the text and picks the answer. If the site blocks a direct read, Tavily Extract reads the same page.

### Endpoints

* [Individual Lookup](https://developer.parvenu.io/enrichments/commercial-or-residential/individual-lookup.md): pass one `domain`, get the answer back in the response. Synchronous, 0.5 credits.
* [List Lookup](https://developer.parvenu.io/enrichments/commercial-or-residential/list-lookup.md): pass a `listname`; the API runs it against every row and writes the answer to the `commercial_residential` and `commercial_residential_reason` columns. Asynchronous, 0.5 credits per company. Contacts at the same company share one answer and one charge.

### Use Cases

* **Split a trade list by who they serve.** A commercial roofer and a residential roofer buy different things and respond to different pitches. Filter or sort on the `commercial_residential` column and send each group its own copy.
* **Keep the wrong half out of a campaign.** If your offer only fits companies that work for businesses, drop the `residential` rows before you spend credits finding their emails and phones.

{% hint style="info" %}
Both endpoints cost the same: **0.5 credits** per company with an answer (`commercial`, `residential` or `both`). `unknown` is free: the website could not be read or does not say. On a list, each company is charged once, however many of its contacts are on the list, and rows with no domain are skipped for free. A request with no usable domain is rejected before anything is spent.
{% endhint %}
