BlueConic

BlueConic Segments API

A segment is a group of profiles characterized by a defined set of attributes & properties. The following methods allow you to retrieve information from segments and the profiles within a given segment. [Read more](https://support.blueconic.com/hc/en-us/articles/202531952-Segments?utm_source=BlueConic_User)

GitHub OpenAPI
Business capability
Customer Segmentation Management BC-420.20

Operations 2

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /segments/{segment}/profiles Export the profiles in a segment · Get profiles in segment #
Ask an LLM
“How do I export every profile that belongs to a segment?”
“Can I only get profiles whose properties changed since a certain date?”
Tell an agent
Get the profiles in segment {segment}.
Export {count} profiles from segment {segment} with properties {properties}.
GET /segments List all segments · Get all segments #
Ask an LLM
“Which segments are defined in our account?”
“Can I filter segments by tag?”
Tell an agent
List all segments.
List segments tagged {filterTag}.

Documentation

📖
Documentation
https://support.blueconic.com/en/articles/248008-overview-blueconic-rest-api
📖
GettingStarted
https://support.blueconic.com/en/articles/248009-using-the-blueconic-rest-api-v2
📖
Authentication
https://support.blueconic.com/en/articles/247557-authorizing-applications-granting-external-applications-to-access-blueconic

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/blueconic/refs/heads/main/openapi/blueconic-segments-api-openapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/blueconic/refs/heads/main/overlays/blueconic-segments-api-overlay.yaml
🔗
AuthorizationCodeFlow
https://support.blueconic.com/en/articles/247559-authorizing-applications-using-the-authorization-code-flow
🔗
ClientCredentialsFlow
https://support.blueconic.com/en/articles/247558-authorizing-applications-using-the-client-credentials-flow

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/blueconic:blueconic-segments-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API 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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

blueconic-segments-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: BlueConic REST API v2 Segments API
  description: Welcome to the BlueConic REST API v2.
  termsOfService: https://www.blueconic.com/blueconic-terms-and-conditions
  contact:
    name: Contact us
    url: https://support.blueconic.com/hc/en-us/requests/new
  license:
    name: BlueConic
    url: https://github.com/blueconic/openapi/blob/main/LICENSE.MD
  version: '100.0'
servers:
- url: https://{blueconicHostname}/rest/v2
  description: The BlueConic server
  variables:
    blueconicHostname:
      description: BlueConic server hostname, e.g. 'tenant.blueconic.net'
      default: tenantname
tags:


# --- truncated at 32 KB (34 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/blueconic/refs/heads/main/openapi/blueconic-segments-api-openapi.yml