# Fandom API

> Fandom returns fan wiki article summaries and facts as a workflow and API.

Fandom, also known as Wikia, returns a fan wiki article’s summary, infobox facts, headings, and links through Get wiki article. Get wiki article needs a topic and franchise; a Fandom wiki or article link can replace the franchise name.

- Page: https://fous.com/tools/fandom
- Handle: `@fandom`
- Category: [Entertainment](https://fous.com/tools/category/entertainment)
- Source website: https://fandom.com
- Last verified: Sep 29, 2026

## Methods

### Get wiki article

Operation `get_wiki_article`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Find a topic on the main English Fandom wiki for a franchise and return its article summary, infobox facts, headings, and links. A wiki or article link can be used instead of a franchise name.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `topic` | string | yes | `"Creeper"` | Character, item, episode, place, or topic to find, such as Darth Vader. |
| `franchise` | string | yes | `"Minecraft"` | Franchise, game, or show, such as Star Wars; a Fandom wiki or article link also works. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "franchise",
    "topic"
  ],
  "properties": {
    "topic": {
      "type": "string",
      "description": "Character, item, episode, place, or topic to find, such as Darth Vader.",
      "examples": [
        "Creeper",
        "Monkey D. Luffy",
        "Darth Vader"
      ]
    },
    "franchise": {
      "type": "string",
      "description": "Franchise, game, or show, such as Star Wars; a Fandom wiki or article link also works.",
      "examples": [
        "Minecraft",
        "https://onepiece.fandom.com/wiki/One_Piece",
        "Star Wars"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "topic": "Creeper",
      "franchise": "Minecraft"
    },
    {
      "topic": "Monkey D. Luffy",
      "franchise": "https://onepiece.fandom.com/wiki/One_Piece"
    },
    {
      "topic": "Darth Vader",
      "franchise": "Star Wars"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `summary` | string or null |  | First substantive paragraphs of the article as plain text. |
| `wiki_link` | string | `"https://minecraft.fandom.com"` | Link to the wiki homepage. |
| `wiki_name` | string | `"Minecraft Wiki"` | Name of the fan wiki. |
| `article_link` | string | `"https://minecraft.fandom.com/wiki/Creeper"` | Link to the article on Fandom. |
| `article_title` | string | `"Creeper"` | Title of the article, including the canonical title for a redirect. |
| `infobox_facts` | array |  | Facts shown in the article infobox. Empty if there is no infobox. |
| `infobox_facts[].label` | string | `"Health"` |  |
| `infobox_facts[].value` | string | `"20 × 10"` |  |
| `main_image_link` | string or null | `"https://static.wikia.nocookie.net/minecraft_gamepedia/images/5/5b/Creeper_JE2_BE1.png/revision/latest/scale-to-width-do` | Main article image link, when available. |
| `section_headings` | array |  | Section headings in article order. |

**Example input**

```json
{
  "topic": "Creeper",
  "franchise": "Minecraft"
}
```

**Example output**

```json
{
  "summary": "A creeper is a common hostile mob that silently approaches players and then explodes , which can destroy blocks and kill unarmored players on any difficulty (except for peaceful).\n\nWhen struck by ligh…",
  "wiki_link": "https://minecraft.fandom.com",
  "wiki_name": "Minecraft Wiki",
  "article_link": "https://minecraft.fandom.com/wiki/Creeper",
  "article_title": "Creeper",
  "infobox_facts": [
    {
      "label": "Health",
      "value": "20 × 10"
    },
    {
      "label": "Behavior",
      "value": "Hostile"
    },
    {
      "label": "Spawn",
      "value": "Light level of 0"
    }
  ],
  "main_image_link": "https://static.wikia.nocookie.net/minecraft_gamepedia/images/5/5b/Creeper_JE2_BE1.png/revision/latest/scale-to-width-down/268?cb=20191229172043",
  "section_headings": [
    "Spawning",
    "Drops",
    "Behavior"
  ]
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@fandom",
  "visibility": "public",
  "operation": "get_wiki_article",
  "version": 1,
  "input": {
    "topic": "Creeper",
    "franchise": "Minecraft"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@fandom\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_wiki_article\",\n  \"version\": 1,\n  \"input\": {\n    \"topic\": \"Creeper\",\n    \"franchise\": \"Minecraft\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@fandom",
  "visibility": "public",
  "operation": "get_wiki_article",
  "version": 1,
  "input": {
    "topic": "Creeper",
    "franchise": "Minecraft"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/fandom`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_wiki_article`: Get wiki article. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-fandom https://api.fous.com/mcp/tools/fandom --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Find character and episode summaries for franchise research
- Collect infobox facts about fictional characters and places
- Review article headings to map topics within a fan wiki
- Gather article links and images for editorial research

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Fandom tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Fandom account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from fandom.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

### What facts does an article show about a character?

Get wiki article returns the article summary and infobox facts for a topic in a specified franchise.

### What sections does a fan wiki article contain?

Get wiki article returns the section headings in article order for the topic and franchise.

### Can I look up an article using a wiki link?

Yes. Get wiki article accepts a Fandom wiki or article link instead of a franchise name.

## Related

- [Wikipedia API](https://fous.com/tools/wikipedia.md): Wikipedia returns article summaries, images, facts, relevant search matches, readable text and daily historical events, plus human-view counts from July 2015 onward.
- [Britannica API](https://fous.com/tools/britannica.md): Britannica returns public encyclopedia articles with introductions, quick facts, headings, update dates and images, plus search results with titles, descriptions, links and images when shown.
- [ESPN API](https://fous.com/tools/espn.md): ESPN provides daily scores and schedules, team results, player statistics, matchup summaries, and latest topic-specific headlines; coverage and published details vary, especially for college and soccer.
- [Medium API](https://fous.com/tools/medium.md): Medium returns public writer, publication, and topic articles, including newest posts and weekly popular picks, plus readable article text; member-only stories remain limited to visible previews.
- [Fox News API](https://fous.com/tools/fox-news.md): Fox News returns section-page headlines, keyword-matched articles among up to 100 available results, and readable article text, including the latest live-blog updates.
- [TMDB API](https://fous.com/tools/tmdb.md): TMDB returns movie and TV details, cast, trailers, releases, viewing services, scheduled upcoming movies, and up to 20 homepage trending titles; future episode details depend on published schedules.
- [World Health Organization API](https://fous.com/tools/world-health-organization.md): The World Health Organization provides public health information, latest outbreak reports, country health statistics with up to 10 years of history when available, and topic fact sheets.
- [Wikidata API](https://fous.com/tools/wikidata.md): Wikidata is a free public knowledge base returning facts and item lists about people, places, organizations, and more; values may be historical and dates incomplete.
- [All Entertainment tools](https://fous.com/tools/category/entertainment)