OverviewPlatformsAPI Reference

List segment presets

gethttps://api.mentio.dev/v1/segments/presets

Suggested segments to start from, the same for every workspace. Save one with POST /v1/segments and its filter.

Authentication

AuthorizationBearer <token>Required

An API key (mk_live_...) from the dashboard or an OAuth access token. See Authentication.

Response

200The presets
dataarray<object>Required

Starting points you can save with POST /v1/segments.

+Show 4 properties
keystringRequired

Stable id of the preset (influencers, champions, ...).

namestringRequired

Suggested segment name.

descriptionstringRequired

What the segment holds, in one sentence.

filterobjectRequired

The filter to save with POST /v1/segments.

+Show 21 properties
platformsarray<string>Optional

People with an account on any of these platforms.

0 to 20 items
+Show 18 enum values
blueskyhackernewsgithubstackoverflowdevtoredditxyoutubenewslinkedintiktokinstagramfacebookappstoregoogleplaytrustpilotgooglemapsrss
tagsarray<string>Optional

People carrying any of these tags.

0 to 20 items
minFollowersintegerOptional

At least this many followers. Unknown reach never matches.

0 to ∞
maxFollowersintegerOptional

At most this many followers. Unknown reach never matches.

0 to ∞
minMentionsintegerOptional

At least this many matched mentions.

1 to ∞
minNegativeintegerOptional

At least this many negative mentions.

1 to ∞
intentsarray<string>Optional

At least one mention carrying any of these intents.

0 to 10 items
keywordKindsarray<string>Optional

Mentioned a keyword of any of these kinds.

One ofbrandcompetitortopic0 to 3 items
neverKeywordKindsarray<string>Optional

Never mentioned a keyword of these kinds.

One ofbrandcompetitortopic0 to 3 items
notPlatformsarray<string>Optional

Nobody with an account on these platforms.

0 to 20 items
+Show 18 enum values
blueskyhackernewsgithubstackoverflowdevtoredditxyoutubenewslinkedintiktokinstagramfacebookappstoregoogleplaytrustpilotgooglemapsrss
notTagsarray<string>Optional

Nobody carrying any of these tags.

0 to 20 items
notIntentsarray<string>Optional

Nobody whose mentions carry any of these intents.

0 to 10 items
newSinceDaysintegerOptional

First seen within this many days.

1 to 365
linkHostsarray<string>Optional

At least one mention linking to any of these hosts, the host itself or a subdomain of it.

0 to 20 items
mutedbooleanOptional

true: only muted people; false: only unmuted.

stagesarray<string>Optional

People at any of these outreach stages.

0 to 6 items
+Show 6 enum values
not_contactedcontactedrepliedin_talkscustomernot_a_fit
notStagesarray<string>Optional

Nobody at these outreach stages.

0 to 6 items
+Show 6 enum values
not_contactedcontactedrepliedin_talkscustomernot_a_fit
notLinkHostsarray<string>Optional

Nobody with a mention linking to any of these hosts, the host itself or a subdomain of it.

0 to 20 items
notOwnerIdsarray<string>Optional

Nobody owned by these members (user ids); "none" drops the people nobody owns.

0 to 20 items
automatedbooleanOptional

true: only people whose matched posts are mostly machine-made (bot accounts); false: only the rest.

ownerIdsarray<string>Optional

People owned by any of these members (user ids); "none" matches people nobody owns.

0 to 20 items
401Missing or invalid API key
+Show 1 property
errorobjectRequired

The error.

+Show 4 properties
codestringRequired

Stable machine-readable code; branch on this, never on the message. Codes are additive: a client should treat one it does not know as a generic failure of the same status.

+Show 46 enum values
unauthorizedforbiddenread_only_keyvalidation_errornot_foundinvalid_cursorpayload_too_largeidempotency_key_in_useidempotency_key_reusedrate_limitedduplicate_keywordinsufficient_balancekeyword_limit_reachedbilling_not_configuredorder_not_creditedschedule_requiredunknown_channelnot_a_digesthourly_email_unsupportedslack_not_connectedslack_not_configuredtelegram_not_configuredfeed_unreadablefeed_login_requiredfeed_login_expiredfeed_limit_reachedfeed_auth_not_configuredemail_not_configuredinvalid_assigneeclassification_pendinginvalid_memberalready_memberlast_ownerduplicate_segmentfilter_too_complexduplicate_viewduplicate_groupdefault_groupdefault_group_contextgroup_changedinvalid_signaturewebhook_not_configuredinvalid_tokenprotected_userupstream_unavailableinternal_error
messagestringRequired

Human-readable detail; may change between releases.

requestIdstringOptional

The id of this request (also the X-Request-Id response header); quote it to support.

retryAfterSecondsintegerOptional

For rate_limited and other retryable errors: how long to wait before retrying (mirrors the Retry-After header).