Generate - Croma API

Read a public web page and return an object built from it: a summary, a classification, a translation, a reshaped record. Unlike Extract, the fields need not appear on the page.

Page into an object

POST /global/generate/json/v1

Field	Type	Notes
`url`	string	Required. Public http or https URL. Loopback and private addresses are rejected.
`instructions`	string	Required. 3-20,000 chars. What to do with the page. Write it as you would brief an analyst.
`json_schema`	object	Required. JSON Schema for the object to return.
`effort`	enum	`min`, `standard`, or `max`. Default `standard`. `min` is fastest; `max` handles pages that render themselves in the browser.
`country`	string	ISO 3166-1 alpha-2 code (e.g. `CO`) for pages that serve different content by country. Omit for the default route.

curl https://api.croma.run/global/generate/json/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://www.funcionpublica.gov.co/eva/gestornormativo/norma.php?i=304", "instructions": "Resume la norma en dos frases y clasifica su materia principal.", "json_schema": { "type": "object", "required": ["summary", "subject"], "properties": { "summary": { "type": "string" }, "subject": { "type": "string" } } } }'

Field	Notes
`url`	The page that was read, after any redirects.
`result`	The object described by the `json_schema` you sent.

The output is written from the page, so treat it as a draft: check anything you act on against the page itself, which Extract returns verbatim.

Generate has a tighter quota than most endpoints: 60 requests per hour per organization, shared with Extract. See Rate limits.

Full reference

Schemas, all response fields, and an interactive playground.