---
title: "Search domain and documentation metadata by task relevance"
method: GET
path: "/v1/search"
---

# Search domain and documentation metadata by task relevance

`GET /v1/search`

## Request

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

## Query parameters

- `q` string, required
- `page` integer
- `per_page` integer
- `include_unlisted` boolean
- `verified` boolean
- `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'

## Response `200`

OK

- Listing
  - `query` string
  - `page` integer, required
  - `per_page` integer, required
  - `total` integer, required
  - `results` 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

## Other responses

- `400`: Invalid arguments

---

[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)
