Bligo API Documentation

Connect your AI assistant to Bligo and let it manage your profile, search your network, and find matches — all through a simple REST API.

Get your API key Bot setup prompts

Getting Started

Bligo is an AI-powered networking platform. Instead of manually filling out profiles and searching for people, you connect your AI assistant (ChatGPT, Claude, OpenClaw, Gemini, or any custom bot) and it does the heavy lifting:

Builds your skills profile from conversation
Searches the network for people you need
Posts intents on your behalf
Triggers the matching engine to find connections

Everything your bot does goes through the v1 API documented below. All you need is an API key.

Authentication

All API requests require your Bligo API key in the x-api-key header.

// Every request needs this header
headers: { 'x-api-key': 'YOUR_API_KEY' }

Get your API key at Settings → API & Onboarding. You can create multiple keys — one per bot.

Quick Start — 5 Steps

Get your API key

Go to Settings → API and generate a key.

Read the current profile

GET /api/v1/profile to see what Bligo already knows about you.

Interview the user

Your AI asks about your profession, skills, interests, and goals.

Push the profile

POST /api/v1/profile with signals, interests, and goals.

Trigger matching

POST /api/v1/match to find people you should meet.

API Endpoints

GET/api/v1/profile

Get your profile

Returns your full profile including display name, job title, industry, location, signals, clusters, interests, and goals.

fetch('https://bligo.ai/api/v1/profile', {
  headers: { 'x-api-key': 'YOUR_API_KEY' }
})
  .then(r => r.json())
  .then(data => console.log(data.profile))

POST/api/v1/profile

Update your profile

Update profile fields and push AI-detected signals. Signals are merged by tag — existing signals are preserved, duplicates are updated with the latest confidence and frequency.

fetch('https://bligo.ai/api/v1/profile', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    job_title: 'Property Manager',
    industry: 'Real Estate',
    interests: ['AI', 'networking', 'real estate'],
    goals: ['find local contractors', 'meet investors'],
    signals: [
      {
        tag: 'property management',
        confidence: 0.95,
        source: 'bot_training',
        cluster: 'professional'
      },
      {
        tag: 'real estate investing',
        confidence: 0.8,
        source: 'bot_training',
        cluster: 'interests'
      }
    ]
  })
})

POST/api/v1/posts

Create a post

Publish a post on behalf of the user. Posts appear in the feed and are visible to connections or publicly.

fetch('https://bligo.ai/api/v1/posts', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    content: 'Looking for a reliable roofing contractor in White Plains',
    post_type: 'intent',
    visibility: 'public'
  })
})

POST/api/v1/search

Search the network

Run an intent-based search across all profiles. Returns ranked results scored by skill match, location, trust path, and post relevance.

fetch('https://bligo.ai/api/v1/search', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    query: 'find a roofing contractor',
    intent_type: 'trade_service',
    intent_tags: ['roofing', 'contractor'],
    location: 'White Plains'
  })
})

GET/api/v1/searches

Get search history

Returns the user's recent searches with results, structured intent, and timestamps.

fetch('https://bligo.ai/api/v1/searches', {
  headers: { 'x-api-key': 'YOUR_API_KEY' }
})
  .then(r => r.json())
  .then(data => console.log(data.searches))

POST/api/v1/match

Generate matches

Triggers the matching engine to find new people you should meet based on your signals, clusters, location, and network. Returns the count of new matches generated.

fetch('https://bligo.ai/api/v1/match', {
  method: 'POST',
  headers: { 'x-api-key': 'YOUR_API_KEY' }
})
  .then(r => r.json())
  .then(data => console.log(data.count, 'new matches'))

Signal Schema

Signals are how Bligo understands your skills and context. Each signal has a tag, confidence score, source, and cluster.

{
  "tag": "property management",   // the skill or topic
  "confidence": 0.95,              // 0.1 to 1.0
  "source": "bot_training",        // who created this signal
  "cluster": "professional",       // category (see below)
  "last_seen": "2026-03-15"        // optional, defaults to now
}

Cluster types

professionalJob skills, industry expertise, certifications

interestsPersonal interests and topics you care about

goalsWhat you want to achieve or find on Bligo

hobbiesRecreational activities and pastimes

locationGeographic context and preferences

Confidence scale

0.9 – 1.0 — Expert level

0.7 – 0.9 — Strong competency

0.5 – 0.7 — Working knowledge

0.1 – 0.5 — Basic awareness

Signals decay over time (5% per cycle) to keep profiles fresh. Reinforce signals by pushing them again.

Connect Your AI Assistant

Any AI that can make HTTP requests (or output JSON for you to paste) can work with Bligo. Here's how:

Step 1: Get your API key

Go to Settings → API & Onboarding and generate a key. Give it a name like "ChatGPT" or "Claude".

Step 2: Give the key to your AI

Copy the onboarding prompt from Skills → Add Skills. It includes your API key and instructions for your AI to:

Interview you about your skills and experience
Extract 8–15 signals with confidence scores
Push the results to your Bligo profile via the API

Step 3: What your AI can do

Once connected, your AI assistant can:

GET /api/v1/profileRead your profile

POST /api/v1/profileUpdate your skills & bio

POST /api/v1/postsPost on your behalf

POST /api/v1/searchSearch for people

GET /api/v1/searchesCheck past searches

POST /api/v1/matchFind new matches

Bot-specific notes

ChatGPT

Use the ChatGPT prompt at /skills/add. If your plan supports it, ChatGPT can call the API directly. Otherwise it outputs JSON for you to paste.

Claude

Use the Claude prompt at /skills/add. Claude will analyze your conversation and output a profile payload.

OpenClaw

OpenClaw can make HTTP requests natively. Give it the API key and it will push your profile automatically.

Custom Bot

Any bot that can make HTTP POST requests can use the API directly. See the endpoints above.

Get bot prompts

API v1 Reference

All endpoints require Authorization: Bearer [API_KEY] header. Base URL: https://bligo.ai/api/v1

GET/search?q=golf+buddies

Search users by signals, name, handle, location. Also searches posts by content and tags.

Response:

{"query":"golf buddies","results":[{"type":"user","name":"Tom Jones","handle":"@tomjones","location":"West Harrison, NY","job":"Property Manager","profile_url":"https://bligo.ai/profile/tomjones"},{"type":"post","author":"James Mcg","content":"Looking for golf partners..."}]}

GET/matches

Get your top AI-curated matches with detailed match reasons.

Response:

{"matches":[{"name":"Tom Jones","handle":"@tomjones","match_score":85,"why_you_match":{"shared_signals":["Golf","Property Management","Construction"],"reason":"You should meet Tom now because your expertise signals align."}}]}

GET/messages

Get your message inbox (last 50 messages).

Response:

{"messages":[{"from_name":"Tom Jones","from_handle":"@tomjones","content":"Hey!","created_at":"2026-04-04T12:00:00Z","read":false,"direction":"received"}]}

POST/messages/send

Send a direct message to a user by handle.

Request body:

{"to_handle":"@tomjones","message":"Hey want to golf Saturday?"}

Response:

{"ok":true,"delivered_to":"Tom Jones","handle":"@tomjones"}

POST/posts

Create a post on behalf of the authenticated user.

Request body:

{"type":"seeking","content":"Looking for a golf partner Saturday at Westchester CC","tags":["golf","westchester"],"visibility":"public"}

Response:

{"ok":true,"post_id":"abc123"}

GET/profile

Get your full profile with signals grouped by cluster.

Response:

{"profile":{"display_name":"Luke McGovern","signals":[{"tag":"Golf","cluster":"hobbies","confidence":0.25}]}}

POST/signals

Add new signals to your profile (starting at 25% confidence).

Request body:

{"signals":[{"tag":"Pickleball","cluster":"hobbies"},{"tag":"Next.js","cluster":"tech"}]}

Response:

{"ok":true,"added":2,"total":42}

Questions? Email [email protected] or use the Bligo Assistant in the bottom right.