API Integration

Integrate InstaRank's powerful SEO tools with your existing workflows using our comprehensive REST API. Automate SEO monitoring, generate reports, and manage your SEO campaigns programmatically.

API Overview

Powerful REST API

Our REST API provides programmatic access to all InstaRank features, allowing you to integrate SEO monitoring and optimization into your existing tools and workflows.

✓

RESTful JSON API

✓

OAuth 2.0 authentication

✓

Rate limiting and quotas

🔌

Easy Integration

Simple HTTP requests with comprehensive documentation

Getting Started

Authentication

All API requests require authentication using your API key. Include it in the Authorization header.

curl -H "Authorization: Bearer YOUR_API_KEY" \

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

https://api.instarank.com/v1/websites

Get Your API Key:

1. Log in to your InstaRank dashboard
2. Navigate to Settings → API Keys
3. Generate a new API key
4. Copy and store it securely

Base URL

All API endpoints are relative to our base URL:

https://api.instarank.com/v1

API Endpoints

GET/websites

Retrieve all websites in your account

GET /v1/websites

Authorization: Bearer YOUR_API_KEY

POST/websites

Add a new website for crawling

POST /v1/websites

Content-Type: application/json

{

"url": "https://example.com",

"name": "My Website",

"industry": "general"

}

GET/websites/{id}/reports

Get SEO reports for a specific website

GET /v1/websites/123/reports

Authorization: Bearer YOUR_API_KEY

GET/websites/{id}/ai-fixes

Retrieve AI-generated SEO fixes for a website

GET /v1/websites/123/ai-fixes

Authorization: Bearer YOUR_API_KEY

Response Examples

Website List Response

{

"websites": [

{

"id": 123,

"name": "My Website",

"url": "https://example.com",

"status": "active",

"seo_score": 85,

"last_crawled": "2024-01-15T10:30:00Z"

}

]

}

SEO Report Response

{

"report_id": "rpt_123",

"website_id": 123,

"seo_score": 85,

"issues": {

"critical": 3,

"warnings": 8,

"enhancements": 12

"performance": {

"page_speed": 78,

"mobile_score": 82

}

Rate Limits & Quotas

Rate Limits

Free Plan100 requests/hour

Pro Plan1,000 requests/hour

Enterprise10,000 requests/hour

Response Headers

X-RateLimit-Limit - Requests per hour

X-RateLimit-Remaining - Remaining requests

X-RateLimit-Reset - Reset timestamp

SDKs & Libraries

📦

JavaScript

Official Node.js SDK

npm install @instarank/api

🐍

Python

Official Python SDK

pip install instarank

🔧

PHP

Official PHP SDK

composer require instarank/api

Ready to Integrate?

Start building with our API and integrate InstaRank's SEO tools into your applications.

Get API Key View Quickstart

API Overview

Powerful REST API

Our REST API provides programmatic access to all InstaRank features, allowing you to integrate SEO monitoring and optimization into your existing tools and workflows.

✓

RESTful JSON API

✓

OAuth 2.0 authentication

✓

Rate limiting and quotas

🔌

Easy Integration

Simple HTTP requests with comprehensive documentation

Getting Started

Authentication

All API requests require authentication using your API key. Include it in the Authorization header.

curl -H "Authorization: Bearer YOUR_API_KEY" \

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

https://api.instarank.com/v1/websites

Get Your API Key:

1. Log in to your InstaRank dashboard
2. Navigate to Settings → API Keys
3. Generate a new API key
4. Copy and store it securely

Base URL

All API endpoints are relative to our base URL:

https://api.instarank.com/v1

API Endpoints

GET/websites

Retrieve all websites in your account

GET /v1/websites

Authorization: Bearer YOUR_API_KEY

POST/websites

Add a new website for crawling

POST /v1/websites

Content-Type: application/json

{

"url": "https://example.com",

"name": "My Website",

"industry": "general"

}

GET/websites/{id}/reports

Get SEO reports for a specific website

GET /v1/websites/123/reports

Authorization: Bearer YOUR_API_KEY

GET/websites/{id}/ai-fixes

Retrieve AI-generated SEO fixes for a website

GET /v1/websites/123/ai-fixes

Authorization: Bearer YOUR_API_KEY

Response Examples

Website List Response

{

"websites": [

{

"id": 123,

"name": "My Website",

"url": "https://example.com",

"status": "active",

"seo_score": 85,

"last_crawled": "2024-01-15T10:30:00Z"

}

]

}

SEO Report Response

{

"report_id": "rpt_123",

"website_id": 123,

"seo_score": 85,

"issues": {

"critical": 3,

"warnings": 8,

"enhancements": 12

"performance": {

"page_speed": 78,

"mobile_score": 82

}