---
canonical_url: "https://docs.composio.dev/toolkits/geekflare"
markdown_url: "https://docs.composio.dev/toolkits/geekflare.md"
product: "platform"
version: null
last_updated: null
---

# Geekflare

Geekflare provides APIs for web scraping, search, website testing, DNS and network diagnostics, and security scans.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 17
- **Triggers:** 0
- **Slug:** `GEEKFLARE`
- **Version:** 00000000_00

## Tools

### Capture Website Screenshot

**Slug:** `GEEKFLARE_CAPTURE_SCREENSHOT`

Capture a webpage or selected element as PNG, JPEG, or WebP with viewport and rendering controls. This is credit-heavy at 5 credits per successful run; proxy_country uses the paid Premium Proxy add-on and additional credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | HTTP or HTTPS URL to capture. |
| `delay` | number | No | Seconds to wait before capture (0-10). |
| `theme` | string ("light" | "dark" | "auto") | No | Preferred page color theme. |
| `device` | string ("desktop" | "mobile") | No | Browser device profile to emulate. |
| `inline` | boolean | No | Include large Base64 and data URI image content. Defaults off to keep responses small; enable only when the returned URL cannot be fetched. |
| `quality` | number | No | JPEG or WebP image quality (10-100); ignored for PNG. |
| `selector` | string | No | CSS selector for capturing only one element. |
| `block_ads` | boolean | No | Block ads while rendering the page. |
| `full_page` | boolean | No | Capture the full scrollable page rather than only the viewport. |
| `image_type` | string ("png" | "jpeg" | "webp") | No | Screenshot image format. |
| `hide_cookie` | boolean | No | Try to hide cookie consent popups. |
| `page_height` | number | No | Partial-page capture height in pixels (100-5000). |
| `scale_factor` | number | No | Device pixel ratio used for rendering (0.1-5). |
| `skip_captcha` | boolean | No | Try to bypass CAPTCHA challenges. |
| `add_timestamp` | boolean | No | Add a timestamp watermark to the screenshot. |
| `proxy_country` | string | No | Paid Premium Proxy option: ISO alpha-2 routing country. Omit to avoid the paid add-on and its additional credits. |
| `viewport_width` | number | No | Viewport width in pixels (320-3840). |
| `highlight_links` | boolean | No | Highlight links in the captured image. |
| `viewport_height` | number | No | Viewport height in pixels (240-2160). |
| `remove_background` | boolean | No | Remove the page background. |
| `disable_animations` | boolean | No | Disable page animations before capture. |
| `fallback_to_full_page` | boolean | No | If selector is missing, capture the full page instead of failing. |
| `capture_beyond_viewport` | boolean | No | Allow capture outside the current viewport when supported. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Check Broken Links

**Slug:** `GEEKFLARE_CHECK_BROKEN_LINKS`

Scan one webpage for links that return errors. Costs 2 credits; proxy_country uses the paid Premium Proxy add-on.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | HTTP or HTTPS webpage URL whose links to scan. |
| `proxy_country` | string | No | Paid Premium Proxy option: ISO alpha-2 routing country. Omit to avoid the add-on and extra credits. |
| `follow_redirect` | boolean | No | Follow redirects while checking linked URLs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Check DNSSEC

**Slug:** `GEEKFLARE_CHECK_DNSSEC`

Check whether DNSSEC is enabled and validating for a domain, including DNSKEY and RRSIG records. Observed Free cost is 1 credit.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Domain or URL whose DNSSEC configuration to check. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Check Mixed Content

**Slug:** `GEEKFLARE_CHECK_MIXED_CONTENT`

Scan an HTTPS page for insecure HTTP images, scripts, stylesheets, and other mixed content. Observed Free cost is 2 credits; proxy_country uses the paid Premium Proxy add-on.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | HTTPS page URL to inspect for insecure resources. |
| `proxy_country` | string | No | Paid Premium Proxy option: ISO alpha-2 routing country. Omit to avoid the add-on and extra credits. |
| `follow_redirect` | boolean | No | Follow redirects before scanning the final page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Check Site Status

**Slug:** `GEEKFLARE_CHECK_SITE_STATUS`

Check whether a website is reachable and return the target site's HTTP status. Costs 1 credit; proxy_country uses the paid Premium Proxy add-on.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | HTTP or HTTPS URL to check. |
| `proxy_country` | string | No | Paid Premium Proxy option: ISO alpha-2 routing country. Omit to avoid the add-on and extra credits. |
| `follow_redirect` | boolean | No | Follow redirects before reporting the target site's status. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Convert URL to PDF

**Slug:** `GEEKFLARE_CONVERT_URL_TO_PDF`

Render a webpage into a downloadable PDF with paper, orientation, margin, and scale controls. This is credit-heavy at 5 credits per successful run; proxy_country uses the paid Premium Proxy add-on and additional credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | HTTP or HTTPS URL to render as a PDF. |
| `scale` | number | No | Rendering scale from 0 through 2. |
| `device` | string ("desktop" | "mobile") | No | Browser device profile to emulate. |
| `margin` | object | No | Page margins in millimeters. Omitted sides use Geekflare defaults. |
| `hide_cookie` | boolean | No | Try to hide cookie consent popups. |
| `orientation` | string ("portrait" | "landscape") | No | PDF page orientation. |
| `paper_format` | string ("letter" | "legal" | "a0" | "a1" | "a2" | "a3" | "a4" | "a5" | "a6") | No | PDF paper format. |
| `skip_captcha` | boolean | No | Try to bypass CAPTCHA challenges. |
| `add_timestamp` | boolean | No | Add a timestamp watermark to the PDF. |
| `proxy_country` | string | No | Paid Premium Proxy option: ISO alpha-2 routing country. Omit to avoid the paid add-on and its additional credits. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Look Up DNS Records

**Slug:** `GEEKFLARE_LOOKUP_DNS_RECORDS`

Retrieve A, AAAA, CNAME, MX, CAA, NS, SOA, SRV, and TXT records for a domain. Costs 1 credit per successful run.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Domain or HTTP/HTTPS URL whose DNS records to query. |
| `types` | array | No | DNS record types to return. Omit to query all supported types. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Measure Page Load Time

**Slug:** `GEEKFLARE_MEASURE_LOAD_TIME`

Measure browser page-load time from Geekflare's default location for 1 credit. Optionally compare additional countries, but setting target_countries is credit-heavy and costs 8 credits total for the run. proxy_country uses the paid Premium Proxy add-on.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | HTTP or HTTPS URL whose load time to measure. |
| `proxy_country` | string | No | Paid Premium Proxy option: ISO alpha-2 routing country. Omit to avoid the add-on and extra credits. |
| `follow_redirect` | boolean | No | Follow redirects during the load-time measurement. |
| `target_countries` | array | No | Credit-heavy multi-location mode: one to three ISO alpha-2 country codes. Supplying this field changes the total run cost from 1 credit to 8 credits and returns per-location results. Omit it for the safe single-location default. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Ping Host

**Slug:** `GEEKFLARE_PING_HOST`

Send ICMP pings to a domain or IP address and return latency, packet-loss, and round-trip statistics. Costs 2 credits per successful run.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Domain, IP address, or HTTP/HTTPS URL to ping. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Run Lighthouse Audit

**Slug:** `GEEKFLARE_RUN_LIGHTHOUSE_AUDIT`

Run a Google Lighthouse audit for performance, SEO, accessibility, and best practices. This credit-heavy endpoint costs 10 credits per successful run; proxy_country uses the paid Premium Proxy add-on and additional credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | HTTP or HTTPS URL to audit. |
| `device` | string ("desktop" | "mobile") | No | Lighthouse device profile. |
| `parameters` | array | No | Advanced Lighthouse CLI flags. Omit unless a specific advanced audit configuration is needed. |
| `proxy_country` | string | No | Paid Premium Proxy option: ISO alpha-2 routing country. Omit to avoid the paid add-on and its additional credits. |
| `follow_redirect` | boolean | No | Follow redirects before auditing the final page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Run MTR Network Diagnostic

**Slug:** `GEEKFLARE_RUN_MTR`

Run MTR to report packet loss and latency at each network hop between Geekflare and a target. Observed Free cost is 2 credits; proxy_country uses the paid Premium Proxy add-on.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Domain, IP address, or URL to diagnose. |
| `proxy_country` | string | No | Paid Premium Proxy option: ISO alpha-2 routing country. Omit to avoid the add-on and extra credits. |
| `follow_redirect` | boolean | No | Follow redirects before selecting the diagnostic target. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Scan Open Ports

**Slug:** `GEEKFLARE_SCAN_OPEN_PORTS`

Scan a domain or IP address for open TCP ports using a common-port set, custom ranges, or Geekflare's default top 100 ports. Costs 2 credits per successful run.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Authorized domain, IP address, or HTTP/HTTPS URL to scan. |
| `top_ports` | integer ("50" | "100" | "500" | "1000" | "5000") | No | Number of most common TCP ports to scan. Omit to let Geekflare use its default of 100 ports. |
| `port_ranges` | string | No | Comma-separated TCP ports and inclusive ranges, such as 80,443,1000-1010. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Scan TLS Configuration

**Slug:** `GEEKFLARE_SCAN_TLS`

Inspect a domain's TLS protocols, cipher suites, and certificate details. Costs 1 credit per successful run.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Domain or HTTPS URL whose TLS configuration to scan. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Scrape Page Metadata

**Slug:** `GEEKFLARE_SCRAPE_PAGE_METADATA`

Extract meta tags, Open Graph fields, Twitter Card fields, canonical URLs, and images from a webpage. Base cost is 2 credits per successful run; proxy_country opts into the paid Premium Proxy add-on and additional credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | HTTP or HTTPS URL whose page metadata to extract. |
| `device` | string ("desktop" | "mobile") | No | Browser device profile to emulate. |
| `format` | string ("markdown" | "json") | No | Result format. |
| `block_ads` | boolean | No | Block ads while loading the page. |
| `render_js` | boolean | No | Render JavaScript before extracting metadata. |
| `file_output` | boolean | No | Return a hosted result file instead of inline content. |
| `proxy_country` | string | No | Paid Premium Proxy option: ISO alpha-2 country code to route through. Omit to avoid the paid proxy add-on and its additional credits. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Scrape Webpage

**Slug:** `GEEKFLARE_SCRAPE_WEBPAGE`

Fetch webpage content as HTML, Markdown, JSON, or text, with optional browser rendering, selector extraction, and AI analysis. Base cost is 1 credit; ai_prompt adds 6 credits, and proxy modes use the paid Premium Proxy add-on.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | HTTP or HTTPS URL to scrape. |
| `device` | string ("desktop" | "mobile") | No | Browser device profile to emulate. |
| `formats` | array | No | Output formats. Accepts an array or comma-separated value and sends an array. |
| `stealth` | boolean | No | Enable browser stealth patches for basic bot detection. |
| `ai_prompt` | string | No | Credit-heavy AI extraction or analysis request. Adds 6 credits and always analyzes page Markdown. |
| `block_ads` | boolean | No | Block ads while loading the page. |
| `render_js` | boolean | No | Force JavaScript rendering on or off; omit for automatic detection. |
| `wait_time` | number | No | Seconds to wait after page load for lazy content or bot checks. |
| `proxy_mode` | string | No | Paid Premium Proxy option: false disables it, auto retries through it if blocked, and true always uses it. Proxy use adds credits. |
| `file_output` | boolean | No | Return hosted result files instead of inline content. |
| `proxy_country` | string | No | ISO alpha-2 Premium Proxy country used when proxy_mode is auto or true. |
| `extraction_mode` | string ("default" | "cssSchema" | "xpathSchema") | No | Structured extraction mode, used when formats includes json. |
| `extraction_schema` | object | No | Extraction definition. Required for cssSchema or xpathSchema mode. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search the Internet

**Slug:** `GEEKFLARE_SEARCH_INTERNET`

Search web pages, news, or images with domain, category, location, and time filters. A base search costs 2 credits. Scraping result URLs and synthesizing a grounded answer are opt-in, credit-heavy enhancements and default off.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `time` | string | No | Recency filter: any, h, d, w, m, y, or a counted form such as h2 or d7. |
| `limit` | integer | No | Requested number of search results. Geekflare may return more results than requested. |
| `query` | string | Yes | Search query. |
| `format` | string ("json" | "markdown" | "html") | No | Response format. JSON returns typed result items; Markdown and HTML return formatted content. |
| `scrape` | boolean | No | Credit-heavy option that also scrapes content from result URLs. Defaults off; enable only when search snippets are insufficient. |
| `source` | string ("web" | "news" | "images") | No | Search corpus: web pages, news articles, or images. |
| `category` | string ("general" | "code" | "pdf" | "research" | "linkedin" | "wiki") | No | Category used to focus the search results. |
| `location` | string | No | ISO alpha-2 country code used to localize search results. |
| `scrape_limit` | integer | No | Number of result URLs to scrape when scrape is true. Higher values consume more credits; this setting is ignored when scrape is false. |
| `exclude_domains` | array | No | Exclude results from these domains. |
| `grounded_answer` | boolean | No | Credit-heavy option that synthesizes an AI-grounded answer with sources. Defaults off. |
| `include_domains` | array | No | Return results only from these domains. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Trace URL Redirects

**Slug:** `GEEKFLARE_TRACE_REDIRECTS`

Trace every redirect hop, status code, and final destination for a URL. Costs 1 credit; proxy_country uses the paid Premium Proxy add-on.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | HTTP or HTTPS URL whose redirect chain to trace. |
| `proxy_country` | string | No | Paid Premium Proxy option: ISO alpha-2 routing country. Omit to avoid the add-on and extra credits. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |