API Reference

Complete API reference documentation for integrating Centric tools into your applications.

Base URL

https://api.centric.com/v1

Authentication

All API requests require authentication using Bearer tokens in the Authorization header. To get an access token:

Step 1: Get Access Token

Login to get your access token:

POST http://localhost:5000/api/auth/login
Content-Type: application/json
{
"email": "your-email@example.com",
"password": "your-password"
}

Response:

{
"message": "Login successful",
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"user": { ... }
}

Step 2: Use Token in API Requests

Include the token in the Authorization header:

Authorization: Bearer YOUR_ACCESS_TOKEN

Endpoints

SERP Checker

POST /api/tools/seo/serp-checker

Check search engine rankings for keywords

Request Body:

{
"keyword": "digital marketing",
"country": "US", // optional
"language": "en" // optional
}

Example (cURL):

curl -X POST \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"keyword": "digital marketing", "country": "US"}' \
http://localhost:5000/api/tools/seo/serp-checker

Example (JavaScript):

const response = await fetch(
'http://localhost:5000/api/tools/seo/serp-checker',
{
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
keyword: 'digital marketing',
country: 'US'
})
}
);
const data = await response.json();

Website Status

POST /tools/seo/website-status

Check website availability and response time

SSL Checker

POST /tools/seo/ssl-checker

Validate SSL certificate information

Response Format

All API responses are returned in JSON format with the following structure:

{ "success": true, "data": { ... }, "message": "Operation completed" }

Need More Details?

For complete API documentation, visit our API Documentation page.