Superhero API Actor

Fetches detailed superhero profiles from the Superhero API. Use it to retrieve structured data on characters, including powerstats, biography, appearance, work, and connections. Supports searching by name or fetching a single hero by ID.

Key Features

• Flexible Search: Find multiple heroes by name or fetch a single profile by unique ID.
• Complete Profiles: Get detailed data across powerstats, biography, appearance, work, and connections.
• Structured JSON Output: Clean, ready-to-use data for applications, databases, or analysis.
• Built-in Reliability: Includes error handling with retries and clear messages.
• Performance Optimized: Uses sequential fetching with delays to respect rate limits.

How to Use

Configure the actor using input parameters. The main choice is between search mode (for multiple results) and id mode (for one specific hero).

Input Configuration

Note: The actor uses an embedded API token. For production, it's recommended to configure the token via environment variables or secrets for better security.

Input/Output

Output Data Structure

The actor outputs a collection of JSON objects. A full hero profile includes the following structure:

{
  "id": "123",
  "name": "Batman",
  "powerstats": {
    "intelligence": "100",
    "strength": "26",
    "speed": "27",
    "durability": "50",
    "power": "47",
    "combat": "100"
  },
  "biography": {
    "full-name": "Bruce Wayne",
    "aliases": ["Dark Knight", "The Caped Crusader"],
    "place-of-birth": "Gotham City",
    "first-appearance": "Detective Comics #27",
    "publisher": "DC Comics"
  },
  "appearance": {
    "gender": "Male",
    "race": "Human",
    "height": ["6'2", "188 cm"],
    "weight": ["210 lb", "95 kg"],
    "eye-color": "Blue",
    "hair-color": "Black"
  },
  "work": {
    "occupation": "Businessman",
    "base": "Gotham City; Batcave"
  },
  "connections": {
    "group-affiliation": "Batman Family, Justice League",
    "relatives": "Damian Wayne (son), Dick Grayson (adopted son)"
  },
  "image": "https://www.superherodb.com/pictures2/portraits/10/100/639.jpg",
  "source": "superheroapi.com"
}

In search mode with fetch_profile set to false, the output will contain only basic fields like id, name, and image.