> ## Documentation Index
> Fetch the complete documentation index at: https://docs.geekflare.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Clay

> Enrich Clay tables with Geekflare data, including brand and company details, website content as Markdown, page metadata, localized Google results, screenshots, and website health checks.

Enrich Clay tables with Geekflare data: company logos and brand details, website content as Markdown for AI columns, page metadata, localized Google results, screenshots, and website health checks.

Every recipe uses Clay's built-in **HTTP API** enrichment with your Geekflare API key. You don't need a separate Clay integration. Each row that runs costs Geekflare credits from your account, plus 1 Clay credit for the HTTP API action.

## Before you start

1. Get an API key at [geekflare.com/api](https://geekflare.com/api). It includes 500 free credits a month and doesn't need a card.
2. In Clay, open a table that has a website column with full URLs, such as `https://stripe.com`. These recipes call it **Website**.

## Save your key once

Create an HTTP API account so Clay stores your key outside the table.

1. Add an HTTP API enrichment, as described in [Add a Geekflare column](#add-a-geekflare-column).
2. Under **Account**, choose **Select HTTP API (Headers) account**, then **+ Add account**.
3. Add one header: `x-api-key`, set to your Geekflare API key. Name the account "Geekflare".

Clay stores the key in this account, not in the table. Every Geekflare column you add later can select the same account, and duplicated columns keep it.

## Add a Geekflare column

1. Click **Add column**, then **Add enrichment**. Search for **HTTP API**, select it, and open the **Configure** tab.
2. Under **Account**, select your Geekflare account.
3. Set **Method** to `POST`.
4. Set **Endpoint** to the recipe's URL, for example `https://api.geekflare.com/brand`.
5. Open **Body** and enter the recipe's JSON. Where the recipe shows `/Website`, put the cursor inside the quotes, type `/`, and pick your Website column. It appears as a column chip, so each row sends its own URL.
6. Under **Run settings**, turn **Auto-run** off while you test.
7. Click **Save**, then either **Save and run N rows in this view** or **Save and don't run**. You can also use **Try on 5 rows** first.
8. Click a result cell to open **Cell details**. The response is under **Data**. Choose the fields you need and add them as columns.

> [!NOTE]
>
> Clay's body editor adds closing quotes and brackets as you type. Check for stray `"` or `]` before saving. A valid body gets reformatted onto separate lines when you click away.

Rows with an empty Website show **Some inputs missing** and are skipped. To reuse a column in another table, duplicate it and change the endpoint and body.

## Recipes

### 1. Brand and company enrichment

Get a logo, brand colors, social profiles, and, in enriched mode, the industry, founded year, employee range, and company type.

**Endpoint:** `https://api.geekflare.com/brand`

```json theme={null}
{ "url": "/Website", "mode": "enriched" }
```

Useful fields (shown in Cell details under **Data**):

* `Name`, `Domain`, `Description`, `Favicon`, `Banner Url`
* `Colors`, `Fonts`, `Social Profiles`
* `Links`: `Pricing`, `Careers`, `Contact`, `Signup`, `Terms`, `Privacy`
* `Company`: `Industry`, `Founded Year`, `Employees Range`, `Revenue Range`, `Kind` (for example `PRIVATELY_HELD`), `Summary`, `Target Audience`, `Location`, `Use Cases`

For example, notion.so returns the industry "Productivity Software / SaaS", founded 2016, 1001-5000 employees, and $100M-$500M revenue.

Use `"mode": "standard"` for brand assets only. See the [Brand guide](/guides/brand.md).

### 2. Website to Markdown for Claygent and AI columns

Turn a company's homepage, pricing page, or careers page into clean Markdown. Then point an AI column at it to summarize, classify, or write a personalized first line.

**Endpoint:** `https://api.geekflare.com/webscraping`

```json theme={null}
{ "url": "/Website", "format": ["markdown"] }
```

The page content is in **Data → Markdown**. Add it as a column and reference it from an AI column.

For a specific page, build the URL in a formula column first, for example `Website + "/pricing"`, and send that column instead. Or take the brand recipe's `Links → Pricing` value and send that. See the [Web Scraping guide](/guides/web-scraping.md).

### 3. Page metadata

Get a page's title, meta description, Open Graph tags, and Twitter cards. This is a quick way to see what a company says about itself.

**Endpoint:** `https://api.geekflare.com/metascraping`

```json theme={null}
{ "url": "/Website", "format": "json" }
```

### 4. Google search by country

Research a company or keyword with search results for a specific country. Examples: "/Company Name funding" or "/Company Name careers".

**Endpoint:** `https://api.geekflare.com/search`

```json theme={null}
{ "query": "/Company Name funding", "limit": 5, "location": "us" }
```

Add `"source": "news"` for news results. Add `"time": "m"` to limit results to the past month. See the [Search guide](/guides/search.md).

### 5. Website screenshot

Capture an image of each prospect's site for personalized emails or landing pages.

**Endpoint:** `https://api.geekflare.com/screenshot`

```json theme={null}
{ "url": "/Website", "device": "desktop", "type": "png" }
```

The response returns a hosted image URL that you can add as a column. See the [Screenshot guide](/guides/screenshot.md).

### 6. Website health signals

Find prospects whose site is down, has an expiring or weak TLS setup, or scores low on performance. These are good triggers for outreach about web services.

| Check | Endpoint | Body |
| :- | :- | :- |
| Up or down | `https://api.geekflare.com/up` | `{ "url": "/Website", "followRedirect": true }` |
| TLS / certificate | `https://api.geekflare.com/tlsscan` | `{ "url": "/Website" }` |
| Lighthouse scores | `https://api.geekflare.com/lighthouse` | `{ "url": "/Website", "device": "mobile" }` |

Lighthouse takes longer than the other checks. If you run it across a large table, lower the column's rate limit.

## Credits and limits

* Each row that runs costs Geekflare credits plus 1 Clay credit for the HTTP API action. See [Credit Consumption](/api-credit-mapping.md) for the cost of each API.
* Re-running a cell runs it again and charges both again.
* Errors come back in the response with an HTTP status and a message. Clay shows them in the cell. See the [error code reference](/error-codes.md).

## Troubleshooting

* **401 or 403:** the `x-api-key` header is missing or wrong.
* **Empty fields:** some sites don't publish the data, for example the enriched company details in the brand response. Use "Only run if" and fallbacks.
* **Bare domains:** send a full URL such as `https://example.com`. If your column holds bare domains, add a formula column that prefixes `https://`.

## Related

> **[MCP Server](/mcp/overview.md)**
>
> Use Geekflare from Claude, Cursor, and other AI clients.

> **[API Reference](/endpoint/reference.md)**
>
> Parameters and responses for every endpoint.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.