Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Epovest API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fepovest.com%2Fepovest" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fepovest.com%2Fepovest" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Epovest API.
Create trackers and run surveys across AI engines via /trackers and /trackers/{id}/survey to measure how they answer about a brand
Read the score series and raw engine responses for a tracker via /trackers/{id}/scores and /trackers/{id}/responses
Review discovered keyword suggestions with /trackers/{id}/discoveries and accept, dismiss, or restore them
Maintain a project's brand canon and surface registry via /projects/{id}/canon and /projects/{id}/surfaces
GET STARTED
Record and verify corroborating pages an engine cites through /projects/{id}/corroborations and /corroborations/{id}/verify
Prepare and arm competitor scans via /competitor-scans and /competitor-scans/{id}/start
Track the prepaid credit balance and account usage via /credits and /usage
Patterns agents use Epovest API for, with concrete tasks.
★ AI agent brand-visibility monitor
An AI assistant keeps an eye on how generative engines talk about a brand so a marketer gets alerted when the score moves. Through Jentic it creates a tracker, triggers surveys, and reads the score series back, surfacing drops without anyone opening the dashboard. Jentic injects the Epovest key at call time, so the agent never holds it.
Search Jentic for 'measure how AI assistants describe my brand', create a tracker with POST /trackers, trigger a run with POST /trackers/{id}/survey, then read GET /trackers/{id}/scores
Tracking AI answer scores over time
Teams want a trend line for how often and how favourably AI engines cite their brand against rivals. Epovest trackers survey the configured engines on a schedule and expose a score series plus the raw engine responses, so a reporting job can chart movement and drill into the exact wording an engine returned. This turns ad-hoc spot checks into a measurable series.
Read GET /trackers/{id}/scores for the trend and GET /trackers/{id}/responses to inspect the raw answers one engine returned for a survey
Acting on keyword discoveries
Epovest discovers new questions and keyword suggestions a brand is being asked about, and a team needs to triage them into the tracker. The discoveries endpoint lists the suggestions, and accept, dismiss, and restore actions let an agent curate which ones feed future surveys. That keeps the measured question set aligned with what the market actually asks.
List suggestions with GET /trackers/{id}/discoveries, then promote the useful ones with POST /trackers/{id}/discoveries/accept
Competitor AI-visibility scan
Before building a tracker, teams want to see which competitors AI engines surface for a set of questions. A competitor scan is prepared as a draft, then armed to run, and the result accumulates the places engines pointed to. An agent can prepare the scan, start it, and read back the accumulated list to decide what to monitor.
Prepare a scan with POST /competitor-scans, arm it with POST /competitor-scans/{id}/start, then read GET /competitor-scans/{id} for the accumulated places
70 endpoints — the epovest api measures how ai assistants such as chatgpt, claude, gemini, perplexity, and grok answer the questions a market asks about a brand, and gives teams the levers to shape those answers.
METHOD
PATH
DESCRIPTION
/trackers
Create a tracker
/trackers/{id}/survey
Run a survey now
/trackers/{id}/scores
Read the score series
/trackers/{id}/discoveries
List discovered keyword suggestions
/projects
Create a project
/projects/{id}/corroborations
List the corroboration registry
/competitor-scans
Prepare a competitor scan
/credits
Read the prepaid credit balance
/trackers
Create a tracker
/trackers/{id}/survey
Run a survey now
/trackers/{id}/scores
Read the score series
/trackers/{id}/discoveries
List discovered keyword suggestions
/projects
Create a project
/projects/{id}/corroborations
List the corroboration registry
/competitor-scans
Prepare a competitor scan
/credits
Read the prepaid credit balance
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the Epovest API by hand means managing its bearer key, honouring the read and write scope each operation declares, and polling tracker surveys and scores yourself. Through Jentic you install once, import Epovest from the API Directory, store the key once, and your agent calls it.
Permission scoping
Epovest puts each resource id in the URL path, such as /trackers/{id} and /projects/{id}, so a rule can pin your agent to the trackers and projects it manages and the read operations like scores and discoveries. You choose the operations it may call, so write actions like deleting a surface or topping up credits are not included unless you add them.
Credential isolation
Your Epovest API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'measure how AI assistants describe my brand' or 'start a competitor scan', and Jentic returns the matching Epovest operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Alternatives and complements available in the Jentic catalogue.
Specific to using Epovest API through Jentic.
What authentication does the Epovest API use?
The Epovest API authenticates with a bearer API key whose secret begins with epo_, per its OpenAPI spec, and each operation declares whether it needs the read or write scope. When you call it through Jentic, the key is stored encrypted by your own Jentic One instance and injected at execution time, so it never enters the agent's prompt, logs, or context.
Can I measure how AI assistants describe my brand with the Epovest API?
Yes. Create a tracker with POST /trackers, start the measurement, and trigger a survey with POST /trackers/{id}/survey, then read GET /trackers/{id}/scores for the score series and GET /trackers/{id}/responses for the raw answers each engine returned. Trackers survey engines such as ChatGPT, Claude, Gemini, Perplexity, and Grok.
Can the Epovest API suggest new keywords to track?
Yes. Read GET /trackers/{id}/discoveries to see the keyword suggestions Epovest discovered for a tracker, then curate them with POST /trackers/{id}/discoveries/accept, POST /trackers/{id}/discoveries/dismiss, and POST /trackers/{id}/discoveries/restore so future surveys follow the questions that matter.
What are the rate limits for the Epovest API?
The OpenAPI spec does not pin a rate-limit figure in a machine-readable field. Check the Epovest documentation at https://epovest.com/docs for current limits, and have your agent retry with backoff when the API signals that it is being throttled.
How do I set up brand-visibility tracking through Jentic?
Search Jentic for 'measure how AI assistants describe my brand' to load the tracker operations with their input schemas, create a tracker with POST /trackers, and trigger a survey with POST /trackers/{id}/survey. To run it on your own infrastructure, install Jentic One from its GitHub repo.
Can I limit what my agent is allowed to do with the Epovest API?
Yes. Epovest puts each resource id in the URL path, such as /trackers/{id} and /projects/{id}, so a rule can pin your agent to the trackers and projects it manages and to read operations like scores and discoveries. Write and spend actions, such as deleting a surface with DELETE /surfaces/{id} or topping up credits, stay out unless you add them, and every call the agent makes is logged.
For Agents
Measure and improve a brand's visibility in AI assistant answers with Epovest: run trackers that survey engines like ChatGPT and Perplexity, read score series and keyword discoveries, and manage the surfaces and corroborations those engines cite.
Use for: Create a tracker to measure how AI assistants describe my brand, Run a survey now instead of waiting for the schedule, Read the score series for one of my trackers, List the keyword suggestions Epovest discovered
Not supported: Does not handle paid ad buying, content publishing, or web analytics traffic reporting. Use for measuring and improving a brand's visibility in AI assistant answers only.
The Epovest API measures how AI assistants such as ChatGPT, Claude, Gemini, Perplexity, and Grok answer the questions a market asks about a brand, and gives teams the levers to shape those answers. Trackers run scheduled surveys across engines and return a score series, the raw engine responses, and discovered keyword suggestions, while projects hold the brand canon and a registry of the surfaces and corroborating pages an engine cites. Competitor scans, a source Atlas, and a project logbook round out the workflow for monitoring and improving AI visibility. Access uses a bearer API key, and each operation declares the read or write scope it needs.
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
Base layer of spec validity and structural soundness.
Aggregated quality score from linter diagnostics, weighted by severity.
Percentage of `$ref` references that resolve successfully.
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
Structural correctness score based on schema issues using logarithmic dampening.
Clarity, completeness, and ingestion readiness for developers and tooling.
How richly the API is illustrated with examples.
Percentage of examples that conform to their schemas.
Percentage of operations with complete response definitions (success, client error, server error).
Health of API ingestion, bundling, and resolution within Jentic pipelines.
Semantic breadth, depth, and agent comprehension for AI systems.
Coverage of descriptions across API elements.
Coverage of RFC 9457 Problem Details for error responses.
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
Coverage of summaries across operations/tags/info.
Functional utility, complexity comfort, and AI orchestration readiness.
Agent comfort level based on API operational and structural complexity.
Trust, risk posture, and security compliance.
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
Findability, semantic richness, and reasoning readiness.
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>