When working with data many times you have to interact with large databases with many fields. For example if you work with Google Analytics the reporting tool talks to many databases with hundreds of different fields and columns of these
databases. Different timestamps for your data, encodings, types, logs, content, xml configurations, etc. Each of these database columns has its own format and since there are so many, it is practically impossible for a human to remember all the exact syntax and parameters for each of these fields.
For this reason we build an application interface (API)
to access these types of information (metadata)
. This metadata API can help you better understand what data is suitable for your application and how you can interact with the database to retrieve it.
Here is a response from a metadata API from Google Analytics. There you can see what type of info the endpoint is expecting from you to submit in order to retrieve
a valid response.
Here is also a link for the overview of the above metadata API.