Mantic User Interest Suggestions API
The user-interest-suggestions API from Mantic — 2 operation(s) for user-interest-suggestions.
The user-interest-suggestions API from Mantic — 2 operation(s) for user-interest-suggestions.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/mantic:mantic-user-interest-suggestions-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Fast User Interest Suggestions API
version: 0.1.0
tags:
- name: user-interest-suggestions
paths:
/webapp/users/me/profile/interests/suggestions:
get:
tags:
- user-interest-suggestions
summary: Get User Interest Suggestions
description: Return cached or freshly-generated grouped interest suggestions.
operationId: get_user_interest_suggestions_webapp_users_me_profile_interests_suggestions_get
security:
- OAuth2AuthorizationCodeBearer: []
parameters:
- name: function
in: query
required: true
schema:
type: string
minLength: 1
maxLength: 200
title: Function
- name: categories
in: query
required: false
schema:
anyOf:
- type: array
items:
type: string
- type: 'null'
title: Categories
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/UserInterestSuggestionsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/webapp/users/me/profile/interests/suggestions/expand:
post:
tags:
- user-interest-suggestions
summary: Expand User Interest Suggestions
description: 'Generate broader/more-diverse interests that don''t overlap shown or selected.
Always calls the LLM. Never writes to the cache. Returns *only new* interests
(labels not present in `shown_suggestions` or `selected_interests`,
case-insensitive), grouped by category.'
operationId: expand_user_interest_suggestions_webapp_users_me_profile_interests_suggestions_expand_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ExpandUserInterestSuggestionsRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/UserInterestSuggestionsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- OAuth2AuthorizationCodeBearer: []
components:
schemas:
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
InterestSuggestionGroup:
properties:
category:
type: string
enum:
- region
- topic
- sector
- market
- org
- person
- event
- goal
- other
title: Category
suggestions:
items:
$ref: '#/components/schemas/Interest'
type: array
title: Suggestions
type: object
required:
- category
- suggestions
title: InterestSuggestionGroup
description: A category's worth of suggested interests (each item's category == `category`).
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ExpandUserInterestSuggestionsRequest:
properties:
function:
type: string
maxLength: 100
minLength: 1
title: Function
categories:
items:
type: string
enum:
- region
- topic
- sector
- market
- org
- person
- event
- goal
- other
type: array
maxItems: 9
title: Categories
shown_suggestions:
items:
$ref: '#/components/schemas/Interest'
type: array
maxItems: 80
title: Shown Suggestions
selected_interests:
items:
$ref: '#/components/schemas/Interest'
type: array
maxItems: 50
title: Selected Interests
additionalProperties: false
type: object
required:
- function
title: ExpandUserInterestSuggestionsRequest
description: 'Request body for `POST .../profile/interests/suggestions/expand`.
`shown_suggestions` is every interest currently visible in the suggestion
pool, in on-screen order. `selected_interests` is the subset the user has
actively added to their interest list; empty when none selected yet, in
which case the prompt omits the selected section. `categories` optionally
restricts which categories to expand.'
UserInterestSuggestionsResponse:
properties:
groups:
items:
$ref: '#/components/schemas/InterestSuggestionGroup'
type: array
title: Groups
source:
type: string
enum:
- cache_hit
- live_llm
- expand
title: Source
type: object
required:
- groups
- source
title: UserInterestSuggestionsResponse
description: Response for GET .../profile/interests/suggestions and POST .../expand.
Interest:
properties:
label:
type: string
maxLength: 200
minLength: 1
title: Label
category:
type: string
enum:
- region
- topic
- sector
- market
- org
- person
- event
- goal
- other
title: Category
additionalProperties: false
type: object
required:
- label
- category
title: Interest
description: 'A stored/returned user interest. `category` is REQUIRED here.
`category` is a `Literal` slug, not a strict `StrEnum`: a strict `StrEnum`
field does not survive the `TypedJSONB` write->read round-trip (the stored
string is rejected on load), whereas a `Literal` validates from a plain
string even under `strict=True`. Guarded by a JSONB round-trip test.'
securitySchemes:
OAuth2AuthorizationCodeBearer:
type: oauth2
flows:
authorizationCode:
scopes: {}
authorizationUrl: https://app.mantic.com/auth/oauth2/authorize
tokenUrl: https://app.mantic.com/auth/oauth2/token