Our API provides programmatic access to our comprehensive database of website alternatives, reviews, and comparison data. Build powerful applications that help users discover the perfect tools for their needs.
Getting Started
API Access
Our API is currently in beta and available to approved partners and developers. To request access, please contact our business development team with details about your intended use case.
API Features
Website Search
Search our database of websites and alternatives with flexible filtering options.
Alternatives Data
Get comprehensive lists of alternatives for any website in our database.
Reviews & Ratings
Access user reviews, ratings, and sentiment analysis for websites.
Categories
Browse websites by category and discover trending alternatives.
Authentication
API Key Authentication
All API requests require authentication using an API key. Include your API key in the request header:
Authorization: Bearer YOUR_API_KEY
Rate Limits
To ensure fair usage and maintain service quality, we implement the following rate limits:
- Free tier: 100 requests per hour
- Basic tier: 1,000 requests per hour
- Pro tier: 10,000 requests per hour
- Enterprise: Custom limits available
API Endpoints
Search Websites
Endpoint: GET /api/v1/search
Description: Search for websites and alternatives
• q (string): Search query
• category (string): Filter by category
• limit (integer): Results per page (max 50)
• offset (integer): Pagination offset
Get Alternatives
Endpoint: GET /api/v1/websites/{domain}/alternatives
Description: Get alternatives for a specific website
• domain (string): Website domain
• limit (integer): Number of alternatives (max 20)
• include_details (boolean): Include detailed comparison data
Get Reviews
Endpoint: GET /api/v1/websites/{domain}/reviews
Description: Get user reviews for a website
• domain (string): Website domain
• limit (integer): Number of reviews (max 50)
• sort (string): Sort by 'date' or 'rating'
Get Categories
Endpoint: GET /api/v1/categories
Description: Get all available categories
• include_count (boolean): Include website count per category
Response Format
JSON Response Structure
All API responses are returned in JSON format with the following structure:
"success": true,
"data": { ... },
"pagination": {
"total": 150,
"limit": 20,
"offset": 0
},
"meta": {
"request_id": "abc123",
"timestamp": "2025-12-23T10:30:00Z"
}
}
Error Responses
Error responses include detailed information to help with debugging:
"success": false,
"error": {
"code": "INVALID_PARAMETER",
"message": "The 'limit' parameter must be between 1 and 50",
"details": { ... }
}
}
SDKs and Libraries
Official SDKs
We provide official SDKs for popular programming languages:
- JavaScript/Node.js: npm install similarwebsites-api
- Python: pip install similarwebsites
- PHP: composer require similarwebsites/api-client
- Ruby: gem install similarwebsites-api
Code Examples
Quick start examples for common use cases are available in our GitHub repository and documentation portal.
Use Cases
Mobile Apps
Build mobile applications that help users discover website alternatives on the go.
Browser Extensions
Create browser extensions that suggest alternatives while users browse the web.
Analytics Tools
Integrate our data into analytics platforms for competitive intelligence.
Support & Resources
Terms of Use
Important: Use of our API is subject to our Terms of Service and API-specific terms. Key points include:
- Respect rate limits and usage quotas
- Do not resell or redistribute our data without permission
- Provide proper attribution when displaying our data
- Use the API responsibly and ethically
- Report any bugs or security issues promptly