# Public Commons Media Search

## Links

- Product page URL: https://www.agentpmt.com/marketplace/public-commons-media-search
- Product markdown URL: https://www.agentpmt.com/marketplace/public-commons-media-search?format=agent-md
- Product JSON URL: https://www.agentpmt.com/marketplace/public-commons-media-search?format=agent-json

## Overview

- Product ID: 696ef640fb2f7d26fd1ef7ab
- Vendor: Apoth3osis
- Type: function
- Unit type: request
- Price: 500 credits
- Categories: Web Scraping & Data Collection, Synthetic Data Generation, Automation, 3D Design & Modeling, Graphic Design & Layout, Image Generation & Manipulation, Stock Media & Asset Libraries, Marketing Automation, Task & Workflow Automation, Academic & Scientific Research
- Generated at: 2026-04-15T18:35:31.937Z

### Page Description

Let AI agents search Wikipedia and Wikimedia Commons to discover and download free images, audio, video, and other public media assets. The tool provides simple actions for page title search, listing media on a page, fetching file URLs (thumbnail, preferred, original), and direct Commons media search with pagination, enabling agentic content sourcing and research workflows with clear file description and licensing context.

### Agent Description

Search Wikipedia and Wikimedia Commons for free images, audio, video. Get file URLs and licensing info. Supports pagination.

## Details Tab

### Details

Let AI agents search Wikipedia and Wikimedia Commons to discover and download free images, audio, video, and other public media assets. The tool provides simple actions for page title search, listing media on a page, fetching file URLs (thumbnail, preferred, original), and direct Commons media search with pagination, enabling agentic content sourcing and research workflows with clear file description and licensing context.

### Actions

- `search_titles` (5 credits): Search Wikipedia for article titles matching a query. Returns matching pages with title, description, and excerpt.
- `list_page_media` (5 credits): List all media files (images, audio, video) embedded on a specific Wikipedia page.
- `get_file` (5 credits): Retrieve detailed file metadata and URLs (original, preferred, thumbnail) for a specific media file.
- `search_commons_media` (5 credits): Search Wikimedia Commons directly for media files (images, audio, video, SVGs). Supports pagination for browsing large result sets.

### Use Cases

Agentic media discovery, Search Wikimedia Commons files by keyword, Find free images for articles, Retrieve media download URLs, Check file description and license pages, Collect public media assets for presentations, Build datasets of public images, Source audio or video clips for projects

### Workflows Using This Tool

No public workflows currently reference this product.

### Related Content

No related content is currently linked to this product.

## Advanced Tab

### DynamicMCP

- Setup page URL: https://www.agentpmt.com/dynamic-mcp
- Claude setup guide: https://www.agentpmt.com/dynamic-mcp?platform=claude#videos
- ChatGPT setup guide: https://www.agentpmt.com/dynamic-mcp?platform=chatgpt#videos
- Cursor setup guide: https://www.agentpmt.com/dynamic-mcp?platform=cursor#videos
- Windsurf setup guide: https://www.agentpmt.com/dynamic-mcp?platform=windsurf#videos

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections. This lightweight connector routes requests to `https://api.agentpmt.com/mcp`. All tool execution happens in the cloud and the server cannot edit any files on your computer.

```bash
npm install -g @agentpmt/mcp-router
agentpmt-setup
```

### REST API

The live page renders cURL, Python, JavaScript, and Node.js examples. Logged-in users see those examples prefilled with their own API and budget credentials.

- Purchase endpoint: https://api.agentpmt.com/products/purchase
- Authorization format: `Bearer <base64(apiKey:budgetKey)>`

```bash
curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eW91ci1hcGkta2V5LWhlcmU6eW91ci1idWRnZXQta2V5LWhlcmU=" \
  -d '{
    "product_id": "696ef640fb2f7d26fd1ef7ab",
    "parameters": {
      "action": "search_titles",
      "q": "example_q",
      "project": "wikipedia",
      "language": "en",
      "limit": 50
    }
  }'
```

### Autonomous Agents

Do not use the abbreviated instructions in this product markdown for wallet-based invocation. Retrieve the full External Agent API markdown document instead.

- External Agent API page URL: https://www.agentpmt.com/external-agent-api
- External Agent API markdown URL: https://www.agentpmt.com/external-agent-api?format=agent-md

### Schema

#### Parameters

- Schema type: actions

```json
{
  "actions": {
    "search_titles": {
      "description": "Search Wikipedia for article titles matching a query. Returns matching pages with title, description, and excerpt.",
      "properties": {
        "q": {
          "type": "string",
          "description": "Search query string.",
          "required": true
        },
        "project": {
          "type": "string",
          "description": "Wikimedia project (e.g., 'wikipedia'). Must not be 'commons' for this action.",
          "required": false,
          "default": "wikipedia"
        },
        "language": {
          "type": "string",
          "description": "Language code (e.g., 'en', 'fr', 'de').",
          "required": false,
          "default": "en"
        },
        "limit": {
          "type": "integer",
          "description": "Maximum number of results to return.",
          "required": false,
          "default": 50,
          "minimum": 1,
          "maximum": 50
        }
      }
    },
    "list_page_media": {
      "description": "List all media files (images, audio, video) embedded on a specific Wikipedia page.",
      "properties": {
        "title": {
          "type": "string",
          "description": "Canonical page title (e.g., 'Solar_eclipse', 'Golden_Gate_Bridge').",
          "required": true
        },
        "project": {
          "type": "string",
          "description": "Wikimedia project (e.g., 'wikipedia'). Must not be 'commons' for this action.",
          "required": false,
          "default": "wikipedia"
        },
        "language": {
          "type": "string",
          "description": "Language code (e.g., 'en', 'fr', 'de').",
          "required": false,
          "default": "en"
        }
      }
    },
    "get_file": {
      "description": "Retrieve detailed file metadata and URLs (original, preferred, thumbnail) for a specific media file.",
      "properties": {
        "file_title": {
          "type": "string",
          "description": "Full file title including the 'File:' prefix (e.g., 'File:Example.jpg').",
          "required": true
        },
        "project": {
          "type": "string",
          "description": "Wikimedia project. Set to 'commons' when the file is hosted on Wikimedia Commons.",
          "required": false,
          "default": "wikipedia"
        },
        "language": {
          "type": "string",
          "description": "Language code (e.g., 'en'). Required when project is not 'commons'.",
          "required": false,
          "default": "en"
        }
      }
    },
    "search_commons_media": {
      "description": "Search Wikimedia Commons directly for media files (images, audio, video, SVGs). Supports pagination for browsing large result sets.",
      "properties": {
        "q": {
          "type": "string",
          "description": "Search query string.",
          "required": true
        },
        "limit": {
          "type": "integer",
          "description": "Maximum number of results to return.",
          "required": false,
          "default": 50,
          "minimum": 1,
          "maximum": 50
        },
        "offset": {
          "type": "integer",
          "description": "Pagination offset. Use the next_offset value from a previous response to get the next page.",
          "required": false,
          "default": 0,
          "minimum": 0
        }
      }
    }
  },
  "properties": {
    "action": {
      "type": "string",
      "description": "Action to perform",
      "required": true,
      "default": "search_titles",
      "enum": [
        "get_instructions",
        "search_titles",
        "list_page_media",
        "get_file",
        "search_commons_media"
      ]
    },
    "file_title": {
      "type": "string",
      "description": "File title including 'File:' prefix (used by get_file)",
      "required": false
    },
    "language": {
      "type": "string",
      "description": "Language code (e.g., 'en'). Not used for Commons.",
      "required": false,
      "default": "en"
    },
    "limit": {
      "type": "integer",
      "description": "Maximum results to return (search_titles, search_commons_media)",
      "required": false,
      "default": 50,
      "minimum": 1,
      "maximum": 50
    },
    "offset": {
      "type": "integer",
      "description": "Pagination offset for search_commons_media",
      "required": false,
      "minimum": 0
    },
    "project": {
      "type": "string",
      "description": "Wikimedia project (e.g., 'wikipedia'). Use 'commons' only for get_file when file_description_url indicates Commons.",
      "required": false,
      "default": "wikipedia"
    },
    "q": {
      "type": "string",
      "description": "Search query string (used by search_titles and search_commons_media)",
      "required": false
    },
    "title": {
      "type": "string",
      "description": "Canonical page title (used by list_page_media)",
      "required": false
    }
  }
}
```

### Usage Instructions

# Public Commons Media Search

Search Wikipedia and Wikimedia Commons to discover public media assets, find article titles, list media on pages, and retrieve file URLs with metadata.

## Actions

### search_titles

Search Wikipedia for article titles matching a query.

**Required fields:**
- `action`: `"search_titles"`
- `q`: Search query string

**Optional fields:**
- `project`: Wikimedia project (default: `"wikipedia"`). Must NOT be `"commons"`.
- `language`: Language code (default: `"en"`)
- `limit`: Maximum results, 1-50 (default: 50)

**Example:**
```json
{
  "action": "search_titles",
  "q": "solar eclipse",
  "language": "en",
  "limit": 10
}
```

Returns a list of matching pages with title, description, and excerpt.

---

### list_page_media

List all media files (images, audio, video) embedded on a specific Wikipedia page.

**Required fields:**
- `action`: `"list_page_media"`
- `title`: Canonical page title (e.g., `"Solar_eclipse"`)

**Optional fields:**
- `project`: Wikimedia project (default: `"wikipedia"`). Must NOT be `"commons"`.
- `language`: Language code (default: `"en"`)

**Example:**
```json
{
  "action": "list_page_media",
  "title": "Golden_Gate_Bridge",
  "language": "en"
}
```

Returns a list of media items found on the page.

---

### get_file

Retrieve detailed file metadata and URLs (original, preferred, thumbnail) for a specific media file.

**Required fields:**
- `action`: `"get_file"`
- `file_title`: Full file title including the `File:` prefix (e.g., `"File:Example.jpg"`)

**Optional fields:**
- `project`: Wikimedia project (default: `"wikipedia"`). Set to `"commons"` when the file is hosted on Wikimedia Commons.
- `language`: Language code (default: `"en"`). Required when project is not `"commons"`.

**Example — Wikipedia file:**
```json
{
  "action": "get_file",
  "file_title": "File:Golden_Gate_Bridge_20100906.jpg",
  "project": "wikipedia",
  "language": "en"
}
```

**Example — Commons file:**
```json
{
  "action": "get_file",
  "file_title": "File:Hubble_ultra_deep_field.jpg",
  "project": "commons"
}
```

Returns the file title, description URL, and links to original, preferred, and thumbnail versions of the file.

---

### search_commons_media

Search Wikimedia Commons directly for media files (images, audio, video, SVGs). Supports pagination for browsing large result sets.

**Required fields:**
- `action`: `"search_commons_media"`
- `q`: Search query string

**Optional fields:**
- `limit`: Maximum results, 1-50 (default: 50)
- `offset`: Pagination offset (default: 0). Use the `next_offset` value from a previous response to get the next page.

**Example:**
```json
{
  "action": "search_commons_media",
  "q": "northern lights aurora",
  "limit": 10
}
```

**Pagination example:**
```json
{
  "action": "search_commons_media",
  "q": "northern lights aurora",
  "limit": 10,
  "offset": 10
}
```

Returns matching file titles, page IDs, and text snippets. Includes `next_offset` when more results are available.

---

## Common Workflows

### Find and download a Wikipedia image
1. Use `search_titles` to find the article (e.g., `"q": "Eiffel Tower"`)
2. Use `list_page_media` with the returned title to see all media on the page
3. Use `get_file` with the desired `file_title` (include the `File:` prefix) to get the direct URL

### Search Commons for stock-style media
1. Use `search_commons_media` with a descriptive query (e.g., `"q": "sunset over ocean"`)
2. Pick a result and use `get_file` with `project` set to `"commons"` and the file title to get URLs

### Browse media in another language
- Set `language` to any valid code (e.g., `"fr"`, `"de"`, `"ja"`) when using `search_titles`, `list_page_media`, or `get_file` with Wikipedia

## Important Notes

- The `file_title` parameter must always include the `File:` prefix (e.g., `"File:Example.png"`).
- The `project` parameter should be set to `"commons"` only for `get_file` when the file is hosted on Wikimedia Commons. For `search_titles` and `list_page_media`, use `"wikipedia"` (the default).
- `search_commons_media` always searches Wikimedia Commons regardless of the `project` or `language` settings.
- All media found through this tool is from Wikimedia projects and is generally available under open licenses (Creative Commons, public domain, etc.). Always check the file description page for specific license terms.
- Results are capped at 50 per request. Use `offset` with `search_commons_media` to paginate through larger result sets.

### About The Developer

- Vendor name: Apoth3osis
- Website: apoth3osis.io

We build tools that enable AI agents to excel in the mathematical realm.

Our small team develops experimental and unique solutions in the AI arena, with a strong focus on modular computing for agentic applications and custom model deployment. We have handled projects for a variety of applications across many sectors, from algorithmic trading and financial analysis, to molecular simulations and predictions, to habitat and biodiversity monitoring and wildlife conservation.

### Frequently Asked Questions

No linked FAQs are currently available.

### Dependencies

This product has no public dependency products.