# Poly API API

> Poly API API on Apizie: 4 endpoints (Returns detailed information about an asset given its name. PRIVATE assets are returned only if the…, Lists all public, remixable assets. These are assets with an access level of PUBLIC and published under the…, Lists assets authored by the given user. Only the value 'me', representing the currently-authenticated user,…, Lists assets that the user has liked. Only the value 'me', representing the currently-authenticated user, is…) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/analytics:googleapis-poly/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `analytics:googleapis-poly`
- Category: Analytics
- Status: byok
- Source: https://developers.google.com/poly/
- Page: https://apizie.tech/api/analytics/googleapis-poly
- OpenAPI: https://apizie.tech/api/analytics/googleapis-poly/openapi.json

The Poly API provides read access to assets hosted on poly.google.com to all, and upload access to poly.google.com for whitelisted accounts.

## Endpoints

### Returns detailed information about an asset given its name. PRIVATE assets are returned only if the…
`GET https://apizie.tech/v1/analytics:googleapis-poly/poly-assets-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. An asset's name in the form `assets/{ASSET_ID}`. |

### Lists all public, remixable assets. These are assets with an access level of PUBLIC and published under the…
`GET https://apizie.tech/v1/analytics:googleapis-poly/poly-assets-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| category | string | no | Filter assets based on the specified category. Supported values are: `animals`, `architecture`, `art`, `food`, `nature`, `objects`,… |
| curated | boolean | no | Return only assets that have been curated by the Poly team. |
| format | string | no | Return only assets with the matching format. Acceptable values are: `BLOCKS`, `FBX`, `GLTF`, `GLTF2`, `OBJ`, `TILT`. |
| keywords | string | no | One or more search terms to be matched against all text that Poly has indexed for assets, which includes display_name, description, and… |
| maxComplexity | string | no | Returns assets that are of the specified complexity or less. Defaults to COMPLEX. For example, a request for MEDIUM assets also includes… |
| orderBy | string | no | Specifies an ordering for assets. Acceptable values are: `BEST`, `NEWEST`, `OLDEST`. Defaults to `BEST`, which ranks assets based on a… |
| pageSize | integer | no | The maximum number of assets to be returned. This value must be between `1` and `100`. Defaults to `20`. |
| pageToken | string | no | Specifies a continuation token from a previous search whose results were split into multiple pages. To get the next page, submit the same… |

### Lists assets authored by the given user. Only the value 'me', representing the currently-authenticated user,…
`GET https://apizie.tech/v1/analytics:googleapis-poly/poly-users-assets-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | no | Return only assets with the matching format. Acceptable values are: `BLOCKS`, `FBX`, `GLTF`, `GLTF2`, `OBJ`, and `TILT`. |
| name | string | yes | A valid user id. Currently, only the special value 'me', representing the currently-authenticated user is supported. To use 'me', you must… |
| orderBy | string | no | Specifies an ordering for assets. Acceptable values are: `BEST`, `NEWEST`, `OLDEST`. Defaults to `BEST`, which ranks assets based on a… |
| pageSize | integer | no | The maximum number of assets to be returned. This value must be between `1` and `100`. Defaults to `20`. |
| pageToken | string | no | Specifies a continuation token from a previous search whose results were split into multiple pages. To get the next page, submit the same… |
| visibility | string | no | The visibility of the assets to be returned. Defaults to VISIBILITY_UNSPECIFIED which returns all assets. |

### Lists assets that the user has liked. Only the value 'me', representing the currently-authenticated user, is…
`GET https://apizie.tech/v1/analytics:googleapis-poly/poly-users-likedassets-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | no | Return only assets with the matching format. Acceptable values are: `BLOCKS`, `FBX`, `GLTF`, `GLTF2`, `OBJ`, `TILT`. |
| name | string | yes | A valid user id. Currently, only the special value 'me', representing the currently-authenticated user is supported. To use 'me', you must… |
| orderBy | string | no | Specifies an ordering for assets. Acceptable values are: `BEST`, `NEWEST`, `OLDEST`, 'LIKED_TIME'. Defaults to `LIKED_TIME`, which ranks… |
| pageSize | integer | no | The maximum number of assets to be returned. This value must be between `1` and `100`. Defaults to `20`. |
| pageToken | string | no | Specifies a continuation token from a previous search whose results were split into multiple pages. To get the next page, submit the same… |

## Example
```
curl "https://apizie.tech/v1/analytics:googleapis-poly/poly-assets-get" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Poly API API?
Create a free Apizie key, then send GET https://apizie.tech/v1/analytics:googleapis-poly/poly-assets-get with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Poly API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Poly API itself also needs your own key from googleapis.com.

### Can AI agents use the Poly API API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key analytics:googleapis-poly.

### What is the status of the Poly API API?
Needs your own provider key (bring your own key)
