digitalpublic-com Navigator API
The Navigator API from digitalpublic-com — 3 operation(s) for navigator.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/digitalpublic-com:digitalpublic-com-navigator-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: DigitalPublic Agent Navigator API
version: 2026-09-10-trial-active-projects-v1
description: API for external AI agents to interact with DigitalPublic projects. Provides discovery, project context, Google Ads, Meta Ads, LinkedIn organic and LinkedIn Ads, Merchant Center, SEO, AEO, Search Console, WordPress, Analytics, Tag Manager, Business Profile, mailings, CRM, comments, reports, and scheduling.
contact:
email: soporte@digitalpublic.com
servers:
- url: https://platform.digitalpublic.com
description: Production
security:
- bearerAuth: []
tags:
- name: Navigator
paths:
/api/agent/navigator:
post:
summary: Ask DigitalPublic Navigator, report a product signal or list the ones already…
description: Find implemented capabilities, plan non-executing workflows, check connections and scopes, explain errors, summarize a project, record deduplicated product feedback, or list the product signals already reported for this project with their status and resolution note. Navigator recommendations never execute operational writes by themselves.
tags:
- Navigator
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- operation
properties:
productId:
type: string
description: Existing catalog product, required for report_product_signal and optional filter for list_product_signals.
projectId:
type: string
description: Required in the header/query for global agent tokens.
operation:
type: string
enum:
- ask
- find_capabilities
- plan_workflow
- check_readiness
- explain_error
- summarize_project
- report_product_signal
- list_product_signals
- get_product_signal
- add_product_signal_evidence
- reply_product_signal
query:
type: string
maxLength: 20000
description: 'Navigator question, or #number/title/area search for list_product_signals.'
sessionId:
type: string
maxLength: 200
description: Stable isolated Navigator session. Reuse the returned sessionId for follow-up context.
status:
type: string
enum:
- open
- resolved
- dismissed
- all
description: Only for list_product_signals. Defaults to all.
limit:
type: integer
minimum: 1
maximum: 25
responses:
'200':
description: Structured Navigator result with an isolated reusable session id, versioned effective contracts, conditional plan with parameter sources and pending preconditions, bounded retrieval diagnostics and separate relevance, operational correctness and observed success. A no-match remains in scoped history for recurrence review.
'202':
description: Product signal recorded or routed
operationId: postApiAgentNavigator
x-operation-id-source: derived
/api/agent/navigator-history/agent-query:
post:
summary: Supervise the global Navigator query history
description: List the oldest Navigator queries first with stable cursor pagination and read one complete secret-redacted exchange. Reserved for global agents with navigator:history:read.
tags:
- Navigator
x-tools:
- name: list_history
description: List Navigator queries oldest first, filtered by review state, project, date range or text.
params:
reviewStatus:
type: string
optional: true
enum:
- pending
- reviewed
- all
projectId:
type: string
optional: true
createdFrom:
type: string
optional: true
createdTo:
type: string
optional: true
search:
type: string
optional: true
cursor:
type: string
optional: true
limit:
type: integer
optional: true
x-mcp:
channel: navigator
effect: read
requiredScope: read
approval: none
requestShape: tool_params
additionalScopes:
- navigator:history:read
workload:
executionMode: INLINE
resourceClass: LIGHT
priority: INTERACTIVE
costModel: FIXED
idempotencyMode: READ_BEFORE_WRITE
- name: get_history_entry
description: Read one Navigator query, its full answer, result metadata and available session context with secrets redacted.
params:
queryId:
type: string
required: true
x-mcp:
channel: navigator
effect: read
requiredScope: read
approval: none
requestShape: tool_params
additionalScopes:
- navigator:history:read
workload:
executionMode: INLINE
resourceClass: LIGHT
priority: INTERACTIVE
costModel: FIXED
idempotencyMode: READ_BEFORE_WRITE
requestBody:
content:
application/json:
schema:
type: object
required:
- operation
properties:
operation:
type: string
enum:
- list
- get
queryId:
type: string
reviewStatus:
type: string
enum:
- pending
- reviewed
- all
projectId:
type: string
createdFrom:
type: string
format: date-time
createdTo:
type: string
format: date-time
search:
type: string
maxLength: 240
cursor:
type: string
limit:
type: integer
minimum: 1
maximum: 100
responses:
'200':
description: Navigator history page or detail
'403':
description: Global Navigator history scope missing
operationId: postApiAgentNavigatorHistoryAgentQuery
x-operation-id-source: derived
/api/agent/navigator-history/agent-mutate:
post:
summary: Record supervised Navigator history decisions
description: Mark a query reviewed after an explicit human instruction or report a deduplicated ProductSignal finding while preserving the distinction between review and technical resolution.
tags:
- Navigator
x-tools:
- name: mark_history_reviewed
description: Mark one query reviewed with optimistic concurrency, idempotency and an auditable explicit human instruction.
params:
queryId:
type: string
required: true
expectedRevision:
type: integer
required: true
idempotencyKey:
type: string
required: true
humanInstructionReference:
type: string
required: true
x-mcp:
channel: navigator
effect: write
requiredScope: read
approval: none
requestShape: tool_params
additionalScopes:
- navigator:history:read
- navigator:history:review
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
- name: report_history_finding
description: Report a finding from one Navigator query to ProductSignal. ProductSignal fingerprinting and idempotency reuse an existing signal when applicable.
params:
queryId:
type: string
required: true
type:
type: string
required: true
enum:
- BUG
- MISSING_CAPABILITY
- DOCUMENTATION_GAP
- REPEATED_UNANSWERED_QUESTION
- UX_FRICTION
- FEATURE_REQUEST
- INTEGRATION_GAP
severity:
type: string
optional: true
enum:
- INFO
- LOW
- MEDIUM
- HIGH
- CRITICAL
title:
type: string
required: true
summary:
type: string
required: true
area:
type: string
required: true
idempotencyKey:
type: string
required: true
humanInstructionReference:
type: string
required: true
x-mcp:
channel: navigator
effect: write
requiredScope: read
approval: none
requestShape: tool_params
additionalScopes:
- navigator:history:read
- navigator:history:review
workload:
executionMode: AUTO
resourceClass: STANDARD
priority: NORMAL
costModel: ITEMS
idempotencyMode: READ_BEFORE_WRITE
requestBody:
content:
application/json:
schema:
type: object
required:
- operation
- queryId
- idempotencyKey
- humanInstructionReference
properties:
operation:
type: string
enum:
- mark_reviewed
- report_finding
queryId:
type: string
expectedRevision:
type: integer
minimum: 0
idempotencyKey:
type: string
humanInstructionReference:
type: string
maxLength: 500
responses:
'200':
description: Persisted review or deduplicated ProductSignal finding
'409':
description: Review revision changed
operationId: postApiAgentNavigatorHistoryAgentMutate
x-operation-id-source: derived
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Project API key starting with dpk_ or global agent token starting with dpa_. dpa_ requests must include projectId or X-DigitalPublic-Project-Id for project-scoped endpoints.
x-commercial-channels:
- key: google_ads
label:
es: Google Ads
en: Google Ads
commercialModule: google_ads
services:
- googleAds
mcpChannels:
- google_ads
public: true
availability: generally_available
access: read_write
requiresConnection: true
acceptedAliases:
- google-ads
- key: wordpress
label:
es: WordPress
en: WordPress
commercialModule: seo_aeo
services:
- wordpressSeo
mcpChannels:
- wordpress
public: true
availability: generally_available
access: read_write
requiresConnection: true
acceptedAliases:
- wordpress-seo
- key: crm
label:
es: CRM
en: CRM
commercialModule: crm
services:
- crm
mcpChannels:
- crm
public: true
availability: generally_available
access: read_write
requiresConnection: true
acceptedAliases: []
- key: websites
label:
es: Sitios web
en: Websites
commercialModule: content_web
services:
- landingPages
mcpChannels:
- landing_pages
public: true
availability: generally_available
access: read_write
requiresConnection: true
acceptedAliases:
- landing-pages
- landing_pages
- sites-web
- sites_web
- key: social
label:
es: Redes sociales
en: Social media
commercialModule: social
services:
- socialOrganic
- socialX
- socialLinkedIn
mcpChannels:
- social
public: true
availability: generally_available
access: read_write
requiresConnection: true
acceptedAliases: []
- key: blog
label:
es: Blog
en: Blog
commercialModule: content_web
services:
- blog
mcpChannels:
- blog
public: true
availability: generally_available
access: read_write
requiresConnection: true
acceptedAliases: []
- key: meta_ads
label:
es: Meta Ads
en: Meta Ads
commercialModule: meta_ads
services:
- metaAds
mcpChannels:
- meta_ads
public: true
availability: limited
access: read_write
requiresConnection: true
acceptedAliases:
- meta-ads
- meta
- key: linkedin_ads
label:
es: LinkedIn Ads
en: LinkedIn Ads
commercialModule: linkedin_ads
services:
- linkedinAds
mcpChannels:
- linkedin_ads
public: true
availability: limited
access: read_write
requiresConnection: true
acceptedAliases:
- linkedin-ads
- linkedin
- key: seo
label:
es: SEO y AEO
en: SEO and AEO
commercialModule: seo_aeo
services:
- seo
- aeo
mcpChannels:
- seo_tools
- aeo
public: true
availability: limited
access: read_write
requiresConnection: false
acceptedAliases: []
- key: analytics
label:
es: Analítica
en: Analytics
commercialModule: analytics
services:
- analytics
mcpChannels:
- analytics
public: true
availability: limited
access: read
requiresConnection: true
acceptedAliases: []
- key: search_console
label:
es: Search Console
en: Search Console
commercialModule: search_console
services:
- searchConsole
mcpChannels:
- search_console
public: true
availability: limited
access: read_write
requiresConnection: true
acceptedAliases:
- search-console
- key: email
label:
es: Email y newsletters
en: Email and newsletters
commercialModule: email_marketing
services:
- mailings
mcpChannels:
- mailings
public: true
availability: limited
access: read_write
requiresConnection: true
acceptedAliases:
- brevo