Developers
Build on MarkGrid.
Access Model Share data, competitive intelligence, and content optimization through our REST API. Ship AI visibility features in your product.
Quick Start
# Install the SDK
npm install @markgrid/sdk
# Get your Model Share score
import { MarkGrid } from '@markgrid/sdk';
const client = new MarkGrid({
apiKey: process.env.MARKGRID_API_KEY
});
const result = await client.modelShare.overview();
console.log(result);
// { overall: 34.2, trend: "+2.1" }Authentication
Simple Bearer Token Auth
All API requests require a Bearer token. Generate keys in your dashboard under Settings → API.
Authentication
# All requests use Bearer token authentication
curl -X GET "https://api.markgrid.ai/v1/model-share/overview" \
-H "Authorization: Bearer mk_live_your_api_key_here" \
-H "Content-Type: application/json"
# Test keys start with mk_test_
# Live keys start with mk_live_Try It
Interactive API Explorer
Select an endpoint, hit Send, and see the response.
API ExplorerTry it live
Get Model Share Overview
Retrieve your current Model Share score across all tracked AI platforms with breakdown by model.
Request
curl -X GET "https://api.markgrid.ai/v1/model-share/overview" \
-H "Authorization: Bearer mk_live_abc123" \
-H "Content-Type: application/json"SDKs
First-Class SDK Support
Install, Python
pip install markgridUsage, Python
from markgrid import MarkGrid
client = MarkGrid(api_key="mk_live_abc123")
result = client.modelShare.overview()
print(f"Your Model Share: {result.overall}%")Webhooks
Real-Time Event Webhooks
Subscribe to events and get notified in real-time via HTTPS POST.
Rate Limits
API Rate Limits & Pricing
| Plan | Daily Requests | Burst Limit | Price |
|---|---|---|---|
| Starter | 1,000 / day | 10 / sec | Included |
| Growth | 10,000 / day | 50 / sec | Included |
| Enterprise | Unlimited | 200 / sec | Included |
| API-Only | 50,000 / day | 100 / sec | $500/mo |
Start Building with MarkGrid
Get your API key in seconds. 1,000 free requests per day on every plan.
api.markgrid.ai/docs · REST + Webhooks · OpenAPI 3.1 spec available
