canonical: https://jentic.com/apis/api.cgtrader.com/cgtrader # CGTrader API Jentic publishes the only available OpenAPI specification for CGTrader API, keeping it validated and agent-ready. The CGTrader API powers a marketplace for 3D models, letting sellers list models and buyers browse and order them. It lists and manages models with their files, images, categories, and licenses, and it creates and retrieves orders. It also exposes supported file types and user accounts, so an agent can run a full catalog and purchase workflow. Read and write operations cover both selling and buying on the platform. ## For AI agents Browse and manage 3D model listings with their files and images, look up categories and licenses, and create and retrieve orders on the CGTrader marketplace. ## Scope Covers the CGTrader 3D model catalog, orders, and account operations. Does not render or convert 3D files and does not handle payment settlement outside the order flow. ## Capabilities - List and search 3D models in the marketplace - Create, update, and delete a model listing - Manage the files and images attached to a model - Look up categories, file types, and a model's license - Create and retrieve orders - Register a user and read the current account ## Use cases ### Catalog Browsing and Search A shopping agent browses CGTrader for 3D models matching a buyer's need and reads their details, categories, and licenses. It lists models, filters by category, and inspects a model before recommending it. Through Jentic the agent finds the models operation and calls it with its parameters. Example prompt: List models in a category and return their details and license for a buyer ### Seller Listing Management A seller agent creates and maintains model listings, uploading files and images and updating metadata. It creates a model, attaches its files and images, and updates the listing as needed. This automates keeping a catalog current across many models. Example prompt: Create a model listing and attach its files and images, then update its metadata ### Automated Purchasing A procurement agent orders a selected 3D model and tracks the order. It creates an order for the model and retrieves the order to confirm it. This lets a pipeline acquire assets it needs without manual checkout. Example prompt: Create an order for a chosen model and retrieve it to confirm the purchase ### License and File-Type Compliance A content agent checks the license and supported file types before using a model in a project. It reads a model's license and the marketplace file types to confirm the asset fits its pipeline. This keeps downstream use within the license terms. Example prompt: Read a model's license and the supported file types to confirm it fits a project ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/v1/models` | List 3D models | | POST | `/v1/models` | Create a model listing | | GET | `/v1/models/{id}` | Get a model by id | | GET | `/v1/categories` | List categories | | GET | `/v1/orders` | List orders | | POST | `/v1/orders` | Create an order | | GET | `/v1/models/{model_id}/files` | List the files attached to a model | ## Key resources - **Models** — 3D model listings with metadata, files, images, and licenses - **Orders** — Purchases of models on the marketplace - **Categories** — Categories a model can belong to - **File types** — File formats supported by the marketplace - **Users** — User registration and the current account ## Why Jentic - **Setup:** Wiring CGTrader by hand means managing its bearer token against api.cgtrader.com and threading it through every model, file, and order call yourself. Through Jentic you install once, import CGTrader from the API Directory, store the token once, and your agent calls it. - **Permission scoping:** CGTrader operations act on models and orders, so a rule limits your agent to the operations it needs, such as browsing models and creating orders. You choose which operations it may call, so creating, updating, or deleting listings is included only when you add it. - **Credential handling:** Your CGTrader bearer token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'list 3D models' or 'create an order', and Jentic returns the matching CGTrader operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Sketchfab** — Sketchfab is a 3D model platform with viewing and a store, a direct alternative for 3D assets. - **Etsy** — Etsy is a marketplace for creative goods including digital downloads, a broader alternative to CGTrader. - **Reverb** — Reverb is a specialized marketplace API for musical gear, showing the same list-and-order pattern in another niche. - **Shopify** — Shopify runs your own storefront; pair it with CGTrader to sell 3D models sourced from the marketplace. ## FAQ ### Why is there no official OpenAPI spec for CGTrader API? CGTrader does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call the CGTrader API via structured tooling. It is validated against the live API and kept up to date. To run it on your own infrastructure, install Jentic One from its GitHub repo. ### What authentication does the CGTrader API use? The CGTrader API authenticates with an HTTP bearer token in the Authorization header per its OpenAPI spec. Through Jentic, that token is stored encrypted by your own Jentic One instance and injected at execution time, so it never enters the agent's prompt or logs. ### Can I both buy and sell 3D models with the CGTrader API? Yes. The CGTrader API lists and searches models for buyers and creates orders, and it also creates and updates model listings with their files and images for sellers. An agent can run either side of the marketplace depending on the operations you allow. ### What are the rate limits for the CGTrader API? The OpenAPI spec does not specify rate limits for the CGTrader API. Check the CGTrader developer documentation at https://api.cgtrader.com/docs/index.html for current limits, and back off when you receive a 429 response. ### How do I browse 3D models through Jentic? Search Jentic for 'list 3D models', import CGTrader from the API Directory, and store your token once. Jentic returns the models operation with its parameters so your agent can call it directly and read back the listings. ### Can I limit what my agent is allowed to do with the CGTrader API? Yes. Operations act on a model or order, so you write a rule that lets the agent only browse and order, keeping create, update, and delete on listings out of reach unless you add them. Because Jentic One is self-hosted, those rules and the audit log of every call stay on your own infrastructure. ### Is there a CGTrader API MCP server? You do not need an MCP server to give your agent the CGTrader API. Jentic connects it directly from the API Directory: import it, store your token once, and your agent can browse models and place orders. That also keeps your agent's context free of an extra server's tool definitions.