FirstPageSEOAPI
Sign inGet API Key
v2.0 — REST API & Webhooks available

Build with the
SEO API

Integrate real-time SEO and AEO data into your products. Track rankings across Google and AI engines. Webhooks for instant notifications. MCP for AI-native applications.

Get API KeyView Docs
99.9% uptime SLA
REST & GraphQL
TypeScript SDK
example.ts
import { FirstPageSEO } from '@firstpageseo/sdk';
const seo = new FirstPageSEO({
  apiKey: process.env.FIRSTPAGESEO_API_KEY
});
// Get rankings for a domain
const rankings = await seo..rankingsconst rankings = await seo.rankings.get({
  domain: 'yourdomain.com',
  keywords: ['seo tools', 'aeo platform']
});
// Subscribe to webhook for real-time updates
seo.webhooks.on('ranking_update', async (data) => {
  console.log('Ranking changed:', data);
});
Developer Features

Everything you need to build

First-class APIs designed for developers. Webhooks, SDKs, and protocol support for modern applications.

POPULAR

REST API

Complete REST API with predictable resource-oriented URLs. Returns JSON responses with standard HTTP status codes.

GET /v1/rankings?domain=example.com

Response:
{
  "rankings": [
    {
      "keyword": "seo tools",
      "position": 3,
      "engine": "google",
      "updated_at": "2024-01-15T10:30:00Z"
    }
  ]
}
POPULAR

Webhooks

Real-time notifications when rankings change. Configure endpoints to receive POST requests with ranking data.

POST /your-webhook-endpoint
Content-Type: application/json

{
  "event": "ranking_update",
  "domain": "example.com",
  "keyword": "seo tools",
  "old_position": 5,
  "new_position": 3,
  "engine": "google"
}
POPULAR

MCP Server

Model Context Protocol server for AI-native applications. Give LLMs direct access to your SEO data.

# Install MCP SDK
npm install @modelcontextprotocol/sdk

# Configure in your AI app
{
  "mcpServers": {
    "firstpageseo": {
      "command": "npx",
      "args": ["-y", "@firstpageseo/mcp"]
    }
  }
}

TypeScript SDK

First-party SDK with full TypeScript support. Auto-generated from OpenAPI spec. Tree-shakeable.

import { FirstPageSEO } from '@firstpageseo/sdk';

const seo = new FirstPageSEO({ 
  apiKey: process.env.FIRSTPAGESEO_API_KEY 
});

const rankings = await seo.rankings.list({
  domain: 'example.com'
});

Reliable Delivery

Automatic retries with exponential backoff. Webhook events are delivered within seconds of changes.

# Webhook delivery guarantees
- Attempts: Up to 5 retries
- Backoff: 1min, 5min, 30min, 2hr, 8hr
- Timeout: 30 seconds per attempt
- Signature verification included

Flexible Limits

Generous rate limits that scale with your plan. API key quotas can be increased on demand.

# Rate limits by tier
- Free: 100 requests/minute
- Pro: 1,000 requests/minute
- Enterprise: Custom limits

# Response headers
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1705312800
Pricing

Simple, transparent pricing

Start free, scale as you need. No hidden fees, no monthly minimums.

Free

$0/forever

Get started with basic API access.

  • 100 API requests/minute
  • 1 domain
  • Google rankings only
  • 5 webhooks
  • Community support
Start Free
RECOMMENDED

Usage-Based

Pay as you go

Scale as you grow. No monthly commitments.

  • Unlimited API requests
  • $0.001 per ranking check
  • $0.01 per webhook event
  • All search engines
  • MCP server access
  • Email support
Start Building

Enterprise

Custom

Dedicated support and custom limits.

  • Everything in Usage-Based
  • Dedicated account manager
  • 99.99% SLA
  • Custom rate limits
  • On-premise deployment option
  • Priority support
Contact Sales

Usage Examples

See how usage-based pricing works in practice

Single ranking check$0.001
Daily domain scan (100 keywords)$0.10
10 webhook events/month$0.10
MCP queries (1,000)$1.00

Ready to build?

Get your API key in seconds. Start integrating SEO data into your products today.

Get API KeyRead the Docs

Free tier includes 100 requests/minute. No credit card required.