--- type: "firecrawl-provider" description: "Find app icons by name, color, style, category and platform, with image links and source attribution." use_when: "Search app icons, inspect image provenance and browse collection categories and platforms." categories: "Marketing" capabilities: 3 credits_per_call: 5 --- # Icons Computer on Firecrawl Alexandria Find app icons by name, color, style, category and platform, with image links and source attribution. - Categories: Marketing - Category index: [Marketing category](https://firecrawl.dev/alexandria/agents/categories/marketing) - Provider key: `icons-computer` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/icons-computer) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/icons-computer/openapi.json) ## Capabilities - [Search icons](https://firecrawl.dev/alexandria/agents/providers/icons-computer/icons/search): Icon summaries under results, alongside total, limit and offset. Advance offset by limit for the next page. - [Icon details](https://firecrawl.dev/alexandria/agents/providers/icons-computer/icons/detail): One icon with image URL, provenance and Markdown reference. Optional chartRank, chartCategory and appVersion depend on the source. - [Icon collection](https://firecrawl.dev/alexandria/agents/providers/icons-computer/icons/collection): Collection metadata, including categories and platforms as name/count pairs and the upstream rights notice. ## 1. Choose this provider when Search app icons, inspect image provenance and browse collection categories and platforms. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "icons-computer", "capability": "icons/search", "options": { "q": "", "sort": "featured", "limit": 24, "offset": 0 } } ``` ## 3. Add provider options Use only the options needed for the task: - `q` (string): App name or plain-language description, such as purple icons. Example: `` - `category` (string): Case-insensitive category: Books, Business, Development, Education, Entertainment, Finance, Food & Drink, Games, Graphics & Design, Health & Fitness, Lifestyle, Music, Navigation, News, Photo & Video, Productivity, Shopping, Social Networking, Sports, Travel, Utilities, Weather. Example: `` - `platform` (string): Case-insensitive platform: iOS, macOS, Windows, watchOS, visionOS. Example: `` - `sort` (string): Featured order, alphabetical or reverse alphabetical. With q, featured means best match first. Example: `featured` - `limit` (number): Icons per page, integer 1 to 100. Defaults to 24. Example: `24` - `offset` (number): Zero-based integer offset for pagination. Example: `0` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "icons-computer", capability: "icons/search", options: { q: "", sort: "featured", limit: 24, offset: 0, }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "icons-computer", "capability": "icons/search", "options": { "q": "", "sort": "featured", "limit": 24, "offset": 0 } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "icons-computer", "capability": "icons/search", "options": { "q": "", "sort": "featured", "limit": 24, "offset": 0 } } }' ``` ### CLI ```sh firecrawl scrape 'icons-computer/icons/search' \ --options '{"q":"","sort":"featured","limit":24,"offset":0}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "icons-computer", "capability": "icons/search", "options": { "q": "", "sort": "featured", "limit": 24, "offset": 0 } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "icons-computer", "capability": "icons/search", "options": { "q": "", "sort": "featured", "limit": 24, "offset": 0 } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "results": [ { "id": "", "name": "", "category": "", "platform": "", "publisher": "", "imageUrl": "", "width": 0, "height": 0, "featured": false, "pageUrl": "" } ] } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Search icons - Capability: `icons/search` - Description: Icon summaries under results, alongside total, limit and offset. Advance offset by limit for the next page. - Instructions: Find app icons by app name or a description such as purple icons or animal icon. Filter by category or platform. Default sort ranks query matches first. Each call costs 5 credits. - Cost: 5 credits per call - Capability file: [Search icons](https://firecrawl.dev/alexandria/agents/providers/icons-computer/icons/search) Accepted options: - `q` (string): App name or plain-language description, such as purple icons. Example: `` - `category` (string): Case-insensitive category: Books, Business, Development, Education, Entertainment, Finance, Food & Drink, Games, Graphics & Design, Health & Fitness, Lifestyle, Music, Navigation, News, Photo & Video, Productivity, Shopping, Social Networking, Sports, Travel, Utilities, Weather. Example: `` - `platform` (string): Case-insensitive platform: iOS, macOS, Windows, watchOS, visionOS. Example: `` - `sort` (string): Featured order, alphabetical or reverse alphabetical. With q, featured means best match first. Example: `featured` - `limit` (number): Icons per page, integer 1 to 100. Defaults to 24. Example: `24` - `offset` (number): Zero-based integer offset for pagination. Example: `0` Response schema example: ```json { "results": [ { "id": "", "name": "", "category": "", "platform": "", "publisher": "", "imageUrl": "", "width": 0, "height": 0, "featured": false, "pageUrl": "" } ] } ``` ### Icon details - Capability: `icons/detail` - Description: One icon with image URL, provenance and Markdown reference. Optional chartRank, chartCategory and appVersion depend on the source. - Instructions: Read one icon using its ID from search, including image dimensions, source links and an agent-ready Markdown reference. Each call costs 5 credits. - Cost: 5 credits per call - Capability file: [Icon details](https://firecrawl.dev/alexandria/agents/providers/icons-computer/icons/detail) Accepted options: - `id` (string, required): Stable icon ID from search, including mac- or win-prefixed IDs. Example: `` Response schema example: ```json { "id": "", "name": "", "category": "", "platform": "", "publisher": "", "imageUrl": "", "width": 0, "height": 0, "featured": false, "pageUrl": "", "sourceName": "", "source": "", "sourceUrl": "", "originalImageUrl": "", "format": "", "retrievedAt": "", "chartRank": 0, "chartCategory": "", "appVersion": "", "markdown": "" } ``` ### Icon collection - Capability: `icons/collection` - Description: Collection metadata, including categories and platforms as name/count pairs and the upstream rights notice. - Instructions: Get the collection's icon count, available categories and platforms with counts, methodology and rights notice. Each call costs 5 credits. - Cost: 5 credits per call - Capability file: [Icon collection](https://firecrawl.dev/alexandria/agents/providers/icons-computer/icons/collection) Accepted options: Response schema example: ```json { "title": "", "count": 0, "collectedAt": "<collectedAt>", "methodology": "<methodology>", "rights": "<rights>", "categories": [], "platforms": [] } ```