Organization schema for web extraction
An organization schema captures the facts that describe a company or institution: its legal or common name, industry, founding year, headquarters location, website, employee count, and a short description. Teams extract this to enrich a CRM, build company databases, run lead research, or map a market. Instead of reading an about page and copying details by hand, you describe the fields you want and get back a structured record you can store and join against your own data. Company information lives in many shapes, from Wikipedia infoboxes to corporate about pages to press footers, which is why describing fields beats writing per-site selectors. You define what an industry or a founding year is, and the model reads it from the rendered page. Anything the page does not state, like an employee count a private company keeps quiet, returns null rather than a guess. For firmographic data that honesty matters, because an invented headcount or founding year quietly corrupts the analysis you build on top of it.
Fields in a Organization schema
The fields teams most often extract for a organization, what type each one is, and whether it is usually present.
| Field | Type | Required | Notes |
|---|---|---|---|
| name | string | yes | The organization's name as presented on the page. This is the anchor field for company records and for matching against existing data, so it is required rather than optional. |
| industry | string | optional | The sector the organization operates in, such as Software, Logistics, or Healthcare. Useful for segmenting a company database and filtering a market map by line of business. |
| foundingYear | number | optional | The year the organization was founded, parsed as a number so you can sort by age and compute company maturity. Returns null when the page does not state a founding year. |
| headquarters | string | optional | Where the organization is based, typically a city and country. Returned as written on the page so you keep the exact location detail for mapping and regional segmentation. |
| website | string | optional | The organization's official website URL. Acts as a stable key for deduplication and a starting point for deeper enrichment from the company's own pages. |
| employeeCount | number | optional | The reported number of employees, parsed as a number where a single figure is given. Returns null when only a vague range or nothing at all is published, rather than a guessed value. |
| foundedBy | string[] | optional | The founders credited on the page, returned as a list of names. Helpful for people-to-company mapping and for research that tracks founders across multiple ventures over time. |
| description | string | optional | A short summary of what the organization does, taken from the page. Gives you a human-readable blurb for cards and profiles without you having to write one per company. |
The schema
Copy this and send it with any URL.
{
"name": "string",
"industry": "string",
"foundingYear": "number",
"headquarters": "string",
"website": "string",
"employeeCount": "number",
"foundedBy": "string[]",
"description": "string"
} Example output
Validated JSON back, matching the schema.
{
"name": "Brightgrove Analytics",
"industry": "Software",
"foundingYear": 2012,
"headquarters": "Toronto, Canada",
"website": "https://example.com",
"employeeCount": 480,
"foundedBy": [
"Mara Ellison",
"Theo Park"
],
"description": "Brightgrove Analytics builds dashboards and data tooling for mid-market retailers."
} Try this organization schema against a real page in the live demo, or read the docs to use it via the API.