--- type: "firecrawl-provider" description: "Find Open Graph images and videos by brand, site, category and page type, with image links, content hashes and source attribution." use_when: "Search Open Graph images, inspect image provenance and history, pull changes since a timestamp and browse collection categories and page types." categories: "Marketing" capabilities: 3 credits_per_call: 5 --- # OG Computer on Firecrawl Alexandria Find Open Graph images and videos by brand, site, category and page type, with image links, content hashes and source attribution. - Categories: Marketing - Category index: [Marketing category](https://alexandria.firecrawl.dev/agents/categories/marketing) - Provider key: `og-computer` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://www.firecrawl.dev/app/alexandria/og-computer) - [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/og-computer/openapi.json) ## Capabilities - [Search Open Graph images](https://alexandria.firecrawl.dev/agents/providers/og-computer/ogs/search): Card summaries under results, alongside total, limit and nextCursor. Pass nextCursor as cursor for the next page. - [Open Graph image details](https://alexandria.firecrawl.dev/agents/providers/og-computer/ogs/detail): One card with image URLs, hashes, provenance and history. - [Open Graph collection](https://alexandria.firecrawl.dev/agents/providers/og-computer/ogs/collection): Collection metadata, including categories and page types as name/count pairs and the upstream rights notice. ## 1. Choose this provider when Search Open Graph images, inspect image provenance and history, pull changes since a timestamp and browse collection categories and page types. ## 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": "og-computer", "capability": "ogs/search", "options": { "q": "", "sort": "featured", "limit": 24 } } ``` ## 3. Add provider options Use only the options needed for the task: - `q` (string): Brand, site, or description words. Example: `` - `category` (string): Case-insensitive category name from ogs/collection. Example: `` - `pageType` (string): Case-insensitive page type from ogs/collection. Example: `` - `kind` (string): Image or video cards. Example: `image` - `site` (string): Exact siteDomain, such as linear.app. Example: `` - `sort` (string): Featured order (best match first with q), newest added first, or newest updated_at first. Example: `featured` - `since` (string): Only cards whose updated_at is after this ISO 8601 date or timestamp. Example: `` - `limit` (number): Cards per page, integer 1 to 100. Defaults to 24. Example: `24` - `cursor` (string): The nextCursor from a previous response. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "og-computer", capability: "ogs/search", options: { q: "", sort: "featured", limit: 24, }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "og-computer", "capability": "ogs/search", "options": { "q": "", "sort": "featured", "limit": 24 } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "og-computer", "capability": "ogs/search", "options": { "q": "", "sort": "featured", "limit": 24 } } }' ``` ### CLI ```sh firecrawl scrape 'og-computer/ogs/search' \ --options '{"q":"","sort":"featured","limit":24}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "og-computer", "capability": "ogs/search", "options": { "q": "", "sort": "featured", "limit": 24 } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "og-computer", "capability": "ogs/search", "options": { "q": "", "sort": "featured", "limit": 24 } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "results": [ { "id": "", "kind": "", "brand": "", "title": "", "domain": "<domain>", "siteDomain": "<siteDomain>", "category": "<category>", "pageType": "<pageType>", "featured": false, "width": 0, "height": 0, "imageUrl": "<imageUrl>", "thumbUrl": "<thumbUrl>", "videoUrl": "<videoUrl>", "posterUrl": "<posterUrl>", "duration": 0, "pageUrl": "<pageUrl>", "canonicalUrl": "<canonicalUrl>", "sha256": "<sha256>", "phash": "<phash>", "sourceName": "<sourceName>", "source": "<source>", "addedAt": "<addedAt>", "updated_at": "<updated_at>" } ] } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Search Open Graph images - Capability: `ogs/search` - Description: Card summaries under results, alongside total, limit and nextCursor. Pass nextCursor as cursor for the next page. - Instructions: Find Open Graph images by brand, site or description. Filter by category, page type, kind or exact site domain. To pull changes, use sort updated with since set to the newest updated_at already held. Each call costs 5 credits. - Cost: 5 credits per call - Capability file: [Search Open Graph images](https://alexandria.firecrawl.dev/agents/providers/og-computer/ogs/search) Accepted options: - `q` (string): Brand, site, or description words. Example: `<q>` - `category` (string): Case-insensitive category name from ogs/collection. Example: `<category>` - `pageType` (string): Case-insensitive page type from ogs/collection. Example: `<pageType>` - `kind` (string): Image or video cards. Example: `image` - `site` (string): Exact siteDomain, such as linear.app. Example: `<site>` - `sort` (string): Featured order (best match first with q), newest added first, or newest updated_at first. Example: `featured` - `since` (string): Only cards whose updated_at is after this ISO 8601 date or timestamp. Example: `<since>` - `limit` (number): Cards per page, integer 1 to 100. Defaults to 24. Example: `24` - `cursor` (string): The nextCursor from a previous response. Example: `<cursor>` Response schema example: ```json { "results": [ { "id": "<id>", "kind": "<kind>", "brand": "<brand>", "title": "<title>", "domain": "<domain>", "siteDomain": "<siteDomain>", "category": "<category>", "pageType": "<pageType>", "featured": false, "width": 0, "height": 0, "imageUrl": "<imageUrl>", "thumbUrl": "<thumbUrl>", "videoUrl": "<videoUrl>", "posterUrl": "<posterUrl>", "duration": 0, "pageUrl": "<pageUrl>", "canonicalUrl": "<canonicalUrl>", "sha256": "<sha256>", "phash": "<phash>", "sourceName": "<sourceName>", "source": "<source>", "addedAt": "<addedAt>", "updated_at": "<updated_at>" } ] } ``` ### Open Graph image details - Capability: `ogs/detail` - Description: One card with image URLs, hashes, provenance and history. - Instructions: Read one card using its ID from search, including renditions, colors, tags and the archived history of earlier images. Each call costs 5 credits. - Cost: 5 credits per call - Capability file: [Open Graph image details](https://alexandria.firecrawl.dev/agents/providers/og-computer/ogs/detail) Accepted options: - `id` (string, required): Stable card ID from search. Example: `<id>` Response schema example: ```json { "id": "<id>", "kind": "<kind>", "brand": "<brand>", "title": "<title>", "domain": "<domain>", "siteDomain": "<siteDomain>", "category": "<category>", "pageType": "<pageType>", "featured": false, "width": 0, "height": 0, "imageUrl": "<imageUrl>", "thumbUrl": "<thumbUrl>", "videoUrl": "<videoUrl>", "posterUrl": "<posterUrl>", "duration": 0, "pageUrl": "<pageUrl>", "canonicalUrl": "<canonicalUrl>", "sha256": "<sha256>", "phash": "<phash>", "sourceName": "<sourceName>", "source": "<source>", "addedAt": "<addedAt>", "updated_at": "<updated_at>", "pageTypeMeta": {}, "siteName": "<siteName>", "description": "<description>", "tags": [], "originalImageUrl": "<originalImageUrl>", "format": "<format>", "bytes": 0, "colors": [], "firstSeen": "<firstSeen>", "crawledAt": "<crawledAt>", "originalVideoUrl": "<originalVideoUrl>", "codec": "<codec>", "hasAudio": false, "poster": {}, "urls": {}, "history": [] } ``` ### Open Graph collection - Capability: `ogs/collection` - Description: Collection metadata, including categories and page types as name/count pairs and the upstream rights notice. - Instructions: Get the collection's card count, kinds, site count, categories and page types with counts, and the rights notice. Each call costs 5 credits. - Cost: 5 credits per call - Capability file: [Open Graph collection](https://alexandria.firecrawl.dev/agents/providers/og-computer/ogs/collection) Accepted options: Response schema example: ```json { "title": "<title>", "rights": "<rights>", "count": 0, "kinds": {}, "sites": 0, "categories": [], "pageTypes": [] } ```