CGTrader (Preview)
Gets models from CGTrader for the connected account
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Connector Metadata | |
|---|---|
| Publisher | Microsoft |
Use this connector to browse and download 3D models from CGTrader inside of Power Apps and Power Automate.
Prerequisites
Makers must have a valid API key (OAuth client id and client secret) for the CGTrader API. These can be requested from https://www.cgtrader.com/developers
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
| Name | Type | Description | Required |
|---|---|---|---|
| Client ID | securestring | The OAuth Client ID for the CGTrader API. This can be requested at https://www.cgtrader.com/developers | True |
| Client Secret | securestring | The OAuth Client Secret for the CGTrader API. This can be requested at https://www.cgtrader.com/developers | True |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Downloads a model with the given ID and file type |
Downloads a model with the given ID and file type. |
| Gets the available category names and IDs |
Gets the available category names and IDs. |
| Gets the info of a model with the given ID |
Gets the info of a model with the given ID. |
| Searches for models from CGTrader based on the given filters |
Searches for models from CGTrader based on the given filters. |
Downloads a model with the given ID and file type
Downloads a model with the given ID and file type.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
ModelID
|
model_id | True | number |
Model ID number from CGTrader. |
|
File Type
|
file_type | True | string |
The preferred file type to download. Examples: glb, obj, stl |
Returns
The content of the file.
- File content
- binary
Gets the available category names and IDs
Gets the available category names and IDs.
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
|
array of object | ||
|
Id
|
Id | number |
Model id |
|
Title
|
Title | string |
Model title |
Gets the info of a model with the given ID
Gets the info of a model with the given ID.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
ModelID
|
model_id | True | number |
Model ID number from CGTrader. |
Returns
- Body
- ModelInfo
Searches for models from CGTrader based on the given filters
Searches for models from CGTrader based on the given filters.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Search query
|
keywords | string |
Search keywords to query for. |
|
|
File extensions
|
extensions | string |
Filter models by file extension. Separate with commas, example: "glb,obj,stl" |
|
|
Sort option
|
sort | string |
Sort models by: best_match, sales, newest, oldest, lower_price, higher_price |
|
|
Category ID
|
category_id | number |
Filter models by category. Category ids are available via GetCategories. |
|
|
Low poly only
|
low_poly | boolean |
Include or exclude low poly models. |
|
|
Maximum price
|
max_price | number |
Maximum price limit. Searches for free models by default. |
|
|
Minimum price
|
min_price | number |
Minimum price limit. Searches for free models by default. |
|
|
Page number
|
page | number |
Search results are sectioned into pages, use this value to browse lengthy results |
|
|
Models per page
|
per_page | number |
Number of models per page, default is 25 |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Total
|
Total | number |
Total results |
|
Models
|
Models | array of ModelInfo |
Definitions
ModelInfo
| Name | Path | Type | Description |
|---|---|---|---|
|
Id
|
Id | number |
Model id |
|
Title
|
Title | string |
Model title |
|
Description
|
Description | string |
Model description |
|
Url
|
Url | string |
Model url |
|
AuthorName
|
AuthorName | string |
Author of the model |
|
License
|
License | string |
Model license |
|
Price
|
Price | number |
Model price |
|
AvailableFileExtensions
|
AvailableFileExtensions | array of string |
Available file extensions |
|
Thumbnail
|
Thumbnail | string |
Preview thumbnail |
binary
This is the basic data type 'binary'.