What is Public API?

Public API reads and creates data published from Re:Earth CMS. Websites and external services can use it to retrieve the following kinds of data.

• Published models
• Items (content)
• Assets (images, files, etc.)

If you need management operations such as updating or deleting existing data, or changing schemas, use Integration API instead.

Here are Public API’s key characteristics.

Characteristic	Description
Read and create data	Access is limited to published models, items, and assets. Creating data is also supported (fields of type Asset, Reference, Tag, Group, GeometryEditor, and GeometryObject aren’t supported for posting).
No authentication required	Public data can be accessed without an API key. Private data can’t be retrieved.
RESTful API	A REST-compliant design using standard HTTP methods (GET, POST, etc.).

Caution

Because Public API requires no authentication, it can be called directly from a frontend. Depending on your environment, though, you may need to configure CORS (Cross-Origin Resource Sharing). In production, be sure to restrict allowed origins appropriately.

Next steps

Continue to Using Public API (Read) and try going from publishing settings to your first read request.

Related resources

• Reference: Public API Reference
• How-to guides: Rendering Public API items as GeoJSON on a map