Media

Creative Commons 3D Models

Downloadable Creative-Commons-licensed 3D models from Sketchfab (sketchfab.com) via its public Data API v3 search: URL, id, title, description, license, thumbnails, creator, view/like/comment counts, geometry stats and download formats. Only models whose license resolves to a CC license are kept.

creative-commons-3d-models3d-modelscreative-commonssketchfabmedia

98 rows in the dataset

Download the dataset

Get every row this scraper has collected as one CSV or JSONL file. If the data is older than maxAgeHours, the scraper is re-run with its configured settings first. The key needs the datasets:export scope.

DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/creative-commons-3d-models/downloads" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do  STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status')  [ "$STATUS" != "refreshing" ] && break  sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -o dataset.csv

At its current 98 rows, this download costs 1 credit when the data is fresh enough, or 2 credits when it has to be refreshed first.

The rate is 1 credit per 100 rows cached and 2 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.

Start a run

To choose the targets yourself, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.

curl -X POST "https://api.pandorlabs.com/v1/scrapers/creative-commons-3d-models/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "maxModels": 100,      "licenses": [        "by",        "cc0"      ],      "query": "chair",      "categories": [        "animals-pets"      ]    }  }'

A run is billed at the live rate once it finishes: 2 credits per 100 rows it collected. A run that collects nothing costs nothing.

Parameters

Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.

maxModels
number
Maximum models
Default
100
Range
1 to 1000

Targeting

licenses
enum[]
Licenses
Sketchfab Creative Commons license slugs, one search pass each: by, by-sa, by-nd, by-nc, by-nc-sa, by-nc-nd, cc0. Unknown slugs are ignored.
Default
["by","cc0"]
Allowed values
by
by-sa
by-nd
by-nc
by-nc-sa
by-nc-nd
cc0
query
string
Search text
Optional free-text filter passed to Sketchfab search.
Default
none
Example
chair
categories
string[]
Categories
Optional Sketchfab category slugs (e.g. animals-pets, architecture, vehicles-transportation). Each category runs its own pass per license.
Default
none
Example
animals-pets

Advanced

maxPages
number
Max pages per pass
Default
2
Range
1 to 50
pageSize
number
Models per page
Default
24
Range
1 to 24
requestDelayMs
number
Delay between requests (ms)
Default
500
Range
300 to 30000

Input as JSON Schema

The same schema the API validates against. Use it as a tool input schema or to generate a typed client.

inputSchema

{  "type": "object",  "additionalProperties": false,  "properties": {    "maxModels": {      "type": "number",      "minimum": 1,      "maximum": 1000,      "title": "Maximum models",      "default": 100    },    "licenses": {      "type": "array",      "items": {        "type": "string",        "enum": [          "by",          "by-sa",          "by-nd",          "by-nc",          "by-nc-sa",          "by-nc-nd",          "cc0"        ]      },      "uniqueItems": true,      "title": "Licenses",      "description": "Sketchfab Creative Commons license slugs, one search pass each: by, by-sa, by-nd, by-nc, by-nc-sa, by-nc-nd, cc0. Unknown slugs are ignored.",      "default": [        "by",        "cc0"      ]    },    "query": {      "type": "string",      "maxLength": 2000,      "title": "Search text",      "description": "Optional free-text filter passed to Sketchfab search.",      "examples": [        "chair"      ]    },    "categories": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Categories",      "description": "Optional Sketchfab category slugs (e.g. animals-pets, architecture, vehicles-transportation). Each category runs its own pass per license.",      "examples": [        "animals-pets"      ]    },    "maxPages": {      "type": "number",      "minimum": 1,      "maximum": 50,      "title": "Max pages per pass",      "default": 2    },    "pageSize": {      "type": "number",      "minimum": 1,      "maximum": 24,      "title": "Models per page",      "default": 24    },    "requestDelayMs": {      "type": "number",      "minimum": 300,      "maximum": 30000,      "title": "Delay between requests (ms)",      "default": 500    }  }}

Run, poll, read rows

The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).

RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/creative-commons-3d-models/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "maxModels": 100,      "licenses": [        "by",        "cc0"      ],      "query": "chair",      "categories": [        "animals-pets"      ]    }  }' | jq -r '.id')while true; do  RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY")  STATUS=$(echo "$RUN" | jq -r '.status')  BILLING=$(echo "$RUN" | jq -r '.billing.status')  case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac  sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \  -H "Authorization: Bearer $PANDORLABS_KEY"

See the API reference for pagination, cancelling and listing runs.

Output fields

Rows have no fixed schema; these are the fields observed in the rows collected so far. Coverage is the share of rows where the field is present.

Field	Type	Coverage
animation_count	number	100%
archives	array	100%
categories	array	100%
comment_count	number	100%
created_at_source	date	100%
creator	object	100%
creator_username	string	100%
description	string	90%
domain	string	100%
face_count	number	100%
id	string	100%
images	array	100%
is_age_restricted	boolean	100%
is_downloadable	boolean	100%
license	object	100%
license_slug	string	100%
like_count	number	100%
search_license	string	100%
search_query	string	2%
source_dataset_id	string	100%
tags	array	100%
thumbnail_url	string	100%
title	string	100%
vertex_count	number	100%
view_count	number	100%
created_at	date	100%
published_at	date	100%
staff_picked_at	date	1%
updated_at	date	100%
_id	string	100%