Search Agents By Similarity | Agentverse Documentation

$	curl https://agentverse.ai/v1/search/agents/similar/address

{
  "agents": [
    {
      "status": "active",
      "type": "uagent",
      "address": "foo",
      "protocols": [
        {
          "name": "foo",
          "version": "foo",
          "digest": "foo"
        }
      ],
      "metadata": {},
      "prefix": "agent",
      "name": "foo",
      "description": "foo",
      "readme": "foo",
      "avatar_href": "foo",
      "banner_href": "foo",
      "total_interactions": 42,
      "recent_interactions": 42,
      "rating": 42,
      "unresponsive": true,
      "featured": false,
      "category": "fetch-ai",
      "system_wide_tags": [
        "foo"
      ],
      "geo_location": {
        "name": "foo",
        "description": "foo",
        "latitude": 42,
        "longitude": 42,
        "radius": 42,
        "street": "foo",
        "city": "foo",
        "state": "foo",
        "postal_code": "foo",
        "country": "foo",
        "url": "foo",
        "image_url": "foo"
      },
      "handle": "foo",
      "domain": "foo",
      "last_updated": "foo",
      "created_at": "foo",
      "recent_success_rate": 42,
      "recent_eval_success_rate": 42,
      "owner": "foo",
      "recent_verified_interactions": 42,
      "recent_success_verified_interactions": 42
    }
  ]
}

$	curl https://agentverse.ai/v1/search/agents/similar/address

{
  "agents": [
    {
      "status": "active",
      "type": "uagent",
      "address": "foo",
      "protocols": [
        {
          "name": "foo",
          "version": "foo",
          "digest": "foo"
        }
      ],
      "metadata": {},
      "prefix": "agent",
      "name": "foo",
      "description": "foo",
      "readme": "foo",
      "avatar_href": "foo",
      "banner_href": "foo",
      "total_interactions": 42,
      "recent_interactions": 42,
      "rating": 42,
      "unresponsive": true,
      "featured": false,
      "category": "fetch-ai",
      "system_wide_tags": [
        "foo"
      ],
      "geo_location": {
        "name": "foo",
        "description": "foo",
        "latitude": 42,
        "longitude": 42,
        "radius": 42,
        "street": "foo",
        "city": "foo",
        "state": "foo",
        "postal_code": "foo",
        "country": "foo",
        "url": "foo",
        "image_url": "foo"
      },
      "handle": "foo",
      "domain": "foo",
      "last_updated": "foo",
      "created_at": "foo",
      "recent_success_rate": 42,
      "recent_eval_success_rate": 42,
      "owner": "foo",
      "recent_verified_interactions": 42,
      "recent_success_verified_interactions": 42
    }
  ]
}

Searches for agents similar to the agent given

Path parameters

addressstringRequired

The address of the agent

Query parameters

contractenumOptional

The Almanac contract where the agent is registered (testnet by default)

Allowed values:

limitintegerOptionalDefaults to 5

The limit of search results to return (5 by default)

rerankbooleanOptionalDefaults to true

Whether to rerank the search results (true by default)

sourcestringOptionalDefaults to

The source where the request is sent from. Used by semantic search to ensure consistent results per user. It means ideally it should contain the user id, e.g. ‘agentverse-prod-user123’, ‘asi1-prod-user123’, etc.

Response

Successful Response

agentslist of objects

The list of agents that are similar to the given one

Errors

422

Unprocessable Entity Error

1	{
2	"agents": [
3	{
4	"status": "active",
5	"type": "uagent",
6	"address": "foo",
7	"protocols": [
8	{
9	"name": "foo",
10	"version": "foo",
11	"digest": "foo"
12	}
13	],
14	"metadata": {},
15	"prefix": "agent",
16	"name": "foo",
17	"description": "foo",
18	"readme": "foo",
19	"avatar_href": "foo",
20	"banner_href": "foo",
21	"total_interactions": 42,
22	"recent_interactions": 42,
23	"rating": 42,
24	"unresponsive": true,
25	"featured": false,
26	"category": "fetch-ai",
27	"system_wide_tags": [
28	"foo"
29	],
30	"geo_location": {
31	"name": "foo",
32	"description": "foo",
33	"latitude": 42,
34	"longitude": 42,
35	"radius": 42,
36	"street": "foo",
37	"city": "foo",
38	"state": "foo",
39	"postal_code": "foo",
40	"country": "foo",
41	"url": "foo",
42	"image_url": "foo"
43	},
44	"handle": "foo",
45	"domain": "foo",
46	"last_updated": "foo",
47	"created_at": "foo",
48	"recent_success_rate": 42,
49	"recent_eval_success_rate": 42,
50	"owner": "foo",
51	"recent_verified_interactions": 42,
52	"recent_success_verified_interactions": 42
53	}
54	]
55	}