@crawleo/n8n-nodes-crawleo

n8n community node for Crawleo's real-time search and crawling APIs. Crawleo returns structured SERP data and clean AI-ready web content, making it useful for agents, RAG pipelines, SEO workflows, lead generation, and automation.

Supported Crawleo endpoints

This node uses Crawleo's documented REST API at https://api.crawleo.dev and supports:

• Bing Search API (GET /search): Bing-powered web search with optional auto-crawling and Markdown/HTML/text output for LLM and RAG workflows.
• Google Search API (GET /google-search): Structured Google SERP data for organic results, knowledge graphs, People Also Ask, news, images, places, and shopping.
• Google Maps API (GET /google-maps): Structured place/business data including address, rating, phone number, website, coordinates, opening hours, place ID, and CID.
• Crawler API (GET /crawl): Direct URL crawling with optional JavaScript rendering, screenshots, geolocation, and multiple output formats.
• Headful Browser API (GET /headful-browser): Premium headed-browser crawling with residential proxy geolocation and anti-bot evasion for sites that block standard crawlers.

Getting a Crawleo API key

1. Sign in at crawleo.dev/login.
2. Create an API key from your dashboard.

Configuring credentials in n8n

1. In n8n, open Credentials → New.
2. Search for Crawleo API.
3. Add your API key.
4. Leave Base URL as https://api.crawleo.dev unless Crawleo support gives you a custom endpoint.
5. Save the credential.

The node sends both x-api-key and X-Client-Source: n8n headers. Saved credentials using the older /api/v1 base URL are normalized by the node before requests are sent.

Usage

Bing Search

Use Resource: Search → Operation: Bing Search when you want live Bing web results and optional page content extraction.

Required:

Parameter	API name	Description
Query	query	Search query string.

Options:

Parameter	API name	Description
Max Pages	max_pages	Maximum number of search result pages. Each page costs 10 credits.
Result Count	count	Number of search results to return.
Language	setLang	Language code such as en, es, fr, or de.
Country Code	cc	Country code such as US, GB, or DE.
Geolocation	geolocation	Geographic location for localized results. Use random for randomized geolocation.
Device	device	Device type: desktop, mobile, or tablet.
Auto Crawling	auto_crawling	Crawl each search result URL and include page content.
Copilot Answer	copilot_answer	Include Copilot AI answer cards.
Questions and Answers	questions_answers	Include People Also Ask cards.
Related Queries	related_queries	Include related search suggestions.
Sidebar	sidebar	Include sidebar/knowledge panel/local result data.
Direct Answer	direct_answer	Include direct answer boxes and instant answers.
Raw HTML	raw_html	Return original HTML source for crawled pages.
Enhanced HTML	enhanced_html	Return cleaned HTML with ads/scripts/tracking removed.
Page Text	page_text	Return plain text content.
Markdown	markdown	Return structured Markdown for RAG/LLM workflows.

Google Search

Use Resource: Search → Operation: Google Search for structured Google SERP workflows such as SEO monitoring, competitor research, news monitoring, images, places, and shopping.

Required:

Parameter	API name	Description
Query	q	Google search query.

Options:

Parameter	API name	Description
Country	gl	ISO 3166-1 alpha-2 country, default us.
Language	hl	IETF language tag, default en.
Freshness Filter	tbs	Past hour/day/week/month/year filters (qdr:h, qdr:d, qdr:w, qdr:m, qdr:y).
Page	page	1-indexed page number.
Results Per Page	num	Number of results, 1–100.
Search Type	type	search, news, images, places, or shopping.

Google Maps

Use Resource: Search → Operation: Google Maps for structured place and business discovery.

Required:

Parameter	API name	Description
Query	q	Business name, landmark, address, keyword, or category plus location.

Options:

Parameter	API name	Description
Language	hl	Language code for returned place text.
Location Bias	ll	Bias format @latitude,longitude,zoomz, e.g. @48.8566,2.3522,15z.
Place ID	placeId	Google Place ID for a direct place lookup.
CID	cid	Google numeric business/customer ID.

Crawler

Use Resource: Crawler → Operation: Crawler for direct URL crawling.

Required:

Parameter	API name	Description
URLs	urls	One or more URLs. Multiple values are sent as a comma-separated list.

Options:

Parameter	API name	Description
Render JavaScript	render_js	Browser rendering for JavaScript-heavy sites. Costs 10 credits per URL instead of 1.
Geolocation	geolocation	ISO country code for crawl geolocation, e.g. us, gb, or de.
Raw HTML	raw_html	Return raw HTML source.
Enhanced HTML	enhanced_html	Return cleaned/sanitized HTML.
Page Text	page_text	Return plain-text extraction.
Markdown	markdown	Return Markdown conversion.
Screenshot	screenshot	Capture a screenshot. Requires JavaScript rendering.
Full Page Screenshot	screenshot_full_page	Capture full page instead of viewport only. Requires screenshot.

Headful Browser

Use Resource: Crawler → Operation: Headful Browser only when standard crawling is blocked or you need advanced anti-bot evasion.

Required:

Parameter	API name	Description
URLs	urls	One or more URLs. Multiple values are sent as a comma-separated list.

Options:

Parameter	API name	Description
Country	country	Residential proxy geolocation, default us.
Output Format	output_format	markdown, enhanced_html, raw_html, or page_text.
Screenshot	screenshot	Capture a full-page screenshot and return a screenshot URL.

Troubleshooting

Error Code	Description	Suggested Action
400 Bad Request	Missing or invalid parameters	Check required fields and parameter formats.
401 Unauthorized	Missing or invalid API key	Verify or regenerate your key.
402 Payment Required	Insufficient credits	Check your Crawleo subscription and remaining credits.
403 Forbidden	Inactive account or insufficient permissions	Check account status.
429 Too Many Requests	Credits exhausted or concurrent limit reached	Reduce concurrency or retry later.
500 Internal Server Error	Crawleo service issue	Retry after a short delay.

Pricing and credit notes

• Bing Search: 10 credits per results page.
• Google Search: 10 credits per request.
• Google Maps: 30 credits per request.
• Crawler HTTP request: 1 credit per URL.
• Crawler JavaScript rendering: 10 credits per URL.
• Headful Browser: 50 credits per successful URL.

See crawleo.dev/pricing for current plan details.

Resources

• Documentation: https://docs.crawleo.dev
• API introduction: https://docs.crawleo.dev/api-reference/introduction
• MCP overview: https://docs.crawleo.dev/mcp/overview
• Website: https://crawleo.dev