GET /v1/models

Description

Get page of models

Headers

content_type

application/json

Parameters

keywords optional, type: String

Search query

page optional, type: Integer

Current page number, default is 1

per_page optional, type: Integer

Number of models per page, default is 25

min_price optional, type: Float

Minimum model price limit, default is 0

max_price optional, type: Float

Maximum model price limit, default is undefined

product_type optional, type: String

Filter models by product type. Available values: cg, printable. Query will return all products if value is undefined.

category_id optional, type: Integer

Filter models by category. Category ids are available via GET /v1/categories endpoint.

extensions optional, type: String

Filter models by file extension. File extensions separated by comma, example: extensions: "obj,stl"

adult_content optional, type: Boolean

Include models suitable only for adults. The default value is false.

discounted optional, type: Boolean

Include or exclude discounted models.

low_poly optional, type: Boolean

Include or exclude low poly models. (Only available when product type is not printable)

animated optional, type: Boolean

Include or exclude animated models. (Only available when product type is not printable)

pbr optional, type: Boolean

Include or exclude PBR models. (Only available when product type is not printable)

rigged optional, type: Boolean

Include or exclude rigged models. (Only available when product type is not printable)

collection optional, type: Boolean

Include or exclude collections. (Only available when product type is not printable)

min_admin_rating optional, type: Float

In order to filter by quality, minimum admin rating can be provided. Value should be in [0.0, 10.0]

sort optional, type: String

Sort models by: best_match | sales | newest | oldest | lower_price | higher_price

polygons optional, type: String

Filters models by polygons count. Available values: lt_5k | range_5k_10k | range_10k_50k | range_50k_100k | range_100k_250k | gt_250k

license optional, type: String

Filter models by license. Only available value: exclude_editorial

Example Response

{
    "total": 2,
    "models": [
        {
            "id": 1,
            "status": "published",
            "author_name": "joe",
            "url": "http://test.host/3d-print-models/parent-category/child-category/joe-vase",
            "slug": "joe-vase",
            "category_slug": "parent-category",
            "subcategory_slug": "child-category",
            "category_id": 1,
            "subcategory_id": 2,
            "title": "Joe Vase",
            "downloadable": true,
            "description": "
Ligula Fusce Sollicitudin
",
            "raw_description": "Ligula Fusce Sollicitudin",
            "animated": true,
            "rigged": true,
            "game_ready": true,
            "type": "printable",
            "license": "royalty_free",
            "custom_license": null,
            "tags": [
                "gift",
                "home",
                "printable",
                "uniq",
                "vase"
            ],
            "only_for_adults": false,
            "subscribed": true,
            "potential": false,
            "prices": {
                "download": 11.1
            },
            "files": [
                {
                    "id": 1,
                    "name": "cube.stl",
                    "size": 684,
                    "download_url": "http://api.test.host/v1/models/1/files/1"
                },
                {
                    "id": 2,
                    "name": "triangle.stl",
                    "size": 684,
                    "download_url": "http://api.test.host/v1/models/1/files/2"
                }
            ],
            "availableFileExtensions": [
                "stl"
            ],
            "thumbnails": [
                "https://img-new.cgtrader.com/items/705406/e609613cd5/grey-alien.jpg",
                "https://img-new.cgtrader.com/items/705406/sasdas/grey-alien-3d.jpg"
            ]
        },
        {
            "id": 2,
            "status": "published",
            "author_name": "joe",
            "url": "http://test.host/3d-models/parent-category/child-category/black-car",
            "slug": "black-car",
            "category_slug": "parent-category",
            "subcategory_slug": "child-category",
            "category_id": 1,
            "subcategory_id": 2,
            "title": "Black Car",
            "downloadable": true,
            "description": "
Ligula Fusce Sollicitudin
",
            "raw_description": "Ligula Fusce Sollicitudin",
            "animated": false,
            "rigged": false,
            "game_ready": false,
            "type": "cg",
            "license": "general",
            "custom_license": null,
            "tags": [
                "car",
                "tag2",
                "tag3",
                "tag4",
                "tag5"
            ],
            "only_for_adults": false,
            "subscribed": false,
            "potential": true,
            "prices": {
                "download": 10.0
            },
            "files": [],
            "availableFileExtensions": [],
            "thumbnails": [
                "https://img-new.cgtrader.com/items/705406/e609613cd5/grey-alien.jpg",
                "https://img-new.cgtrader.com/items/705406/sasdas/grey-alien-3d.jpg"
            ],
            "info": {
                "polygons": null,
                "vertices": null,
                "geometry_type": null,
                "collection": null,
                "textures": null,
                "materials": null,
                "plugins_used": null,
                "uvw_mapping": null,
                "unwrapped_uvs": null
            }
        }
    ]
}