Vecteezy API

https://www.vecteezy.com/api-docs
Admin
Vecteezy API enables developers to integrate Vecteezy's content library and AI-driven search into...
Tokens:10,701
Snippets:48
Trust Score:10
Update:1 month ago
Show doc for...
Tokens:
Raw
### GET /v2/{account_id}/resources/{id}/download_info

Source: https://www.vecteezy.com/api-docs/api/v2/swagger.json

Retrieves the download info for a resource source file. This endpoint uses the General quota type and returns the file size along with quota headers.

```APIDOC
## GET /v2/{account_id}/resources/{id}/download_info

### Description
Retrieves the download info for a resource source file. Quota type: General.

### Method
GET

### Endpoint
/v2/{account_id}/resources/{id}/download_info

### Parameters
#### Path Parameters
- **account_id** (integer) - Required - Your account ID.
- **id** (integer) - Required - Numeric identifier

#### Query Parameters
- **file_type** (string) - Required - File type to get download info for as indicated in the file_types field from the GET resource response (jpg, png, svg, etc...)

### Response
#### Success Response (200)
- **file_size** (integer) - File size in bytes

#### Response Headers
- **X-QUOTA-TYPE** (string) - The quota type used for the endpoint
- **X-QUOTA-LIMIT** (integer) - The number of allowed requests in the current period that do not incur overage charges
- **X-QUOTA-REMAINING** (integer) - The number of remaining requests in the current period that do not incur overage charges
- **X-QUOTA-OVERAGE-CUTOFF** (integer) - The number of allowed requests in the current period
- **X-QUOTA-OVERAGE-REMAINING** (integer) - The number of remaining requests in the current period

#### Response Example
{
  "file_size": 0
}

#### Error Responses
- **401** - Unauthorized
- **402** - Quota Exceeded
- **404** - Not Found
- **422** - Invalid File Type

```

--------------------------------

### GET /v2/{account_id}/resources/{id}/similar_images

Source: https://www.vecteezy.com/api-docs/api/v2/swagger.json

Retrieves visually similar resources for a given resource ID. This endpoint requires authentication and returns a paginated list of similar resources with metadata.

```APIDOC
## GET /v2/{account_id}/resources/{id}/similar_images

### Description
Retrieves visually similar resources for a given resource ID.

### Method
GET

### Endpoint
/v2/{account_id}/resources/{id}/similar_images

### Parameters
#### Path Parameters
- **account_id** (integer) - Required - Your account ID.
- **id** (integer) - Required - Resource id

#### Query Parameters
- **page** (integer) - Optional - Current page (default: 1)
- **per_page** (integer) - Optional - Results per page (default: 100, maximum: 100)

### Response
#### Success Response (200)
- **page** (integer) - Current page
- **last_page** (integer) - Last page number
- **per_page** (integer) - Results per page
- **total_resources** (integer) - Total number of resources
- **resources** (array) - List of resources
  - **id** (integer) - Resource ID
  - **content_type** (string) - Content type
  - **tags** (array) - Keywords describing the resource. Only available for paid customers.
  - **title** (string) - Title of the resource
  - **ai_generated** (boolean) - Whether the resource was AI-Generated. Only available for paid customers.
  - **dimensions** (object) - Width and Height of source file in pixels. Only available for paid customers.
  - **file_metadata** (object) - File metadata
    - **available_file_types** (array) - Available file types
    - **available_download_sizes** (array) - Available download sizes
  - **thumbnail_dimensions** (object) - Width and Height of thumbnail in pixels. Only available for paid customers.
  - **thumbnail_url** (string) - Thumbnail URL
  - **thumbnail_2x_url** (string) - Thumbnail 2x URL
  - **preview_dimensions** (object) - Width and Height of preview image in pixels. Only available for paid customers.
  - **preview_url** (string) - Preview URL

#### Response Example
{
  "page": 1,
  "last_page": 1,
  "per_page": 100,
  "total_resources": 1,
  "resources": [
    {
      "id": 123,
      "content_type": "image/jpeg",
      "tags": ["nature"],
      "title": "Example",
      "ai_generated": false,
      "dimensions": {"width": 1920, "height": 1080},
      "file_metadata": {
        "available_file_types": [{"extension": "jpg", "size_in_bytes": 1024}],
        "available_download_sizes": [{"id": "small", "width": 640, "height": 360}]
      },
      "thumbnail_dimensions": {"width": 320, "height": 180},
      "thumbnail_url": "https://example.com/thumb.jpg",
      "thumbnail_2x_url": "https://example.com/thumb2x.jpg",
      "preview_dimensions": {"width": 1280, "height": 720},
      "preview_url": "https://example.com/preview.jpg"
    }
  ]
}

#### Error Responses
- **401** (Unauthorized) - Authentication failed
- **403** (Forbidden) - Access denied
- **422** (Invalid File Type) - Invalid file type
- **400** (Invalid parameters) - Invalid parameters, e.g., invalid color parameter or invalid page parameter
```

--------------------------------

### GET /v2/{account_id}/track/summary

Source: https://www.vecteezy.com/api-docs/api/v2/swagger.json

Summarizes tracked resource usage. Returns the number of distinct resources tracked with each usage type (license and pre-license). Counts cover all tracked history unless bounded with start_time/end_time.

```APIDOC
## GET /v2/{account_id}/track/summary

### Description
Summarizes tracked resource usage. Returns the number of distinct resources tracked with each usage type (license and pre-license). Counts cover all tracked history unless bounded with start_time/end_time.

### Method
GET

### Endpoint
/v2/{account_id}/track/summary

### Parameters
#### Path Parameters
- **account_id** (integer) - Required - Your account ID.

#### Query Parameters
- **start_time** (string) - Optional - ISO 8601 timestamp. Inclusive lower bound on when the usage was tracked. Counts cover all history when omitted. Example: 2026-05-01T00:00:00Z
- **end_time** (string) - Optional - ISO 8601 timestamp. Inclusive upper bound on when the usage was tracked. Counts cover all history when omitted. Example: 2026-05-20T00:00:00Z

### Response
#### Success Response (200)
- **licensed_resource_count** (integer) - Number of distinct resources tracked with the license usage type
- **pre_licensed_resource_count** (integer) - Number of distinct resources tracked with the pre-license usage type

#### Error Responses
- **401** - Unauthorized
- **404** - Endpoint disabled for this account
- **400** - Invalid date range

```

--------------------------------

### GET /v2/account/{account_id}/resources

Source: https://www.vecteezy.com/api-docs/api/v2/swagger.json

Searches for resources in your Vecteezy account. Returns a paginated list of resources matching the search criteria.

```APIDOC
## GET /v2/account/{account_id}/resources

### Description
Searches for resources (photos, vectors, videos, etc.) in your Vecteezy account. Returns a paginated list of resources matching the search criteria.

### Method
GET

### Endpoint
/v2/account/{account_id}/resources

### Parameters
#### Path Parameters
- **account_id** (integer) - Required - Your account ID.

#### Query Parameters
- **term** (string) - Required - Search term.
- **content_type** (string) - Required - Content type filter (must be supported by your API Account). Enum: photo, png, psd, svg, vector, video.
- **page** (integer) - Optional - Current page: page * per_page cannot exceed 10,000. Default: 1.
- **per_page** (integer) - Optional - Results per page: page * per_page cannot exceed 10,000. Default: 100. Maximum: 100.
- **sort_by** (string) - Optional - How to sort results. Enum: relevance, newest.
- **license_type** (string) - Optional - License filter. Enum: commercial, editorial.
- **ai_generated** (boolean) - Optional - Include/Exclude AI generated content (only applicable to photos, pngs, psds, vectors, svgs, and videos). Examples: ai_generated=true: Show only AI-generated content; ai_generated=false: Show only non-AI-generated content.
- **print_friendly** (boolean) - Optional - Include/Exclude print friendly content (only applicable to svgs).
- **print_friendly_basic** (boolean) - Optional - Include/Exclude basic print friendly content (only applicable to svgs).
- **orientation** (string) - Optional - Orientation filter (only applicable to photos and pngs). Enum: horizontal, vertical, square, panoramic.
- **color** (string) - Optional - Filter results by hex color (not applicable to video or motion graphics). Example: #FF0000, #CCC, abc, aabbcc.
- **family_friendly** (boolean) - Optional - Filter explicit search terms (returns empty results for any explicit term).
- **duration** (string) - Optional - Filter by duration in seconds (only applicable to videos). Examples: Range: 30_90 (between 30 and 90 seconds); Exact: 90 (exactly 90 seconds).

### Request Example
GET /v2/account/123/resources?term=ocean&content_type=photo&page=1&per_page=10

### Response
#### Success Response (200)
- **page** (integer) - Current page number.
- **last_page** (integer) - Last page number.
- **per_page** (integer) - Number of results per page.
- **total_resources** (integer) - Total number of resources.
- **resources** (array) - List of resources. Each resource has:
  - **id** (integer) - Resource ID.
  - **content_type** (string) - Content type.
  - **tags** (array) - Keywords describing the resource. Only available for paid customers.
  - **title** (string) - Title of the resource. Nullable.
  - **ai_generated** (boolean) - Whether the resource was AI-generated. Only available for paid customers. Nullable.
  - **dimensions** (object) - Width and height of source file in pixels. Only available for paid customers. Nullable. Properties: width (integer), height (integer).
  - **file_metadata** (object) - File metadata. Properties: available_file_types (array of objects with extension and size_in_bytes), available_download_sizes (array of objects with id, width, height).
  - **thumbnail_dimensions** (object) - Width and height of thumbnail in pixels. Nullable.

#### Response Example
{
  "page": 1,
  "last_page": 5,
  "per_page": 100,
  "total_resources": 432,
  "resources": [
    {
      "id": 123456,
      "content_type": "photo",
      "tags": ["ocean", "beach"],
      "title": "Ocean sunset",
      "ai_generated": false,
      "dimensions": {
        "width": 1920,
        "height": 1080
      },
      "file_metadata": {
        "available_file_types": [
          {
            "extension": "jpg",
            "size_in_bytes": 204800
          }
        ],
        "available_download_sizes": [
          {
            "id": "small",
            "width": 640,
            "height": 360
          }
        ]
      },
      "thumbnail_dimensions": {
        "width": 640,
        "height": 360
      }
    }
  ]
}

#### Error Response (401)
- **description** (string) - Unauthorized. Content type: application/json. Schema: errors_map.
```

--------------------------------

### GET /v2/{account_id}/account/licenses

Source: https://www.vecteezy.com/api-docs/api/v2/swagger.json

Retrieves licenses for previously downloaded resources held by the API account. This endpoint does not count against any quotas.

```APIDOC
## GET /v2/{account_id}/account/licenses

### Description
Retrieves licenses for previously downloaded resources held by the API account. This endpoint does not count against any quotas.

### Method
GET

### Endpoint
/v2/{account_id}/account/licenses

### Parameters
#### Path Parameters
- **account_id** (integer) - Required - Your account ID.

#### Query Parameters
- **page** (integer) - Optional - Page number. Default: 1.
- **start_date** (string) - Optional - Last updated on or after date. Format: YYYY-MM-DD. Default: The first day of the current month.
- **end_date** (string) - Optional - Last updated on or before date. Format: YYYY-MM-DD. Default: Today.

### Response
#### Success Response (200)
- **current_page** (integer) - Current page number.
- **current_result_count** (integer) - Number of results on this page.
- **total_result_count** (integer) - Total number of results.
- **total_pages** (integer) - Total number of pages.
- **next_page_url** (string, nullable) - URL for the next page, if any.
- **previous_page_url** (string, nullable) - URL for the previous page, if any.
- **results** (array) - List of licenses.
  - **license_guid** (string, nullable) - License GUID.
  - **license_type** (string) - Type of license.
  - **last_updated** (string) - Last updated timestamp.
  - **resource** (object) - Resource details.
    - **id** (integer) - Resource ID.
    - **content_type** (string) - Content type.
    - **tags** (array) - Keywords describing the resource. Only available for paid customers.
    - **title** (string, nullable) - Title of the resource.
    - **ai_generated** (boolean, nullable) - Whether the resource was AI-generated. Only available for paid customers.
    - **dimensions** (object, nullable) - Width and height of source file in pixels. Only available for paid customers.
      - **width** (integer) - Width in pixels.
      - **height** (integer) - Height in pixels.
    - **file_metadata** (object) - File metadata.
      - **available_file_types** (array) - Available file types.
        - **extension** (string) - File extension.
        - **size_in_bytes** (integer) - File size in bytes.
      - **available_download_sizes** (array) - Available download sizes.
        - **id** (string) - Size ID.
        - **width** (integer) - Width in pixels.
        - **height** (integer) - Height in pixels.
    - **thumbnail_dimensions** (object, nullable) - Width and height of thumbnail in pixels.

#### Response Example
{
  "current_page": 1,
  "current_result_count": 1,
  "total_result_count": 1,
  "total_pages": 1,
  "next_page_url": null,
  "previous_page_url": null,
  "results": [
    {
      "license_guid": "abc123",
      "license_type": "royalty-free",
      "last_updated": "2025-01-01T00:00:00Z",
      "resource": {
        "id": 123,
        "content_type": "vector",
        "tags": ["nature", "tree"],
        "title": "Tree",
        "ai_generated": false,
        "dimensions": {
          "width": 1000,
          "height": 800
        },
        "file_metadata": {
          "available_file_types": [
            {
              "extension": "eps",
              "size_in_bytes": 2048
            }
          ],
          "available_download_sizes": [
            {
              "id": "small",
              "width": 500,
              "height": 400
            }
          ]
        },
        "thumbnail_dimensions": {
          "width": 200,
          "height": 160
        }
      }
    }
  ]
}

#### Unauthorized Response (401)
- **errors** (object) - Error details.
```

--------------------------------

### GET /v2/{account_id}/resources

Source: https://www.vecteezy.com/api-docs/api/v2/swagger.json

Retrieves resources matching filters. This endpoint uses the General quota type and returns a list of resources with their metadata. Note that thumbnail and preview URLs should not be stored and may become invalid.

```APIDOC
## GET /v2/{account_id}/resources

### Description
Retrieves resources matching filters. Quota type: General. General usage notes: Do not store thumbnail and preview URLs. Use them immediately or download the file to keep a local copy. URLs may become invalid if content is removed or inactivated.

### Method
GET

### Endpoint
/v2/{account_id}/resources

### Parameters
#### Path Parameters
- **account_id** (integer) - Required - Your account ID.

### Response
#### Success Response (200)
- **data** (array) - List of resources
  - **id** (integer) - Resource ID
  - **title** (string) - Resource title
  - **description** (string) - Resource description
  - **thumbnail_url** (string, nullable) - Thumbnail URL
  - **thumbnail_2x_url** (string, nullable) - Thumbnail 2x URL
  - **file_types** (array) - Available file types

#### Response Example
{
  "data": [
    {
      "id": 0,
      "title": "string",
      "description": "string",
      "thumbnail_url": "string",
      "thumbnail_2x_url": "string",
      "file_types": ["string"]
    }
  ]
}

#### Error Responses
- **401** - Unauthorized
- **403** - Download Failed
- **402** - Quota Exceeded
- **404** - Not Found
- **422** - Invalid File Size

```

--------------------------------

### GET /v2/{account_id}/account/info

Source: https://www.vecteezy.com/api-docs/api/v2/swagger.json

Retrieves general information about the account's quotas, including current call counts and limits for general and download operations. This endpoint does not count against any quotas.

```APIDOC
## GET /v2/{account_id}/account/info

### Description
Retrieves general information about the account's quotas, including current call counts and limits for general and download operations. This endpoint does not count against any quotas.

### Method
GET

### Endpoint
/v2/{account_id}/account/info

### Parameters
#### Path Parameters
- **account_id** (integer) - Required - Your account ID.

#### Query Parameters
- **months** (integer) - Optional - Number of months of call info. Default: 1. Minimum: 1, Maximum: 6.

### Response
#### Success Response (200)
- **current** (object) - Current quota usage.
  - **general** (object) - General quota usage.
    - **call_count** (integer) - Number of calls made.
    - **call_limit** (integer) - Call limit.
    - **hard_limit** (integer) - Hard limit.
  - **download** (object) - Download quota usage.
    - **call_count** (integer) - Number of calls made.
    - **call_limit** (integer) - Call limit.
    - **hard_limit** (integer) - Hard limit.
- **history** (array) - Historical quota usage.
  - **month** (string) - Month of the usage.
  - **general** (object) - General usage for that month.
    - **call_count** (integer) - Number of calls made.
  - **download** (object) - Download usage for that month.
    - **call_count** (integer) - Number of calls made.

#### Response Example
{
  "current": {
    "general": {
      "call_count": 10,
      "call_limit": 100,
      "hard_limit": 200
    },
    "download": {
      "call_count": 5,
      "call_limit": 50,
      "hard_limit": 100
    }
  },
  "history": [
    {
      "month": "2025-01",
      "general": {
        "call_count": 10
      },
      "download": {
        "call_count": 5
      }
    }
  ]
}

#### Unauthorized Response (401)
- **errors** (object) - Error details.
```

--------------------------------

### GET /v2/{account_id}/resources/{id}/download

Source: https://www.vecteezy.com/api-docs/api/v2/swagger.json

Retrieves the download URL for a resource. The download URL is signed and expires after 24 hours. Use the URL immediately to download the file and keep a local copy. The URL may become invalid if content is removed or inactivated.

```APIDOC
## GET /v2/{account_id}/resources/{id}/download

### Description
Retrieves the download URL for a resource. The download URL is signed and expires after 24 hours. Use the URL immediately to download the file and keep a local copy. The URL may become invalid if content is removed or inactivated.

### Method
GET

### Endpoint
/v2/{account_id}/resources/{id}/download

### Parameters
#### Path Parameters
- **account_id** (integer) - Required - Your account ID.
- **id** (integer) - Required - Numeric identifier

#### Query Parameters
- **file_type** (string) - Optional - File type to download as indicated in the file_types field from the GET resource response (jpg, png, svg, etc...). Optional if the resource is available in only a single file type, mandatory otherwise.
- **file_size** (string) - Optional - File size to download. Only available for paid customers. Allowed sizes for each content type:

**Photo:**
- **original** 
- **large** - 2400x
- **medium** - 1920x
- **small** - 640x


**Video:**
- **original** 
- **x-large** - 3840x2160
- **large** - 2560x1440
- **medium** - 1920x1080
- **small** - 1280x720
- **compressed** 



### Response
#### Success Response (200)
- **url** (string) - The download URL.
- **inline_url** (string) - The inline URL.
- **download_status_url** (string, nullable) - The URL to check download status.
- **requires_attribution** (boolean) - Whether attribution is required.
- **required_attribution_url** (string, nullable) - The attribution URL if required.
- **thumbnail_dimensions** (object, nullable) - Width and Height of thumbnail in pixels. Only available for paid customers.
  - **width** (integer) - Width in pixels.
  - **height** (integer) - Height in pixels.
- **thumbnail_url** (string, nullable) - The thumbnail URL.
- **thumbnail_2x_url** (string, nullable) - The 2x thumbnail URL.
- **preview_dimensions** (object, nullable) - Width and Height of preview image in pixels. Only available for paid customers.
  - **width** (integer) - Width in pixels.
  - **height** (integer) - Height in pixels.
- **preview_url** (string, nullable) - The preview URL.

#### Response Example
{
  "url": "https://example.com/download",
  "inline_url": "https://example.com/inline",
  "download_status_url": null,
  "requires_attribution": false,
  "required_attribution_url": null,
  "thumbnail_dimensions": {
    "width": 100,
    "height": 100
  },
  "thumbnail_url": "https://example.com/thumb.jpg",
  "thumbnail_2x_url": "https://example.com/thumb2x.jpg",
  "preview_dimensions": {
    "width": 500,
    "height": 500
  },
  "preview_url": "https://example.com/preview.jpg"
}

#### Error Responses
- **401** (Unauthorized) - Authentication failed.
- **404** (Not Found) - Resource not found.
- **402** (Quota Exceeded) - Quota exceeded.

### Headers
- **X-QUOTA-TYPE** (string) - The quota type used for the endpoint.
- **X-QUOTA-LIMIT** (integer) - The number of allowed requests in the current period that do not incur overage charges.
- **X-QUOTA-REMAINING** (integer) - The number of remaining requests in the current period that do not incur overage charges.
- **X-QUOTA-OVERAGE-CUTOFF** (integer) - The number of allowed requests in the current period.
- **X-QUOTA-OVERAGE-REMAINING** (integer) - The number of remaining requests in the current period.

### Security
- **bearerAuth** - Bearer token authentication required.

### Tags
- Resources

```

--------------------------------

### GET /v2/{account_id}/curated_resources

Source: https://www.vecteezy.com/api-docs/api/v2/swagger.json

Lists resources curated for your account by the Vecteezy content team. Results are ordered newest-first by curation time, with `id` descending as a tiebreaker for stable pagination. Use `added_since` to only receive resources curated since a previous request.

```APIDOC
## GET /v2/{account_id}/curated_resources

### Description
Lists resources curated for your account by the Vecteezy content team. Results are ordered newest-first by curation time, with `id` descending as a tiebreaker for stable pagination. Use `added_since` to only receive resources curated since a previous request.

### Method
GET

### Endpoint
/v2/{account_id}/curated_resources

### Parameters
#### Path Parameters
- **account_id** (integer) - Required - Your account ID.

#### Query Parameters
- **added_since** (string) - Optional - ISO 8601 timestamp. Only include resources first curated at or after this time. Example: 2026-05-01T00:00:00Z
- **page** (integer) - Optional - Current page. Default: 1. Minimum: 1.
- **per_page** (integer) - Optional - Results per page. Default: 100. Maximum: 100.

### Response
#### Success Response (200)
- **page** (integer) - Current page number.
- **last_page** (integer) - Last page number.
- **per_page** (integer) - Results per page.
- **total_resources** (integer) - Total number of resources.
- **resources** (array) - List of resources.
  - **id** (integer) - Resource ID.
  - **content_type** (string) - Content type of the resource.
  - **tags** (array) - Keywords describing the resource. Only available for paid customers.
  - **title** (string, nullable) - Title of the resource.
  - **ai_generated** (boolean, nullable) - Whether the resource was AI-generated. Only available for paid customers.
  - **dimensions** (object, nullable) - Width and height of source file in pixels. Only available for paid customers.
    - **width** (integer) - Width in pixels.
    - **height** (integer) - Height in pixels.
  - **file_metadata** (object) - File metadata.
    - **available_file_types** (array) - Available file types.
      - **extension** (string) - File extension.
      - **size_in_bytes** (integer) - File size in bytes.
    - **available_download_sizes** (array) - Available download sizes.
      - **id** (string) - Size ID.
      - **width** (integer) - Width in pixels.
      - **height** (integer) - Height in pixels.
  - **thumbnail_dimensions** (object, nullable) - Width and height of thumbnail in pixels. Only available for paid customers.
    - **width** (integer) - Width in pixels.
    - **height** (integer) - Height in pixels.
  - **thumbnail_url** (string, nullable) - URL of the thumbnail.
  - **thumbnail_2x_url** (string, nullable) - URL of the 2x thumbnail.
  - **preview_dimensions** (object, nullable) - Width and height of preview image in pixels. Only available for paid customers.
    - **width** (integer) - Width in pixels.
    - **height** (integer) - Height in pixels.
  - **preview_url** (string, nullable) - URL of the preview image.
  - **activated_at** (string, nullable) - When the resource was activated on Vecteezy (ISO 8601). Source field for resource_feed ordering.
  - **byline** (string) - Attribution string for syndication.

#### Response Example
{
  "page": 1,
  "last_page": 5,
  "per_page": 100,
  "total_resources": 432,
  "resources": [
    {
      "id": 12345,
      "content_type": "photo",
      "tags": ["nature", "landscape"],
      "title": "Mountain Sunset",
      "ai_generated": false,
      "dimensions": {"width": 1920, "height": 1080},
      "file_metadata": {
        "available_file_types": [{"extension": "jpg", "size_in_bytes": 204800}],
        "available_download_sizes": [{"id": "small", "width": 640, "height": 360}]
      },
      "thumbnail_dimensions": {"width": 320, "height": 180},
      "thumbnail_url": "https://example.com/thumb.jpg",
      "thumbnail_2x_url": "https://example.com/thumb2x.jpg",
      "preview_dimensions": {"width": 1280, "height": 720},
      "preview_url": "https://example.com/preview.jpg",
      "activated_at": "2026-05-01T00:00:00Z",
      "byline": "John Doe"
    }
  ]
}

#### Error Responses
- **401** (Unauthorized) - Authentication failed.
- **403** (Forbidden) - Content type not allowed for this account.
- **400** (Bad Request) - Invalid date range.
- **404** (Not Found) - Endpoint disabled for this account.

### Authentication
Requires bearer token authentication (bearerAuth).
```

--------------------------------

### GET /v2/{account_id}/resources/{id}/download_status

Source: https://www.vecteezy.com/api-docs/api/v2/swagger.json

Retrieves the status for a resized resource download. This endpoint is for internal API use only and is returned as part of the resized download response to check the status. The download URL expires after 24 hours and no quota is applied.

```APIDOC
## GET /v2/{account_id}/resources/{id}/download_status

### Description
Retrieves the status for a resized resource download. For internal API use only. Will be returned as part of the resized download response to check the status. Download URL expires after 24 hours. No quota applied to this endpoint.

### Method
GET

### Endpoint
/v2/{account_id}/resources/{id}/download_status

### Parameters
#### Path Parameters
- **account_id** (integer) - Required - Your account ID.
- **id** (integer) - Required - Numeric identifier

#### Query Parameters
- **data** (string) - Required - Encoded download data

### Response
#### Success Response (200)
- **url** (string) - Download URL
- **progress** (integer) - Download progress
- **requires_attribution** (boolean) - Whether attribution is required
- **required_attribution_url** (string, nullable) - Required attribution URL

#### Response Example
{
  "url": "string",
  "progress": 0,
  "requires_attribution": true,
  "required_attribution_url": "string"
}

#### Error Responses
- **401** - Unauthorized

```

--------------------------------

### GET /v2/{account_id}/resource_feed

Source: https://www.vecteezy.com/api-docs/api/v2/swagger.json

Lists resources of a content type activated within a date range. This endpoint must be enabled for your account and isn't available to everyone. Contact Vecteezy support to request access.

```APIDOC
## GET /v2/{account_id}/resource_feed

### Description
Lists resources of a content type activated within a date range. This endpoint must be enabled for your account and isn't available to everyone. Contact Vecteezy support to request access.

### Method
GET

### Endpoint
/v2/{account_id}/resource_feed

### Parameters
#### Path Parameters
- **account_id** (integer) - Required - Your account ID.

#### Query Parameters
- **start_time** (string) - Required - ISO 8601 timestamp. Inclusive lower bound on resource activation time. Example: 2026-05-01T00:00:00Z
- **end_time** (string) - Required - ISO 8601 timestamp. Inclusive upper bound on resource activation time. Example: 2026-05-20T00:00:00Z
- **content_type** (string) - Required - Content type filter (must be supported by your API Account). Enum: photo, png, psd, svg, vector, video
- **include_ai** (boolean) - Optional - Include AI generated content in the feed (excluded by default). Default: false
- **page** (integer) - Optional - Current page. Default: 1, Minimum: 1
- **per_page** (integer) - Optional - Results per page. Default: 100, Minimum: 1, Maximum: 100

### Response
#### Success Response (200)
- **page** (integer) - Current page number.
- **last_page** (integer) - Last page number.
- **per_page** (integer) - Results per page.
- **total_resources** (integer) - Total number of resources.
- **resources** (array) - List of resources.
  - **id** (integer) - Resource ID.
  - **content_type** (string) - Content type of the resource.
  - **tags** (array) - Keywords which describe the resource. Only available for paid customers.
  - **title** (string) - Title of the resource. Nullable.
  - **ai_generated** (boolean) - Whether or not the resource was AI-Generated. Only available for paid customers. Nullable.
  - **dimensions** (object) - Width and Height of source file in pixels. Only available for paid customers. Nullable.
    - **width** (integer) - Width in pixels.
    - **height** (integer) - Height in pixels.
  - **file_metadata** (object) - File metadata.
    - **available_file_types** (array) - Available file types.
      - **extension** (string) - File extension.
      - **size_in_bytes** (integer) - File size in bytes.
    - **available_download_sizes** (array) - Available download sizes.
      - **id** (string) - Download size ID.
      - **width** (integer) - Width in pixels.
      - **height** (integer) - Height in pixels.
  - **thumbnail_dimensions** (object) - Width and Height of thumbnail in pixels. Only available for paid customers. Nullable.
    - **width** (integer) - Width in pixels.
    - **height** (integer) - Height in pixels.
  - **thumbnail_url** (string) - Thumbnail URL. Nullable.
  - **thumbnail_2x_url** (string) - Thumbnail 2x URL. Nullable.
  - **preview_dimensions** (object) - Width and Height of preview image in pixels. Only available for paid customers. Nullable.
    - **width** (integer) - Width in pixels.
    - **height** (integer) - Height in pixels.
  - **preview_url** (string) - Preview URL. Nullable.
  - **activated_at** (string) - When the resource was activated on Vecteezy (ISO 8601). Source field for resource_feed ordering. Nullable.
  - **byline** (string) - Attribution string for syndication.

#### Response Example
```json
{
  "page": 1,
  "last_page": 1,
  "per_page": 100,
  "total_resources": 1,
  "resources": [
    {
      "id": 123,
      "content_type": "photo",
      "tags": ["nature", "landscape"],
      "title": "Example Resource",
      "ai_generated": false,
      "dimensions": {
        "width": 1920,
        "height": 1080
      },
      "file_metadata": {
        "available_file_types": [
          {
            "extension": "jpg",
            "size_in_bytes": 102400
          }
        ],
        "available_download_sizes": [
          {
            "id": "small",
            "width": 640,
            "height": 360
          }
        ]
      },
      "thumbnail_dimensions": {
        "width": 320,
        "height": 180
      },
      "thumbnail_url": "https://example.com/thumb.jpg",
      "thumbnail_2x_url": "https://example.com/thumb2x.jpg",
      "preview_dimensions": {
        "width": 1280,
        "height": 720
      },
      "preview_url": "https://example.com/preview.jpg",
      "activated_at": "2026-05-01T00:00:00Z",
      "byline": "Example Byline"
    }
  ]
}
```

#### Error Response (401)
- **description** (string) - Unauthorized. Authentication failed or missing credentials.

#### Error Response Example
```json
{
  "error": "Unauthorized"
}
```

### Authentication
- **bearerAuth** - Bearer token authentication required.

### Quota Type
General

### Availability
This endpoint must be enabled for your account and isn't available to everyone. Contact Vecteezy support to request access.

### General Usage Notes
- Filters by the resource's `activated_at` timestamp (when the resource became available on Vecteezy).
- Results are ordered by `activated_at` ascending, with `id` ascending as a tiebreaker for stable pagination.
- One content type per request. The content type must be supported by your API account.
- **Maximum date range is 7 days.**
- Do not store thumbnail and preview URLs. Use them immediately or download the file to keep a local copy.
```

--------------------------------

### POST /v2/{account_id}/track

Source: https://www.vecteezy.com/api-docs/api/v2/swagger.json

Tracks resource usage. Use this endpoint to report when a resource is licensed (usage_type: license) or being considered for licensing (usage_type: pre-license) in your integration. Aggregated counts of tracked usage are available from the track summary endpoint.

```APIDOC
## POST /v2/{account_id}/track

### Description
Tracks resource usage. Use this endpoint to report when a resource is licensed (usage_type: license) or being considered for licensing (usage_type: pre-license) in your integration. Aggregated counts of tracked usage are available from the track summary endpoint.

### Method
POST

### Endpoint
/v2/{account_id}/track

### Parameters
#### Path Parameters
- **account_id** (integer) - Required - Your account ID.

#### Query Parameters
- **resource_id** (integer) - Required - Resource id
- **search_term** (string) - Required - Search term
- **usage_type** (string) - Required - Usage type (pre-license or license). Allowed values: pre-license, license
- **usage_description** (string) - Required - Describe the usage (free-form)

### Response
#### Success Response (200)
- **ok** (boolean) - Success indicator

#### Error Responses
- **401** - Unauthorized
- **404** - Endpoint disabled for this account

```
Tokens:
Raw