List public assets
curl --request GET \
--url 'https://gengen.farm/api/gengen/v1/assets/public?pageNumber=1&pageSize=30&query=United%20Kingdom' \
--header 'Authorization: Bearer gengen_live_xxxxxxxxxxxxxxxx'import requests
url = "https://gengen.farm/api/gengen/v1/assets/public"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gengen.farm/api/gengen/v1/assets/public', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"items": [
{
"assetId": "asset-20260225015229-d77t9",
"thumbnailUrl": "https://blob.example.com/thumb_126a7ec05b7f0660f9525298.webp",
"title": "United Kingdom 22-year-old male model",
"description": "A model portrait",
"score": 100,
"metadata": {
"country": "United Kingdom",
"age": 22,
"gender": "male",
"occupation": "Model",
"type": "portrait"
}
}
],
"pageNumber": 1,
"pageSize": 30,
"totalCount": 5234,
"hasMore": true,
"query": "United Kingdom"
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}Assets API
List public assets
Search the public asset library; results contain thumbnails but omit original and full-size asset URLs.
GET
/
assets
/
public
List public assets
curl --request GET \
--url 'https://gengen.farm/api/gengen/v1/assets/public?pageNumber=1&pageSize=30&query=United%20Kingdom' \
--header 'Authorization: Bearer gengen_live_xxxxxxxxxxxxxxxx'import requests
url = "https://gengen.farm/api/gengen/v1/assets/public"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gengen.farm/api/gengen/v1/assets/public', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"items": [
{
"assetId": "asset-20260225015229-d77t9",
"thumbnailUrl": "https://blob.example.com/thumb_126a7ec05b7f0660f9525298.webp",
"title": "United Kingdom 22-year-old male model",
"description": "A model portrait",
"score": 100,
"metadata": {
"country": "United Kingdom",
"age": 22,
"gender": "male",
"occupation": "Model",
"type": "portrait"
}
}
],
"pageNumber": 1,
"pageSize": 30,
"totalCount": 5234,
"hasMore": true,
"query": "United Kingdom"
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}{
"error_code": "<string>",
"error": "<string>",
"error_params": {}
}Authorizations
A workspace API key beginning with gengen_live_.
Query Parameters
Optional fuzzy search across display text and metadata.
Page number starting at 1. Compatibility aliases are page, page_num, and page_number.
Required range:
x >= 1Results per page. Compatibility aliases are limit and page_size.
Required range:
1 <= x <= 100