Unlock Icon Search Capabilities with Unofficial Icons8 Actions

22 Apr 2025
Unlock Icon Search Capabilities with Unofficial Icons8 Actions

Integrating iconography into applications can enhance user experience and interface design. The Unofficial Icons8 Search provides developers with a powerful way to access a wide array of icons easily. With the included Cognitive Actions, you can perform searches within the Icons8 repository to retrieve desired icons based on specific terms and parameters. This article will guide you through utilizing these actions effectively, allowing you to implement icon search functionality in your applications seamlessly.

Prerequisites

Before you dive into the integration of Cognitive Actions, ensure you have the following:

  • An API key for the Icons8 Cognitive Actions platform in order to authenticate your requests.
  • Basic familiarity with making HTTP requests and handling JSON data in your application.

To authenticate, you will typically pass your API key in the request headers. Below is a conceptual overview of how authentication might be handled.

Cognitive Actions Overview

Search Icons8 Repository

Description: This action performs a search operation within the Icons8 repository to retrieve desired icons based on specified search terms and parameters.

Category: search-operations

Input

The input for this action requires a JSON object that includes the following fields:

  • searchTerm (required): The keyword or phrase used for searching (default is "apple").
  • requestSize (optional): Specifies the size of the request in kilobytes (default is 64).
  • resultLimit (optional): Maximum number of results to return (default is 20).
  • displayColor (optional): Hexadecimal color code for display purposes (default is "ff0000").
  • resultOffset (optional): The number of records to skip before starting to return results (default is 0).

Example Input:

{
  "searchTerm": "apple",
  "requestSize": 64,
  "resultLimit": 20,
  "displayColor": "ff0000",
  "resultOffset": 0
}

Output

The output of this action typically returns a JSON object that includes:

  • data: Contains an array of icons matching the search criteria.
  • success: A boolean indicating whether the search was successful.
  • parameters: Provides details about the search term, amount of results, and other related information.

Example Output:

{
  "data": {
    "icons": [
      {
        "id": 30659,
        "link": "https://img.icons8.com/ios7/64/ff0000/apple.png",
        "name": "Apple Inc",
        "isFree": true,
        "isColor": false,
        "category": "Logos,Operating Systems",
        "platform": "ios7",
        "commonName": "mac-os",
        "isExplicit": false,
        "subcategory": "Apple",
        "sourceFormat": "svg",
        "authorApiCode": "icons8"
      },
      // Additional icon objects...
    ],
    "success": true,
    "parameters": {
      "term": "apple",
      "amount": 20,
      "offset": 0,
      "countAll": 4488,
      "language": "en",
      "foundLanguage": "en",
      "searchTranslations": {
        "ar": "نظام تشغيل ماك",
        "de": "Mac OS",
        "en": "Apple Inc",
        // Additional translations...
      }
    }
  }
}

Conceptual Usage Example (Python)

Here's how you might call the Search Icons8 Repository action using Python. This example illustrates how to structure your input payload and make a request to the hypothetical Cognitive Actions execution endpoint.

import requests
import json

# Replace with your Cognitive Actions API key and endpoint
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute" # Hypothetical endpoint

action_id = "630521f2-6c46-43f2-9e1a-0201dfb8fcb4" # Action ID for Search Icons8 Repository

# Construct the input payload based on the action's requirements
payload = {
    "searchTerm": "apple",
    "requestSize": 64,
    "resultLimit": 20,
    "displayColor": "ff0000",
    "resultOffset": 0
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json"
}

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json={"action_id": action_id, "inputs": payload} # Hypothetical structure
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully:")
    print(json.dumps(result, indent=2))

except requests.exceptions.RequestException as e:
    print(f"Error executing action {action_id}: {e}")
    if e.response is not None:
        print(f"Response status: {e.response.status_code}")
        try:
            print(f"Response body: {e.response.json()}")
        except json.JSONDecodeError:
            print(f"Response body: {e.response.text}")

In this Python code snippet, replace "YOUR_COGNITIVE_ACTIONS_API_KEY" with your actual API key. The action_id is set to the ID of the Search Icons8 Repository action. The input payload is defined according to the action's schema, and a request is made to the execution endpoint.

Conclusion

The Unofficial Icons8 Search Cognitive Action allows developers to effortlessly integrate icon search functionality into their applications. By utilizing the search capabilities of the Icons8 repository, you can enhance your applications with visually appealing icons tailored to your needs. Explore different search terms, parameters, and display options to unlock the full potential of this action. Start implementing it today, and elevate your application's UI with stunning icons!

← Back to All Articles