# Website Brand Extractor (Pay per Event) (`eiv/website-brand-extractor-pay-per-event`) Actor
Extract logos, brand colors, fonts, social links, and metadata from any website. Returns structured JSON with favicon, logo images, primary/secondary colors, font families, OG/Twitter metadata, and links for 17+ social platforms.
- **URL**: https://apify.com/eiv/website-brand-extractor-pay-per-event.md
- **Developed by:** [Eimantas V](https://apify.com/eiv) (community)
- **Categories:** Developer tools, Lead generation, SEO tools
- **Stats:** 7 total users, 4 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.00 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## Brand Fetcher
Apify Actor that scrapes any website and extracts brand assets — logos, favicon, brand colors, fonts, metadata, and social media links. Returns clean, structured JSON.
### Features
- **Images** — Extracts favicon, logo (images containing "logo" in URL or alt text), and up to 2 product/hero images
- **Brand Colors** — Returns primary and secondary brand colors, sourced from theme-color meta, CSS custom properties, and stylesheets (neutrals filtered, similar colors deduplicated)
- **Fonts** — Detects font families from CSS, `@font-face`, Google Fonts links, and CSS variables. Filters out numeric values, CSS keywords, and non-font entries.
- **Metadata** — Open Graph, Twitter Card, author, keywords, canonical URL, charset, viewport
- **Social Links** — Detects profile links for 17 platforms
- **Toggleable** — Enable or disable each extraction category independently
- **Rate Limiting** — 1-second delay between requests to avoid overloading target sites
### Supported Platforms
#### Image Sources
- Favicon links (``, ``)
- Apple touch icons (``)
- Images with "logo" in URL or alt text (jpg, png, webp, gif)
- JSON-LD schema.org logos
- Product, hero, banner, and featured images
#### Social Media Platforms
| Platform | Pattern |
|----------|---------|
| Facebook | facebook.com, fb.com, fb.me |
| Twitter/X | twitter.com, x.com |
| Instagram | instagram.com |
| LinkedIn | linkedin.com |
| YouTube | youtube.com, youtu.be |
| TikTok | tiktok.com |
| Pinterest | pinterest.com, pin.it |
| Snapchat | snapchat.com |
| GitHub | github.com |
| GitLab | gitlab.com |
| Bitbucket | bitbucket.org |
| Discord | discord.gg, discord.com |
| Telegram | t.me, telegram.org |
| Reddit | reddit.com |
| Mastodon | mastodon.*, mstdn.* |
| Threads | threads.net |
| Bluesky | bsky.app |
#### Metadata Standards
- Basic HTML meta tags (charset, viewport, author, keywords)
- Open Graph protocol (og:title, og:description, og:image, og:site_name, og:type, og:url)
- Twitter Cards (twitter:card, twitter:title, twitter:description)
- Theme color and application name
- Canonical URL
### Input
| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `urls` | `string[]` | *required* | Website URLs to extract brand info from |
| `extractLogos` | `boolean` | `true` | Extract favicon, logo, and product images |
| `extractColors` | `boolean` | `true` | Extract primary and secondary brand colors |
| `extractFonts` | `boolean` | `true` | Extract font families used on the page |
| `extractMetadata` | `boolean` | `true` | Extract OG, Twitter Card, and other meta tags |
| `extractSocialLinks` | `boolean` | `true` | Extract social media profile links |
| `proxyConfiguration` | `object` | Apify Proxy | Proxy settings |
#### Input example
```json
{
"urls": ["https://stripe.com", "https://github.com"],
"extractLogos": true,
"extractColors": true,
"extractFonts": true,
"extractMetadata": true,
"extractSocialLinks": true,
"proxyConfiguration": {
"useApifyProxy": true
}
}
````
### Output
Each URL produces one JSON object in the dataset:
| Field | Type | Description |
|-------|------|-------------|
| `url` | `string` | The scraped URL |
| `success` | `boolean` | Whether extraction succeeded |
| `timestamp` | `string` | ISO 8601 extraction timestamp |
| `title` | `string \| null` | Brand/site name (from og:site\_name, og:title, or ``) |
| `description` | `string \| null` | Site description (from og:description or meta description) |
| `images` | `ImageAsset[]` | Extracted images — favicon, logo, product (if enabled) |
| `colors` | `BrandColors` | Primary and secondary brand colors (if enabled) |
| `fonts` | `FontInfo[]` | Font families used (if enabled) |
| `metadata` | `object` | Meta tags (if enabled) |
| `socialLinks` | `string[]` | Social media profile URLs (if enabled) |
#### Image asset object
| Field | Type | Values |
|-------|------|--------|
| `url` | `string` | Absolute URL of the image |
| `type` | `string` | `favicon`, `logo`, or `product` |
#### Brand colors object
| Field | Type | Description |
|-------|------|-------------|
| `primary` | `object \| null` | Most dominant brand color (`hex`, `rgb`, `source`) |
| `secondary` | `object \| null` | Second most dominant brand color (`hex`, `rgb`, `source`) |
#### Font info object
| Field | Type | Description |
|-------|------|-------------|
| `family` | `string` | Font family name (e.g. `Inter`) |
| `usageCount` | `number` | Weighted occurrence count |
| `source` | `string` | Where the font was found (e.g. `google-fonts`, `@font-face`, `stylesheet`) |
#### Output example
```json
{
"url": "https://stripe.com",
"success": true,
"timestamp": "2026-03-26T10:30:00.000Z",
"title": "Stripe",
"description": "Stripe is a suite of APIs powering online payment processing.",
"images": [
{
"url": "https://stripe.com/favicon.ico",
"type": "favicon"
},
{
"url": "https://stripe.com/img/v3/home/logo.png",
"type": "logo"
},
{
"url": "https://stripe.com/img/v3/home/hero.jpg",
"type": "product"
}
],
"colors": {
"primary": {
"hex": "#635bff",
"rgb": "rgb(99, 91, 255)",
"source": "theme-color meta"
},
"secondary": {
"hex": "#0a2540",
"rgb": "rgb(10, 37, 64)",
"source": "css-variable"
}
},
"fonts": [
{
"family": "Sohne",
"usageCount": 25,
"source": "@font-face"
},
{
"family": "Inter",
"usageCount": 10,
"source": "google-fonts"
}
],
"metadata": {
"charset": "utf-8",
"viewport": "width=device-width, initial-scale=1",
"ogTitle": "Stripe | Payment Processing Platform",
"ogDescription": "Stripe is a suite of APIs powering online payment processing.",
"twitterCard": "summary_large_image",
"themeColor": "#635bff"
},
"socialLinks": [
"https://twitter.com/stripe",
"https://www.linkedin.com/company/stripe",
"https://github.com/stripe"
]
}
```
#### Error Handling
The Actor provides detailed error messages for common scenarios:
| Scenario | Example Message |
|----------|----------------|
| **Domain not found** | `Domain not found: Could not resolve example.invalid. Check the URL for typos.` |
| **Connection refused** | `Connection refused: The server at example.com is not accepting connections.` |
| **HTTP 403 Forbidden** | `HTTP 403 Forbidden: Access denied. The site may be blocking automated requests.` |
| **HTTP 404 Not Found** | `HTTP 404 Not Found: The page does not exist.` |
| **HTTP 429 Rate Limited** | `HTTP 429 Too Many Requests: Rate limited. Try again later or use a proxy.` |
| **HTTP 5xx Server Error** | `HTTP 500 Server Error: The server encountered an internal error.` |
| **Request Timeout** | `Request timeout: URL did not respond within 30 seconds.` |
| **Invalid URL** | `Invalid URL format: "not-a-url"` |
| **SSL/TLS Error** | `SSL/TLS error: Could not establish a secure connection.` |
Failed extractions output:
```json
{
"url": "https://unreachable-site.example",
"success": false,
"timestamp": "2026-03-26T10:30:00.000Z",
"error": "Domain not found: Could not resolve unreachable-site.example. Check the URL for typos."
}
```
# Actor input Schema
## `urls` (type: `array`):
List of website URLs to extract brand information from.
## `extractLogos` (type: `boolean`):
Extract favicon, logo, and product images from the page.
## `extractColors` (type: `boolean`):
Extract dominant brand colors from page CSS.
## `extractFonts` (type: `boolean`):
Extract font families used on the page.
## `extractMetadata` (type: `boolean`):
Extract Open Graph, Twitter Card, and other meta tags.
## `extractSocialLinks` (type: `boolean`):
Extract social media profile links.
## `proxyConfiguration` (type: `object`):
Proxy settings for accessing websites.
## Actor input object example
```json
{
"urls": [
"https://stripe.com",
"https://github.com"
],
"extractLogos": true,
"extractColors": true,
"extractFonts": true,
"extractMetadata": true,
"extractSocialLinks": true,
"proxyConfiguration": {
"useApifyProxy": true
}
}
```
# Actor output Schema
## `brandData` (type: `string`):
Extracted brand assets for each URL as structured JSON in the default dataset.
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
token: '<YOUR_API_TOKEN>',
});
// Prepare Actor input
const input = {
"urls": [
"https://stripe.com",
"https://github.com"
],
"proxyConfiguration": {
"useApifyProxy": true
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("eiv/website-brand-extractor-pay-per-event").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")
# Prepare the Actor input
run_input = {
"urls": [
"https://stripe.com",
"https://github.com",
],
"proxyConfiguration": { "useApifyProxy": True },
}
# Run the Actor and wait for it to finish
run = client.actor("eiv/website-brand-extractor-pay-per-event").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"urls": [
"https://stripe.com",
"https://github.com"
],
"proxyConfiguration": {
"useApifyProxy": true
}
}' |
apify call eiv/website-brand-extractor-pay-per-event --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=eiv/website-brand-extractor-pay-per-event",
"--header",
"Authorization: Bearer <YOUR_API_TOKEN>"
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Website Brand Extractor (Pay per Event)",
"description": "Extract logos, brand colors, fonts, social links, and metadata from any website. Returns structured JSON with favicon, logo images, primary/secondary colors, font families, OG/Twitter metadata, and links for 17+ social platforms.",
"version": "0.0",
"x-build-id": "nRUZqXDfReD8yCFzL"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/eiv~website-brand-extractor-pay-per-event/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-eiv-website-brand-extractor-pay-per-event",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/eiv~website-brand-extractor-pay-per-event/runs": {
"post": {
"operationId": "runs-sync-eiv-website-brand-extractor-pay-per-event",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/eiv~website-brand-extractor-pay-per-event/run-sync": {
"post": {
"operationId": "run-sync-eiv-website-brand-extractor-pay-per-event",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"urls"
],
"properties": {
"urls": {
"title": "Website URLs",
"type": "array",
"description": "List of website URLs to extract brand information from.",
"items": {
"type": "string"
}
},
"extractLogos": {
"title": "Extract Logos & Images",
"type": "boolean",
"description": "Extract favicon, logo, and product images from the page.",
"default": true
},
"extractColors": {
"title": "Extract Brand Colors",
"type": "boolean",
"description": "Extract dominant brand colors from page CSS.",
"default": true
},
"extractFonts": {
"title": "Extract Fonts",
"type": "boolean",
"description": "Extract font families used on the page.",
"default": true
},
"extractMetadata": {
"title": "Extract Metadata",
"type": "boolean",
"description": "Extract Open Graph, Twitter Card, and other meta tags.",
"default": true
},
"extractSocialLinks": {
"title": "Extract Social Links",
"type": "boolean",
"description": "Extract social media profile links.",
"default": true
},
"proxyConfiguration": {
"title": "Proxy Configuration",
"type": "object",
"description": "Proxy settings for accessing websites."
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```