Developer API

Grank API

The GRank API exposes the ranking utility through an active controller catalogue containing health, search and position routes. It is intended for applications that need to query the ranking workflow programmatically and manage usage through the normal Vismrit API subscription controls.

Choose a plan API dashboard API documentation External docs

Capabilities

What this API is designed to do

Search-ranking utility API with health, search and position routes.

Check API health before workflow execution

Run the published search operation

Query the published position operation

Manage keys, quotas and whitelist restrictions centrally

Use cases

Where it can fit

These are common integration scenarios; the exact implementation depends on your application, data-handling requirements and subscription tier.

SEO monitoring dashboards

Keyword or result-position workflows

Scheduled ranking checks

Internal reporting and search-visibility tools

Endpoint catalogue

Published routes and methods

The endpoint list below is read from the existing API controller catalogue. Website Management can explain the API, but it cannot invent or replace live endpoint routes.

MethodRoutePurpose

ANY/grankIndex

ANY/grank/healthHealth

ANY/grank/positionPosition

ANY/grank/searchSearch

Integration reference

Authentication, request shape and response handling

These examples are presentation content managed by Website Management. Always compare them with the live API documentation and endpoint catalogue before production integration.

Authentication & access

Use Authorization: Bearer YOUR_API_KEY or X-API-Key. Search and position requests accept JSON, form-data or x-www-form-urlencoded input.

Example request

curl -X POST "https://api.sinhcoms.com/grank/search" 
  -H "Authorization: Bearer YOUR_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "keyword": "dentist",
    "latitude": 28.4595,
    "longitude": 77.0266,
    "radius_km": 5,
    "business_name": "32 Dental House",
    "place_id": "",
    "country_code": "IN",
    "language_code": "en",
    "max_results": 20
  }'

# Position requires keyword, latitude, longitude and business_name
curl -X POST "https://api.sinhcoms.com/grank/position" 
  -H "Authorization: Bearer YOUR_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "keyword": "dentist",
    "latitude": 28.4595,
    "longitude": 77.0266,
    "business_name": "32 Dental House",
    "radius_km": 5,
    "country_code": "IN",
    "language_code": "en",
    "max_results": 20
  }'

Example response

The GRank controller returns the ranking-service JSON received from its upstream WebSocket workflow. Check the ok flag and handle non-2xx status values returned by the service.

Error handling

Documented error states

422Required search or position parameter is missing/invalid

401API key authentication or product authorization failed

429Daily request limit exceeded

502Ranking WebSocket/upstream service error

Integration flow

From subscription to first request

Use the customer dashboard as the control point for keys, whitelist rules and plan limits.

Select a GRank subscription tier

Create or assign an API key

Use the health route for readiness checks

Integrate search and position routes according to the expected parameters

Store only the result data your application actually needs and monitor usage

Plans

Choose the request capacity you need

Pricing and limits below are read from the active subscription tiers in the API system.

Star

INR 499.00/month

1,000,000 requests/day
10,000,000 requests/month

Integration notes

Before you go live

Search-engine behaviour and third-party result formats can change. Build calling applications to tolerate transient errors and changing result availability.

Customer workspace

Already a customer? Continue from your dashboard.

Contact Information

India

Talk to us+91 9123288803 support@vismrit.tech