Before you start
- Get an API key at geekflare.com/api. It includes 500 free credits a month and doesn’t need a card.
- 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.- Add an HTTP API enrichment, as described in Add a Geekflare column.
- Under Account, choose Select HTTP API (Headers) account, then + Add account.
- Add one header:
x-api-key, set to your Geekflare API key. Name the account “Geekflare”.
Add a Geekflare column
- Click Add column, then Add enrichment. Search for HTTP API, select it, and open the Configure tab.
- Under Account, select your Geekflare account.
- Set Method to
POST. - Set Endpoint to the recipe’s URL, for example
https://api.geekflare.com/brand. - 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. - Under Run settings, turn Auto-run off while you test.
- 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.
- Click a result cell to open Cell details. The response is under Data. Choose the fields you need and add them as columns.
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.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
Name,Domain,Description,Favicon,Banner UrlColors,Fonts,Social ProfilesLinks:Pricing,Careers,Contact,Signup,Terms,PrivacyCompany:Industry,Founded Year,Employees Range,Revenue Range,Kind(for examplePRIVATELY_HELD),Summary,Target Audience,Location,Use Cases
"mode": "standard" for brand assets only. See the Brand guide.
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
Website + "/pricing", and send that column instead. Or take the brand recipe’s Links → Pricing value and send that. See the Web Scraping guide.
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
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
"source": "news" for news results. Add "time": "m" to limit results to the past month. See the Search guide.
5. Website screenshot
Capture an image of each prospect’s site for personalized emails or landing pages. Endpoint:https://api.geekflare.com/screenshot
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.
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 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.
Troubleshooting
- 401 or 403: the
x-api-keyheader 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 prefixeshttps://.
Related
MCP Server
Use Geekflare from Claude, Cursor, and other AI clients.
API Reference
Parameters and responses for every endpoint.