---
title: "Find publisher documentation for a domain or development task"
method: GET
path: "/v1/resolve"
---

# Find publisher documentation for a domain or development task

`GET /v1/resolve`

## Request

- Base URL: `https://agentwebmap.com`
- URL: `https://agentwebmap.com/v1/resolve`
- Auth: none declared

Inspect match strength and health before using sources. Excerpts are publisher link metadata, not fetched page contents. Weak matches are fallback candidates; no matches return best=null. Live refresh validates without changing the directory.

## Query parameters

- `q` string, required
- `detail` 'compact' | 'full'
- `category` 'ai-ml' | 'developer-tools' | 'infrastructure' | 'data-analytics' | 'cybersecurity' | 'finance-payments' | 'ecommerce' | 'productivity' | 'marketing' | 'education' | 'healthcare' | 'media' | 'design' | 'gaming' | 'travel' | 'community' | 'legal' | 'recruiting-careers' | 'industrial-manufacturing' | 'real-estate' | 'arts-culture' | 'sports-fitness' | 'food-dining' | 'automotive' | 'government-public-services' | 'science-research'
- `capability` 'mcp'
- `max_age` integer
- `refresh` boolean
- `limit` integer

## Response `200`

OK

- Resolution
  - `query` string, required
  - `mode` 'domain' | 'topic', required
  - `best` object, required
    - `domain` string, required
    - `status` 'pending' | 'valid' | 'invalid' | 'unreachable', required
    - `tier` 'featured' | 'listed' | 'unlisted' | 'rejected' | 'null', nullable, required
    - `authority` integer, nullable, required
    - `verified` boolean, required
    - `title` string, nullable, required
    - `summary` string, nullable, required
    - `llms_txt` string, nullable, required
    - `llms_full_txt` string, nullable, required
    - `last_checked` string, nullable, required
    - `agent_terms` object, nullable, required
      - `automated_access` 'welcome' | 'limited' | 'ask' | 'not_allowed'
      - `rate_limit` string
      - `attribution` 'required' | 'appreciated' | 'none'
      - `attribution_text` string
      - `pricing` 'free' | 'freemium' | 'paid'
      - `pricing_url` string
      - `terms_url` string
      - `notes` string
    - `categories` string[], required: Inferred topic IDs from publisher metadata; empty means unclassified.
    - `capabilities` string[], required: Publisher-declared capabilities. An MCP declaration does not prove availability or protocol compatibility.
    - `verified_at` string, nullable
    - `nested_llms_txt` string[]
    - `description` string, nullable
    - `tags` string[]
    - `contact` string, nullable
    - `sections` integer, nullable
    - `links` integer, nullable
    - `rank` integer, nullable
    - `registered_at` string, nullable
    - `country` string, nullable
    - `first_seen` string, nullable
    - `badge` string
    - `claim` object
      - `hint` string, required
      - `verification` string, required
      - `verify` string, required
      - `docs` string, required
      - `mcp` string, required
      - `benefits` string[], required
    - `why` string[]
    - `match_score` number
    - `evidence` object[]
      - `url` string, required
      - `title` string, nullable
      - `excerpt` string, nullable
      - `source_url` string, nullable
    - `category_evidence` object[]
      - `id` 'ai-ml' | 'developer-tools' | 'infrastructure' | 'data-analytics' | 'cybersecurity' | 'finance-payments' | 'ecommerce' | 'productivity' | 'marketing' | 'education' | 'healthcare' | 'media' | 'design' | 'gaming' | 'travel' | 'community' | 'legal' | 'recruiting-careers' | 'industrial-manufacturing' | 'real-estate' | 'arts-culture' | 'sports-fitness' | 'food-dining' | 'automotive' | 'government-public-services' | 'science-research', required
      - `confidence` number, required: Deterministic rule strength, not a calibrated probability.
      - `evidence` string[], required
      - `source` 'publisher_metadata', required
    - `category_version` string, nullable
    - `categorized_at` string, nullable
    - `capability_evidence` object[]
      - `id` 'mcp', required
      - `url` string, required
      - `source_url` string, required
      - `status` 'publisher_declared', required
  - `read` object, required
    - `llms_txt` string, nullable, required
    - `llms_full_txt` string, nullable, required
    - `nested_llms_txt` string[], required
  - `terms` object, nullable, required
    - `automated_access` 'welcome' | 'limited' | 'ask' | 'not_allowed'
    - `rate_limit` string
    - `attribution` 'required' | 'appreciated' | 'none'
    - `attribution_text` string
    - `pricing` 'free' | 'freemium' | 'paid'
    - `pricing_url` string
    - `terms_url` string
    - `notes` string
  - `health` object, required
    - `ok` boolean, required
    - `status` 'pending' | 'valid' | 'invalid' | 'unreachable', required
    - `tier` 'featured' | 'listed' | 'unlisted' | 'rejected' | 'null', nullable, required
    - `authority` integer, nullable, required
    - `last_checked` string, nullable, required
    - `checked_minutes_ago` integer, nullable, required
    - `stale` boolean, required
    - `max_age_seconds` integer, required
    - `live_checked` boolean, required
    - `http_status` integer, nullable, required
    - `last_valid` string, nullable, required
    - `content_hash` string, nullable, required
  - `sources` object[], required
    - `url` string, required
    - `title` string, nullable, required
    - `excerpt` string, nullable, required
    - `section` string, nullable, required
    - `source_url` string, required
    - `match_score` number, required
    - `checked_at` string, nullable, required
    - `content_hash` string, nullable, required
  - `match` object, required
    - `strength` 'domain' | 'strong' | 'weak', required
    - `reason` string, required
  - `provenance` object, required
    - `selection` 'directory', required
    - `verification` 'domain_ownership', required
    - `terms` 'owner_stated' | 'unknown', required
    - `excerpts` 'publisher_link_metadata', required
    - `health` 'live_check' | 'stored_crawl', required
  - `alternatives` object[], required
    - `domain` string, required
    - `title` string, nullable, required
    - `authority` integer, nullable, required
    - `tier` 'featured' | 'listed' | 'unlisted' | 'rejected' | 'null', nullable, required
    - `verified` boolean, required
    - `llms_txt` string, nullable, required
    - `match_score` number
  - `watch` string, required

## Other responses

- `400`: Invalid arguments
- `404`: No matching source; inspect suggestions
- `429`: Rate limited
- `500`: Internal error
- `502`: Publisher check failed

---

[API](https://skmtc.dev/agentwebmap/apis/agent-web-map-api.md) · [All operations](https://skmtc.dev/agentwebmap/apis/agent-web-map-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentwebmap/apis/agent-web-map-api/revisions/26289e71cf75?raw)