# Getty Images Integration via LowCodeAPI

## Overview

Getty Images API provides access to millions of high-quality stock images, videos, and media assets. Search, download, and license premium visual content for your applications, websites, and creative projects.

## Base Endpoint

```
https://api.lowcodeapi.com/gettyimages/
```

## Authentication

LowCodeAPI handles authentication automatically. You only need to:

1. **Sign up** at [Getty Images API](https://www.gettyimages.com/creative/api)
2. **Create an app** and get your access token
3. **Connect your account** in LowCodeAPI dashboard
4. **Use your `api_token`** in all requests

The `api_token` is your LowCodeAPI authentication token. LowCodeAPI will automatically:
- Fetch your Getty Images access token from the database
- Apply it as a Bearer token to each request

**Auth Type**: OAuth2.0 (Bearer Token)

## API Categories

- **Media & Assets** - Stock photos, images, videos, and media asset services

## Common Endpoints

### Category: Search

#### Search Images

**Method**: `GET` | **LowCodeAPI Path**: `/v3/search/images`

**Full URL**:
```
https://api.lowcodeapi.com/gettyimages/v3/search/images?api_token={api_token}
```

**Description**: Search for images using various filters and parameters

**Query Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phrase` | string | No | Search query string |
| `page` | number | No | Page number for results |
| `page_size` | number | No | Number of results per page |
| `api_token` | string | Yes | Your LowCodeAPI authentication token |

**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/gettyimages/v3/search/images?phrase=nature&page_size=10&api_token=YOUR_API_TOKEN"
```

**Official Documentation**: [https://developers.gettyimages.com/api/](https://developers.gettyimages.com/api/)

---

#### Search Videos

**Method**: `GET` | **LowCodeAPI Path**: `/v3/search/videos`

**Full URL**:
```
https://api.lowcodeapi.com/gettyimages/v3/search/videos?api_token={api_token}
```

**Description**: Search for video clips and footage

**Query Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phrase` | string | No | Search query string |
| `page` | number | No | Page number for results |
| `page_size` | number | No | Number of results per page |
| `api_token` | string | Yes | Your LowCodeAPI authentication token |

**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/gettyimages/v3/search/videos?phrase=beach&api_token=YOUR_API_TOKEN"
```

**Official Documentation**: [https://developers.gettyimages.com/api/](https://developers.gettyimages.com/api/)

---

### Category: Images

#### Get Image Details

**Method**: `GET` | **LowCodeAPI Path**: `/v3/images/id`

**Full URL**:
```
https://api.lowcodeapi.com/gettyimages/v3/images/id?id={id}&api_token={api_token}
```

**Description**: Get detailed information about a specific image

**Query Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The Getty Images image ID |
| `api_token` | string | Yes | Your LowCodeAPI authentication token |

**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/gettyimages/v3/images/id?id=123456789&api_token=YOUR_API_TOKEN"
```

**Official Documentation**: [https://developers.gettyimages.com/api/](https://developers.gettyimages.com/api/)

---

## Usage Examples

### Example 1: Image Search and Download

This example demonstrates searching for images and getting details:

```bash
# Step 1: Search for images
# No ID required - returns search results with image IDs
curl -X GET "https://api.lowcodeapi.com/gettyimages/v3/search/images?phrase=sunset&page_size=5&api_token=YOUR_API_TOKEN"

# Step 2: Get detailed information about a specific image
# Replace IMAGE_ID with an ID from search results
curl -X GET "https://api.lowcodeapi.com/gettyimages/v3/images/id?id=IMAGE_ID&api_token=YOUR_API_TOKEN"
```

### Example 2: Video Search

```bash
# Search for video footage
# No ID required - returns video search results
curl -X GET "https://api.lowcodeapi.com/gettyimages/v3/search/videos?phrase=city+timelapse&api_token=YOUR_API_TOKEN"
```

## Complete Endpoint Reference

For a complete list of all endpoints and their parameters, refer to:
- **OpenAPI Definition**: `https://backend.lowcodeapi.com/gettyimages/definition`
- **Official Provider Documentation**: [https://developers.gettyimages.com/api/](https://developers.gettyimages.com/api/)

## Rate Limits & Best Practices

- Check your API plan for rate limits
- Use specific search terms to get better results
- Implement caching for frequently accessed images

## Error Handling

Standard HTTP status codes apply