---
title: "GET /v3/search?type=models"
method: GET
path: "/v3/search?type=models"
tags: ["search", "models"]
---

# GET /v3/search?type=models

`GET /v3/search?type=models`

## Request

- Base URL: `https://api.sketchfab.com`
- URL: `https://api.sketchfab.com/v3/search?type=models`
- Auth: none declared
- TypeScript: <https://skmtc.dev/sketchfab/apis/sketchfab-api/docs/v3/search%3Ftype=models/get.ts> (a function with typed inputs; its response is checked against the schema)

Search and filters in models

## Query parameters

- `q` string
- `user` string
- `tags` string[]
- `categories` string[]
- `date` 1 | 7 | 31
- `downloadable` boolean
- `animated` boolean
- `staffpicked` boolean
- `sound` boolean
- `min_face_count` integer
- `max_face_count` integer
- `pbr_type` 'false' | 'true' | 'metalness' | 'specular'
- `rigged` boolean
- `collection` string
- `sort_by` 'likeCount' | '-likeCount' | 'viewCount' | '-viewCount' | 'publishedAt' | '-publishedAt' | 'processedAt' | '-processedAt'
- `file_format` string
- `license` 'by' | 'by-sa' | 'by-nd' | 'by-nc' | 'by-nc-sa' | 'by-nc-nd' | 'cc0' | 'ed' | 'st'
- `max_uv_layer_count` integer
- `available_archive_type` string
- `archives_max_size` integer
- `archives_max_face_count` integer
- `archives_max_vertex_count` integer
- `archives_max_texture_count` integer
- `archives_texture_max_resolution` integer
- `archives_flavours` boolean
- `processing_status` 'pending' | 'processing' | 'succeeded' | 'failed'

## Response `200`

Models matching the search

- ModelSearchResponse
  - `results` ModelSearchList[]
    - `uid` string
    - `animationCount` integer
    - `viewerUrl` string
    - `publishedAt` string, date
    - `likeCount` integer
    - `commentCount` integer
    - `user` UserRelated
      - `username` string
      - `profileUrl` string
      - `account` string
      - `displayName` string
      - `uid` string
      - `uri` string
      - `avatar` AvatarRelated
        - `images` object[]
          - `url` string
          - `width` integer
          - `height` integer
          - `size` integer
        - `uid` string
        - `uri` string
    - `isDownloadable` boolean
    - `name` string
    - `viewCount` integer
    - `thumbnails` ThumbnailsRelated
      - `images` object[]
        - `url` string
        - `width` integer
        - `size` integer, nullable
        - `uid` string
        - `height` integer
    - `license` string
    - `isPublished` boolean
    - `staffpickedAt` string, date, nullable
    - `archives` object
      - `source` ArchiveNested
        - `faceCount` integer
        - `textureCount` integer
        - `size` integer: archive size (in bytes)
        - `vertexCount` integer
        - `textureMaxResolution` integer
      - `glb` ArchiveNested
        - `faceCount` integer
        - `textureCount` integer
        - `size` integer: archive size (in bytes)
        - `vertexCount` integer
        - `textureMaxResolution` integer
      - `usdz` ArchiveNested
        - `faceCount` integer
        - `textureCount` integer
        - `size` integer: archive size (in bytes)
        - `vertexCount` integer
        - `textureMaxResolution` integer
      - `gltf` ArchiveNested
        - `faceCount` integer
        - `textureCount` integer
        - `size` integer: archive size (in bytes)
        - `vertexCount` integer
        - `textureMaxResolution` integer
    - `embedUrl` string

---

[API](https://skmtc.dev/sketchfab/apis/sketchfab-api.md) - [All operations](https://skmtc.dev/sketchfab/apis/sketchfab-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sketchfab/apis/sketchfab-api/revisions/3d1f8bd62bc7?raw)