Generate SEO intelligence reports with SEOIntel

Live demo: seointel.vercel.app | Repository: github.com/seranking/seointel

Try it now (no setup)

The fastest way to see what SEOIntel does is the hosted demo. No installation, no API key required.

1. Go to https://seointel.vercel.app/.
2. Enter a domain (e.g., example.com).
3. Leave the API key field empty—the tool runs in demo mode with sample data.
4. Click Generate Report.

You’ll see a full report with realistic data across all seven sections. When you’re ready for live data, add your API key and re-run it.

Run it locally

Prerequisites

• Node.js 18+
• Redis instance (Upstash free tier works)
• SE Ranking API key—get one here (optional for demo mode)

Step 1. Clone and install

git clone https://github.com/seranking/seointel.git

cd seointel

npm install

Step 2. Configure environment

cp .env.example .env.local

Edit .env.local with your credentials:

# Redis connection (required for report storage)

UPSTASH_REDIS_REST_URL=your-redis-url

UPSTASH_REDIS_REST_TOKEN=your-redis-token

# App URL for shareable report links (optional)

NEXT_PUBLIC_APP_URL=http://localhost:3003

Step 3. Start the server

npm run dev

Open http://localhost:3003.

Step 4. Generate your first report

1. Enter a domain.
2. Paste your SE Ranking API key (or leave blank for demo mode).
3. Click Generate Report.
4. Watch the progress stream as data is collected (30–60 seconds).
5. View your report at /report/[id].

What’s in the report

Each report is divided into seven sections. The table below shows what data you get and which API endpoints power each section.

Credit costs

A full report typically consumes 15,000–25,000 credits, depending on the domain’s size and competitive landscape. The biggest cost drivers:

The exact credit count appears in the report header after generation. Expand the Developer Info panel at the bottom of any section to see the cost breakdown per API call.

Export your data

From the report UI

Click the Export dropdown in the report header:

• Full Report (JSON)—Complete report data as structured JSON, including all sections and metrics.
• Print/PDF—Browser print dialog for PDF export.

From individual sections

• Keywords CSV—Exports: keyword, position, volume, traffic, difficulty, URL.
• Backlinks CSV—Exports: page, backlinks, referring domains, dofollow ratio.

Backlink bulk export (API)

For large-scale backlink data, use the export endpoint directly:

# Quick sample (100 backlinks, 2 per domain)

curl -X POST http://localhost:3003/api/reports/{id}/export-backlinks \

  -H "Content-Type: application/json" \

  -d '{"action": "sample", "apiKey": "YOUR_KEY", "limit": 100, "perDomain": 2}'

# Start full async export

curl -X POST http://localhost:3003/api/reports/{id}/export-backlinks \

  -H "Content-Type: application/json" \

  -d '{"action": "start-export", "apiKey": "YOUR_KEY"}'
# Check export status

curl -X POST http://localhost:3003/api/reports/{id}/export-backlinks \

  -H "Content-Type: application/json" \

  -d '{"action": "check-status", "apiKey": "YOUR_KEY", "taskId": "TASK_ID"}'

Inspect the raw API calls

Every report includes a Developer Info panel that logs every API request made during generation. This is the bridge between “nice report” and “I can build this myself.”

For each call, you’ll see:

• The full endpoint path with parameters
• The raw JSON response
• Duration (ms) and credits consumed
• A copy button for quick reuse

This is the fastest way to understand which SE Ranking endpoints to call and what the responses look like before writing your own integration.

Operational limits

Troubleshooting

Next steps

Use the API directly. The Developer Info panel shows you the exact calls SEOIntel makes. Pick an endpoint and try it with curl:

curl -X POST https://api.seranking.com/v1/domain/overview/db \

  -H "Authorization: Bearer YOUR_API_KEY" \

  -H "Content-Type: application/json" \

  -d '{"domain": "example.com", "source": "us"}'

Fork and customize. SEOIntel is MIT-licensed. Common customizations:

• Add your agency branding to app/layout.tsx
• Add new API endpoints in lib/seranking.ts → call them from lib/report-generator.ts → display in components/Report/
• Change report retention by editing REPORT_TTL in lib/report-store.ts
• Modify chart styles in components/Charts/

Run the tests to understand expected behavior:

npm run test:run

Resources

• SE Ranking API documentation
• GitHub repository
• Live demo
• Other SE Ranking quickstarts