Search

The search endpoint provides full-text search across model display names, slugs, aliases, and family names. Results are ranked by relevance.

Search models

GET /api/v1/search?q={query}

Query Parameters

Parameter	Type	Required	Description
q	string	Yes	The search query

Examples

# Search by model name
curl "https://api.modelgraph.ai/api/v1/search?q=sonnet"

# Search by parameter size
curl "https://api.modelgraph.ai/api/v1/search?q=llama%2070b"

# Search by provider
curl "https://api.modelgraph.ai/api/v1/search?q=mistral%20large"

Response

{
  "query": "sonnet",
  "results": [
    {
      "slug": "claude-sonnet-4-6",
      "display_name": "Claude Sonnet 4.6",
      "version": "4.6",
      "status": "latest",
      "family": {
        "slug": "claude-sonnet",
        "name": "Claude Sonnet"
      },
      "provider": {
        "slug": "anthropic",
        "name": "Anthropic"
      },
      "score": 0.98
    },
    {
      "slug": "claude-3-5-sonnet-20241022",
      "display_name": "Claude 3.5 Sonnet",
      "version": "3.5",
      "status": "active",
      "family": {
        "slug": "claude-sonnet",
        "name": "Claude Sonnet"
      },
      "provider": {
        "slug": "anthropic",
        "name": "Anthropic"
      },
      "score": 0.95
    },
    {
      "slug": "claude-3-sonnet-20240229",
      "display_name": "Claude 3 Sonnet",
      "version": "3",
      "status": "deprecated",
      "family": {
        "slug": "claude-sonnet",
        "name": "Claude Sonnet"
      },
      "provider": {
        "slug": "anthropic",
        "name": "Anthropic"
      },
      "score": 0.92
    }
  ]
}

Response Fields

Field	Type	Description
query	string	The search query that was executed
results	array	Ranked list of matching models
results[].slug	string	Model slug
results[].display_name	string	Human-readable name
results[].version	string	Version string
results[].status	string	Model status
results[].family	object	Family summary
results[].provider	object	Provider summary
results[].score	number	Relevance score (0.0 to 1.0)

Errors

Status	Code	Description
400	bad_request	Missing q parameter