Skip to main content
DevTune provides a public REST API for integrating your AI search visibility data into CI/CD pipelines, BI tools, custom dashboards, and automated workflows. Most endpoints are read-focused analytics endpoints, and the same API key model also powers webhook management and the MCP server.

​
What You Can Do

With the DevTune API you can:
  • Pull visibility metrics (share of voice, presence rate, brand mentions) into your reporting tools
  • Monitor competitive positioning trends programmatically
  • Feed citation data into your own analytics pipelines
  • Track adoption metrics (npm downloads, GitHub stars) alongside search visibility
  • Pull the current actions workspace, including active recommendations and adopted backlog work
  • Build custom alerting on top of DevTune data
  • Connect AI coding agents (Claude, Cursor) via the MCP server for in-IDE access

​
Requirements

  • A Plus plan or higher with API access enabled
  • An API key scoped to a specific project

​
Available Endpoints

EndpointDescription
Visibility SummaryShare of voice, presence rate, and brand mention metrics
Citation StatsPaginated citation data with classification and position info
Competitive PositionCitation comparison between you, competitors, and others over time
Adoption Metricsnpm downloads and GitHub stars trends for your domains
ActionsActions workspace with active recommendations and backlog items
Action BriefStored brief status and execution-ready markdown for a specific action
Traffic SummaryLLM bot and referral traffic analytics
Traffic PlatformsTraffic breakdown by AI platform
WebhooksReal-time event notifications
MCP ServerModel Context Protocol server for AI coding agents
OpenAPI SpecGET /api/v2/openapi.json — Machine-readable API specification
Tip: Full request/response documentation for each endpoint is available in the Endpoints section of the API Reference sidebar, auto-generated from the OpenAPI specification.

​
Actions Endpoint Notes

The actions endpoint reflects the current workspace model:
  • surface lets you filter between recommendation and backlog
  • status uses public workspace states: active, backlog, in_progress, blocked, done, canceled
  • active applies to recommendations; the rest apply to adopted backlog work
  • The aliases open, completed, and dismissed are also accepted for compatibility and map to backlog, done, and canceled

​
Getting Started

  1. Create an API key from API Keys in the account sidebar
  2. Make your first request using the key in the Authorization header
  3. Explore the endpoints to find the data you need

​
Quick Example

curl -H "Authorization: Bearer dtk_live_your_key_here" \
  "https://devtune.ai/api/v2/projects/YOUR_PROJECT_ID/visibility/summary"

{
  "data": {
    "totalExecutions": 142,
    "shareOfVoice": 23.5,
    "citationPresence": 68.2,
    "brandAwareness": 45.1,
    "avgPrimaryPosition": 2.3,
    "primaryCitations": 97,
    "competitorCitations": 215
  },
  "meta": {
    "timestamp": "2026-02-08T12:00:00.000Z",
    "projectId": "your-project-id"
  }
}