---
title: "Image, Icon & Vector Search API"
slug: image-icon-vector-search-api
url: https://apyhub.com/skycraft/service/image-icon-vector-search-api
provider: Skycraft
tags: [image-search, icon-search, vector-search, screenshot, image-resizing, color-detection]
auth: api_key
version: 1.9.0
service_type: sync
endpoints: 3
atoms: 20
mcp: true
---

# Image, Icon & Vector Search API

Search icons, royalty-free images, and vectors, or capture screenshots and resize images. Returns structured asset metadata, colors, and binary image output.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/skycraft/image-icon-vector-search-api/search-icons` | What it does Searches for icons matching a text query and returns a JSON object containing an icons… | 20 |
| GET | `https://api.eu.apyhub.com/skycraft/image-icon-vector-search-api/search-images` | What it does Searches for royalty-free images matching a query string and returns a JSON object con… | 20 |
| GET | `https://api.eu.apyhub.com/skycraft/image-icon-vector-search-api/search-vectors` | What it does Searches for vectors matching a text query and returns a JSON object containing a vect… | 20 |

## Endpoint reference

### Search Icons API

`GET https://api.eu.apyhub.com/skycraft/image-icon-vector-search-api/search-icons` · 20 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `query` | query | string | yes | Example: `cars`. |
| `number` | query | integer (int32) | no | Example: `3`. |
| `only-public-domain` | query | boolean | no | Example: `true`. |

#### Quickstart

Search for icons with a required query string.

```bash
curl -X GET "https://api.eu.apyhub.com/skycraft/image-icon-vector-search-api/search-icons?query=bicycle" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with an `icons` array. Each item in `icons` is an object that can include `id`, `url`, `license` (`link`, `name`), and `thumbnail`.

```json
{
  "icons": [
    {
      "id": 1294,
      "url": "https://img.apileague.com/icons/10372458.svg",
      "thumbnail": "https://img.apileague.com/icons/10372458.svg",
      "license": {
        "name": "ATTRIBUTION",
        "link": null
      }  
     ]
    }
```

### Search Royalty Free Images API

`GET https://api.eu.apyhub.com/skycraft/image-icon-vector-search-api/search-images` · 20 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `query` | query | string | yes | Example: `dogs`. |
| `number` | query | integer (int32) | no | Example: `3`. |

#### Quickstart

Search for images by query. The `query` parameter is required, and `number` lets you limit how many results come back.

```bash
curl -X GET "https://api.eu.apyhub.com/skycraft/image-icon-vector-search-api/search-images?query=dogs&number=3" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with an `images` array. Each item in `images` is an object that can include `id`, `url`, `width`, `height`, `license`, and `thumbnail`.

```json
{
  "images": [
    {
      "url": "https://images.unsplash.com/photo-1552053831-71594a27632d?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w5NTgyNnwwfDF8c2VhcmNofDF8fGRvZ3N8ZW58MHx8fHwxNzkwNjgxMDI2fDA&ixlib=rb-4.1.0&q=80&w=1080",
      "thumbnail": "https://images.unsplash.com/photo-1552053831-71594a27632d?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w5NTgyNnwwfDF8c2VhcmNofDF8fGRvZ3N8ZW58MHx8fHwxNzkwNjgxMDI2fDA&ixlib=rb-4.1.0&q=80&w=200",
      "width": 3742,
      "height": 6000,
      "license": {
        "name": "FREE",
        "link": "https://unsplash.com/license"
      },
      "id": "Sg3XwuEpybU"
    }
  ]
}
```

### Vector Search API

`GET https://api.eu.apyhub.com/skycraft/image-icon-vector-search-api/search-vectors` · 20 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `query` | query | string | yes | Example: `airplanes`. |
| `number` | query | integer (int32) | no | Example: `3`. |
| `offset` | query | integer (int32) | no | Example: `0`. |

#### Quickstart

Search vector results for a query term; this minimal example sends the required `query` as a URL parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/skycraft/image-icon-vector-search-api/search-vectors?query=airplane" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `vectors` array. Each item in `vectors` is an object that may include `title`, `author`, `license`, and `image_url` fields.

```json
{
  "vectors": [
    {
      "title": "Flying Airplane",
      "license": "ATTRIBUTION",
      "author": "Danil Polshin",
      "image_url": "https://img.apileague.com/icons/7444511.svg"
    }
  ]
}
```

## About

## What it does
Media Search Tools helps you find and work with visual assets through simple HTTP endpoints. You can search for icons, royalty-free images, and vectors by query, then receive structured results with IDs, dimensions, URLs, thumbnails, and license details where available.

Use `search-icons`, `search-images`, and `search-vectors` when your app needs asset discovery from a keyword like `cars`, `dogs`, or `airplans`. The search endpoints accept `query` and optional `number`; vector search also supports `offset`. The icon search endpoint can also filter to public-domain results with `only-public-domain`.

For image workflows, `detect-color` takes an image `url` and returns an array with `hex_code`, `main_color`, and `specific_color` values. `take-screenshot` captures a web page from a `url` at the `width` and `height` you provide and returns a binary image. `rescale-image` takes an image `url` plus `width`, `height`, and `crop`, then returns the resized image as binary output.

Media Search Tools fits catalog browsing, content generation, asset previews, and lightweight image processing in systems that need visual references or transformed image files without building those features from scratch.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/skycraft/service/image-icon-vector-search-api