Comment by verdverm
sure, but then I have to figure out what your JSON response from the API means
The reason HTML is more interesting is because the Ai can interpret the markup and formatting, the layout, the visual representation and relations of the information
Presentation matters when conveying information to both humans and agents/ai
Plaintext and JSON are just not going to cut it.
Now if OP really wants to do something about it, give scrapers a markdown option, but then scrapers are going to optimize for the average, so if everyone is just doing HTML, and the HTML analysis is good enough, offered alternatives are likely to be passed on
I mean, OP could have used OpenAPI to describe their API. But instead it looks like they handrolled their own description.
If you want something to use your stuff, try and find and conform to some standard, ideally something that a lot of people are using already.