Getting Started

The Agentscan API is free and public. No API key or authentication is required.

Base URL

https://agentscan.info/api

All API endpoints are prefixed with /api. For example, to list agents: GET https://agentscan.info/api/agents

Your First Request

Fetch the first page of registered AI agents:

curl

curl "https://agentscan.info/api/agents?page=1&page_size=5"

Response Format

All responses are JSON. List endpoints return paginated results:

{
  "items": [
    {
      "id": "ethereum-1",
      "name": "MyAgent",
      "address": "0x8004...",
      "token_id": 1,
      "network_id": "ethereum",
      "reputation_score": 85.5,
      "owner_address": "0xabc...",
      "skills": ["nlp", "code-generation"],
      "domains": ["technology"]
    }
  ],
  "total": 1200,
  "page": 1,
  "page_size": 5,
  "total_pages": 240
}

Pagination

All list endpoints support pagination with these query parameters:

Parameter	Type	Required	Description
page	integer	No (default: 1)	Page number (starts at 1)
page_size	integer	No (default: 20)	Items per page (max varies by endpoint)

Rate Limits

The API is rate-limited to ensure fair usage. If you receive a 429 response, wait a few seconds before retrying. There is no hard limit published, but please be respectful of shared resources.

Error Responses

Errors return standard HTTP status codes with a JSON body:

{
  "detail": "Agent not found"
}

Code	Meaning
200	Success
404	Resource not found
422	Validation error (bad parameters)
429	Rate limited — retry after a short delay