Rankfender API Overview │ Rankfender v2.1 Docs

Introduction

The Rankfender API allows you to programmatically access and manage your content, keywords, AI visibility data, and more. Build custom integrations, automate workflows, or create your own interfaces on top of Rankfender.

Base URL

https://api.rankfender.com/v1

Authentication

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

Authorization: Bearer YOUR_API_KEY

Learn more about authentication →

Rate Limits

API rate limits vary by plan:

Essential: 100 requests/hour
Professional: 500 requests/hour
Agencies: 2,000 requests/hour
Enterprise: Custom limits

Rate limit information is included in response headers. See Rate Limits documentation.

Core Endpoints

Projects

GET /projects - List all projects
GET /projects/:id - Get project details
POST /projects - Create new project
PUT /projects/:id - Update project
DELETE /projects/:id - Delete project

Content

GET /projects/:id/content - List all content
GET /projects/:id/content/:contentId - Get content details
POST /projects/:id/content - Generate new content
PUT /projects/:id/content/:contentId - Update content
DELETE /projects/:id/content/:contentId - Delete content
POST /projects/:id/content/:contentId/publish - Publish content

Keywords

GET /projects/:id/keywords - List tracked keywords
POST /projects/:id/keywords - Add keyword
GET /projects/:id/keywords/opportunities - Get keyword opportunities
GET /projects/:id/keywords/:keywordId/performance - Get keyword rankings

AI Visibility

GET /projects/:id/ai-visibility - Get visibility score
GET /projects/:id/ai-visibility/topics - List topics
POST /projects/:id/ai-visibility/topics - Create topic
GET /projects/:id/ai-visibility/prompts - List prompts
POST /projects/:id/ai-visibility/prompts - Create prompt
GET /projects/:id/ai-visibility/responses - List responses

Webhooks

Receive real-time notifications about events in your projects:

content.generated - New content generated
content.published - Content published
keyword.ranking_changed - Keyword ranking updated
ai_visibility.mention_detected - New AI mention found

Learn more about webhooks →

Example Request

Here's an example of creating a new article:

curl -X POST https://api.rankfender.com/v1/projects/proj_123/content \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "best seo tools",
    "type": "blog_post",
    "length": 2000,
    "auto_publish": false
  }'

Example Response

{
  "id": "content_456",
  "status": "generating",
  "keyword": "best seo tools",
  "type": "blog_post",
  "estimated_completion": "2024-01-15T10:35:00Z",
  "created_at": "2024-01-15T10:30:00Z"
}

Official SDKs

We provide official SDKs for popular languages:

JavaScript/TypeScript: npm install @rankfender/sdk
Python: pip install rankfender
PHP: composer require rankfender/sdk
Ruby: gem install rankfender

Postman Collection

Import our Postman collection for easy API testing:

Download Postman Collection

Common Use Cases

Content Automation

Trigger content generation from external systems or workflows. For example, automatically create articles when new products are added to your e-commerce platform.

Custom Reporting

Pull keyword rankings, AI visibility scores, and content performance into your own dashboards or reporting tools.

Integration Workflows

Connect Rankfender with tools like Zapier, Make, or custom internal systems to create automated workflows.

White-Label Solutions

Build your own branded interface on top of Rankfender's API for agency clients.

API Support

Need help with the API? We offer:

Documentation: Comprehensive guides for all endpoints
Code Examples: Sample implementations in multiple languages
Developer Forum: Community support and discussions
Priority Support: Direct API support for Agencies+ plans

Rankfender API Overview