{"uid":"cap_CGdckKhqcot5MJQaR6i7w","slug":"venice-ai-characters-list-e92321e4","name":"Venice AI Characters List","description":"This is a preview API and may change. Returns a list of characters supported in the API, with filtering by search, tags, categories, model, and sort options.","url":"https://api.venice.ai/api/v1/characters?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"tags":{"type":"array","items":{"type":"string","maxLength":100},"example":["helpful","productivity"],"maxItems":20,"description":"Filter by tag names. Repeat the parameter for multiple values. Comma-separated values are also accepted."},"isPro":{"enum":["true","false"],"type":"string","example":"false","description":"Filter to only show characters using pro models"},"limit":{"type":"integer","default":50,"example":50,"maximum":100,"minimum":0,"description":"Number of characters to return (max: 100)","exclusiveMinimum":true},"offset":{"type":"integer","default":0,"example":0,"minimum":0,"nullable":true,"description":"Number of characters to skip for pagination"},"search":{"type":"string","example":"assistant","maxLength":200,"description":"Search characters by name, description, or tags. Hashtag search is supported."},"sortBy":{"enum":["featured","highestRating","highlyRated","highlyRatedAndRecent","imports","mostRecent","ratingCount"],"type":"string","example":"imports","description":"Sort results using a supported character discovery mode"},"isAdult":{"enum":["true","false"],"type":"string","example":"false","description":"Filter by adult content flag"},"modelId":{"type":"array","items":{"type":"string","maxLength":200},"example":["zai-org-glm-5-1","kimi-k2-6"],"maxItems":20,"description":"Filter by model ID(s). Repeat the parameter for multiple values. Comma-separated values are also accepted."},"sortOrder":{"enum":["asc","desc"],"type":"string","example":"desc","description":"Sort order applied to the selected sort mode. Defaults to descending when omitted."},"categories":{"type":"array","items":{"type":"string","maxLength":100},"example":["roleplay","philosophy"],"maxItems":20,"description":"Filter by category names. Repeat the parameter for multiple values. Comma-separated values are also accepted."},"isWebEnabled":{"enum":["true","false"],"type":"string","example":"true","description":"Filter to only show web-enabled characters"}}},"responseSchema":{"type":"object","required":["data","object"],"properties":{"data":{"type":"array","items":{"type":"object","required":["adult","author","createdAt","description","featured","id","name","shareUrl","photoUrl","slug","stats","tags","updatedAt","webEnabled","modelId"],"properties":{"id":{"type":"string","example":"2f460055-7595-4640-9cb6-c442c4c869b0","description":"Unique ID of the character"},"name":{"type":"string","example":"Alan Watts","description":"Name of the character"},"slug":{"type":"string","example":"alan-watts","description":"Slug of the character to be used in the completions API"},"tags":{"type":"array","items":{"type":"string"},"example":["AlanWatts","Philosophy","Buddhism","Taoist","Hindu"],"description":"Tags associated with the character"},"adult":{"type":"boolean","example":false,"description":"Whether the character is considered adult content"},"stats":{"type":"object","required":["averageRating","imports","ratingCount","ratingSum","userRating"],"properties":{"imports":{"type":"number","example":112,"description":"Number of imports for the character"},"ratingSum":{"type":"number","example":113,"description":"Sum of all rating values for the character"},"userRating":{"type":"number","nullable":true,"description":"The authenticated user rating for the character when available"},"ratingCount":{"type":"number","example":24,"description":"Number of ratings for the character"},"averageRating":{"type":"number","example":4.7,"description":"Average rating for the character"}}},"author":{"type":"string","example":"k3x9q","description":"Short anonymized identifier derived from the character author"},"modelId":{"type":"string","example":"venice-uncensored-1-2","description":"API model ID for the character"},"featured":{"type":"boolean","example":false,"description":"Whether the character is featured in public discovery surfaces"},"photoUrl":{"type":"string","example":"https://outerface.venice.ai/api/characters/2f460055-7595-4640-9cb6-c442c4c869b0/photo","nullable":true,"description":"URL of the character photo"},"shareUrl":{"type":"string","example":"https://venice.ai/c/alan-watts","nullable":true,"description":"Share URL of the character"},"createdAt":{"type":"string","example":"2024-12-20T21:28:08.934Z","description":"Date when the character was created"},"updatedAt":{"type":"string","example":"2025-02-09T03:23:53.708Z","description":"Date when the character was last updated"},"webEnabled":{"type":"boolean","example":true,"description":"Whether the character is enabled for web use"},"description":{"type":"string","example":"Alan Watts (6 January 1915 – 16 November 1973) was a British and American writer, speaker, and self-styled \"philosophical entertainer\", known for interpreting and popularizing Buddhist, Taoist, and Hindu philosophy for a Western audience.","nullable":true,"description":"Description of the character"}}}},"object":{"enum":["list"],"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402","ai_ml"],"displayCostAmount":"10","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$10/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"10","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"10","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Hl_ozqgLWOIW9iVBkMFSO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"10","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a paginated, filterable list of AI characters available on the Venice platform, with support for search, tags, categories, model, and sort options.","exampleAgentPrompt":"Show me the top 10 highest-rated philosophy characters on Venice AI — filter out adult content, limit it to 10 results, and sort by highestRating descending.","exampleUseCases":null,"resultDescription":"Returns a paginated array of character objects, each with a unique ID, slug (usable in completions API), name, description, tags, categories, photo URL, share URL, associated model ID, author identifier, featured/adult/web-enabled flags, and statistics including average rating, rating count, rating sum, import count, and the authenticated user's own rating if available.","failureModes":["Invalid or unsupported sortBy enum value returns 400 Bad Request","Limit exceeding 100 returns validation error","Search string longer than 200 characters returns 400","Unauthenticated request may return 401 Unauthorized","No characters match filters — returns empty data array with 200 OK","modelId or tag values not matching any character silently returns empty results"],"whenToPreferThis":"Use this endpoint when you need to discover, browse, or search Venice AI characters by name, description, tags, categories, or model — especially when building a character picker UI, finding characters for a specific use case, or paginating through available personas. Prefer this over a completions endpoint when the goal is discovery rather than conversation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:44:33.232Z","isFirstParty":false,"canonicalSlug":"venice-ai-characters-list-e92321e4"}