Synchronizing Page State
Fetching multi-threaded telemetry & database signals...
Ramfangzauva Coreby Lushai Dev
Fetching multi-threaded telemetry & database signals...
AI Agent live web search, high-speed LLM Markdown scraping, parallel batch scraping, recursive crawlers, and Top-grade SEO audits right inside your pipelines.
Tavily & Exa alternative. Enterprise Multi-Engine Hybrid AI Search (DuckDuckGo, Bing, Google News, Wikipedia) with BM25 Semantic Reranking (0-100% match score), Encyclopedic Knowledge Graph cards, live Google Suggest PAA interrogation, clean LLM Markdown excerpts, and domain gating. Also supports GET /api/v1/search?query=...
curl -X POST "https://ramfangzauva.com/api/v1/search" \
-H "Authorization: Bearer rfz_live_YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"query": "Next.js 15 App Router architecture",
"maxResults": 10,
"includeContent": true,
"engine": "auto"
}'| Parameter | Type | Status | Default | Description |
|---|---|---|---|---|
| query | string | Required | — | Search query or keyword for real-time web search (also accepts 'q' in GET queries). |
| maxResults | number | Optional | 10 | Number of high-density search results to return (1 - 50). |
| searchDepth | 'basic' | 'advanced' | Optional | 'basic' | Basic for fast multi-engine SERP; advanced for deeper page content discovery. |
| includeContent | boolean | Optional | false | Whether to fetch and return clean LLM Markdown excerpts for top matching pages. |
| extractDepth | number | Optional | 3 | How many top pages to fetch clean Markdown for (1 - 10). |
| engine | 'auto' | 'multi' | 'duckduckgo' | 'bing' | 'google_news' | 'google' | Optional | 'auto' | Search engine strategy. 'auto' or 'multi' queries parallel providers with smart deduplication. |
| includeDomains | string[] | Optional | — | Filter results to only specific domains (e.g. ['github.com', 'nextjs.org']). |
| excludeDomains | string[] | Optional | — | Exclude unwanted domains from search results (e.g. ['pinterest.com']). |
| timeRange | 'any' | 'day' | 'week' | 'month' | 'year' | Optional | 'any' | Filter search results by publication freshness window. |
| country | string | Optional | 'us' | Two-letter country code for geo-targeted search results (e.g. 'us', 'in', 'uk'). |
{
"success": true,
"data": {
"query": "Next.js 15 App Router architecture",
"totalResults": 10,
"results": [
{
"rank": 1,
"title": "Next.js Docs: App Router | Next.js",
"url": "https://nextjs.org/docs/app",
"domain": "nextjs.org",
"snippet": "The App Router is a file-system based router that uses React Server Components, Suspense, and Server Actions.",
"bm25Score": 98,
"readingTimeMin": 3,
"source": "duckduckgo",
"keyTakeaways": [
"The App Router is built on React Server Components for zero-bundle-size rendering.",
"Server Actions provide type-safe server mutations directly from forms."
],
"markdown": "# Next.js 15 App Router\n\nThe App Router features React 19..."
}
],
"knowledgeGraph": {
"title": "Next.js",
"description": "Open-source web development framework",
"extract": "Next.js is an open-source web development framework created by Vercel enabling React-based web applications with server-side rendering.",
"url": "https://en.wikipedia.org/wiki/Next.js",
"source": "Wikipedia Open Knowledge"
},
"features": {
"peopleAlsoAsk": [
"What are the best practices for Next.js 15 App Router?",
"How do Next.js 15 Server Actions work?"
],
"hasKnowledgeGraph": true
},
"sourcesUsed": ["duckduckgo", "bing", "google_news", "wikipedia"],
"searchEngine": "multi_matrix",
"responseTimeMs": 1450
}
}You can make your first call in three fast steps.
Sign up for free. You get ten test credits at once.
Go to the Settings page. Create and save your secret API key.
Paste the key in your code. Make your first call and get clean JSON.
Ramfangzauva runs on Next.js 15 route handlers. Every endpoint uses fast edge middleware. Requests use IP rate limits and Bearer tokens. Cross-origin calls are fully supported.
The API follows clean REST standards. POST calls run crawlers, audits, and scrapers. GET calls fetch saved data and live status. All endpoints return clear JSON objects. Errors follow standard HTTP response codes: 400 for bad input, 401 for missing auth token, 402 for out of credits, 429 for rate limits, and 500 for server errors.
API keys are stored in Supabase. Each key tracks credits for your plan. The system deducts credits for each run. At zero credits, the call returns code 402. You can upgrade your plan to add more credits anytime.
Every API call uses credits from your plan. Credits reset at the start of each month. Free guests can use basic sandbox limits.
| Plan Tier | Monthly Price | Monthly Credits | Rate Limit | Max Depth | Headless SPA |
|---|---|---|---|---|---|
| Guest / Sandbox | $0 (Free) | 10 credits. | 10 req / min. | 1. | No. |
| Starter | $0 (Free) | 500 credits. | 30 req / min. | 2. | No. |
| Pro SEO Hacker | $9 / mo (₹891) | 3,000 credits. | 120 req / min. | 4. | ✓ Playwright. |
| Agency Matrix | $39 / mo (₹3,861) | 25,000 credits. | 300 req / min. | 8. | ✓ Playwright + Proxies. |
Agency accounts can receive webhook alerts. The system sends a POST call when crawls finish. The payload includes scores, errors, and metrics.
This enables fully automated SEO pipelines. You can send alerts straight to Slack or Discord. You can open tickets in Jira for critical bugs. You can also save historical trends in your database.
GitHub Actions works with the audit endpoint. Add a deployment step that calls the audit API. Check the overall score in the response. Fail the build if the score drops below your goal.
Follow these simple rules to build fast and safe web apps.
How do I authenticate API requests?
All API requests need a Bearer token. Get your API key from the Settings page. Pass the key in the Authorization header. We hash all keys with SHA-256 for safety. Store your key in a safe place. You can only view your secret key once.
What are the API rate limits?
Rate limits depend on your plan tier. The Starter plan grants 60 calls per minute. The Pro plan allows 300 calls per minute. The Agency plan gives 1,000 calls per minute. Going over limits gives a 429 status code. The Retry-After header shows when limits reset.
What does the /crawl endpoint do?
The /crawl endpoint starts a full site crawl. It finds all internal links on the site. It crawls down to your chosen max depth. It checks each page for SEO tags, speeds, and codes. Live progress streams back in real time.
Can I use the API to automate SEO audits in CI/CD?
Yes, you can run SEO tests in CI/CD. The /audit endpoint checks any web page. It returns a full technical SEO report as JSON. You can call this step in GitHub Actions. You can fail the build if the score drops. This stops bad SEO bugs before launch.
What format does the markdown extraction endpoint return?
The /scrape endpoint returns clean markdown from any URL. It removes menus, ads, and footers. The text is ready for AI LLM tools. You get raw markdown, headings, and word count. You can also request full HTML, images, and links.
How does the Website Security Auditor API (/api/v1/security) work?
The /security endpoint runs 13 automated checks. It tests SSL, HTTPS redirects, and headers. It checks CSP, HSTS, and X-Frame-Options. It scans cookie flags and tech leak risks. It checks for exposed .env and .git files. It also checks SPF and DMARC DNS records.
How does the Google SERP Pixel Width & Live Snippet Simulator (/api/v1/serp-preview) work?
The /serp-preview endpoint models exact Google search results. It checks title pixel widths against Google limits. It checks meta descriptions for desktop and mobile. It flags cutoff text and checks keyword placement. It returns a CTR health score from 0 to 100.
How does the Server Access Log File Analyzer (/api/v1/log-analyzer) measure crawl budget waste?
The /log-analyzer endpoint reads server access logs. It supports Nginx, Apache, Caddy, and Cloudflare logs. It detects search engine bots and AI scrapers. It finds bot hits that return 4xx and 5xx errors. It calculates crawl budget waste and bad URLs.
What readability metrics are computed by the Readability Engine (/api/v1/readability)?
The /readability endpoint checks text quality and reading ease. It computes Flesch Reading Ease and grade levels. It finds run-on sentences and checks syllable counts. It validates the full H1-H6 heading tree. It also estimates reading and speaking times.
How does the Internal PageRank & Click Depth Simulator (/api/v1/link-equity) model link equity?
The /link-equity endpoint models internal PageRank flow. It uses a standard damping factor of 0.85. It traces click depth from your home page. It finds orphan pages with zero links. It helps you fix dead-end pages and boost hubs.
How does the Robots.txt Sandbox (/api/v1/robots-test) simulate bot permissions?
The /robots-test endpoint tests your robots.txt file. It follows official RFC 9309 rules. It checks allow and disallow paths for each bot. It tests Googlebot, Bingbot, GPTBot, and ClaudeBot. It also checks XML sitemap links in the file.
What structured schemas does the Schema.org Validator (/api/v1/schema-validator) test?
The /schema-validator endpoint audits structured data schemas. It checks JSON-LD and Microdata against Google rules. It tests Product, FAQ, Article, and Org schemas. It flags missing required fields and warnings. It also creates live rich snippet previews.
How does the Image SEO & CLS Scanner (/api/v1/image-audit) protect Core Web Vitals?
The /image-audit endpoint scans all images on a page. It checks descriptive alt text for accessibility. It checks width and height to prevent page shift. It flags old image formats and large files. It also tests lazy loading settings.
How does the Hreflang & Multi-Language Auditor (/api/v1/hreflang) validate international SEO?
The /hreflang endpoint checks language and country tags. It validates ISO language and country codes. It checks return links across translated pages. It tests canonical URLs and x-default fallbacks. This ensures proper international search rankings.
Can I track Google SERP keyword rankings programmatically?
Yes, you can track keyword rankings with the API. Send keyword, domain, and country in POST /serp. The engine checks the top 100 Google organic positions. It reports competitor ranks and rich snippet features.
Can I scan pages for broken links and redirect chains via API?
Yes, you can scan pages for broken links. Send your URL to POST /api/seo/broken-links. The tool checks all internal and external links. It finds 404 errors, 500 errors, and redirect loops.
How does the Keyword Matrix & Density API (/api/seo/keywords) work?
The /api/seo/keywords endpoint crawls the target URL. It counts single words and multi-word phrases. It calculates keyword density on the page. It checks heading words and search intent.
Can I run automated competitor SEO comparisons?
Yes, you can compare two domains side by side. Send two URLs to POST /api/seo/competitors. The tool compares technical SEO scores and speeds. It also shows shared keywords and content gaps.
How do I inspect XML sitemaps and nested index files?
Send your sitemap URL to POST /api/seo/sitemap. It reads XML sitemaps and nested index files. It extracts page counts and last-modified dates. You can also send all found URLs directly to the crawler queue.