API Reference

REST API endpoints for accessing companies, people, investors, and comprehensive search capabilities. Requires API Access plan or Enterprise plan.

Base URL

https://mentibus.xyz/api/v1

Authentication

All API requests require authentication using an API key in the Authorization header:

Authorization: Bearer your_api_key_here

Example Requests

cURL

curl -X GET "https://mentibus.xyz/api/v1/companies?search=openai&limit=10" \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json"

JavaScript

const response = await fetch('https://mentibus.xyz/api/v1/companies?search=openai', {
  headers: {
    'Authorization': 'Bearer mk_your_api_key_here',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data.data); // Array of companies

Python

import requests

headers = {
    'Authorization': 'Bearer mk_your_api_key_here',
    'Content-Type': 'application/json'
}

response = requests.get(
    'https://mentibus.xyz/api/v1/companies',
    headers=headers,
    params={'search': 'openai', 'limit': 10}
)

companies = response.json()['data']

Response Format

All API responses follow a consistent JSON format with success/error indicators, data payload, and metadata:

Success Response

{
  "success": true,
  "data": [
    {
      "id": 40436,
      "name": "Mentibus",
      "slug": "mentibus",
      "overview": "Mentibus combines highly refined automated processes...",
      "website": "https://mentibus.xyz",
      "logo": "https://zvjcvrokw1gz8udu.public.blob.vercel-storage.com/...",
      "layer": "Web3 Intelligence and data company",
      "location_json": {
        "city": "San Francisco",
        "state": "California",
        "address": "",
        "country": "United States of America"
      },
      "year_founded": 2022,
      "total_employees": 5,
      "status": "published",
      "company_linkedin": "mentibusxyz",
      "twitter": "mentibus_xyz",
      "tags": ["Blockchain", "NFT", "Analytics", "Data", "AI/ML"],
      "created_at": "2022-09-02T03:56:50.487Z",
      "updated_at": "2025-09-23T09:20:50.357Z"
    }
  ],
  "message": "Retrieved 1 companies",
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1
  },
  "meta": {
    "requestId": "48dd2392-2d26-4c20-b48e-649edf505e4b",
    "timestamp": "2025-09-25T18:38:09.676Z",
    "version": "v1"
  }
}

Error Response

{
  "success": false,
  "error": "Invalid API key",
  "meta": {
    "requestId": "req_def456",
    "timestamp": "2024-01-15T10:30:00Z",
    "version": "v1"
  }
}

Rate Limiting

API requests are rate limited based on your plan. Rate limit information is included in response headers:

Rate Limit Headers

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 2024-01-15T11:30:00Z

API Access Plan

1,000

requests/day

30,000

requests/month

Read + Write access

Enterprise Plan

Custom

Higher limits

Contact for pricing

Full access + Priority support

API Endpoints

Health Check

Public endpoint to check API and database health. No authentication required.

GET /api/health

GET /api/health?detailed=true

Companies API

Access comprehensive company data including profiles, funding history, and market insights.

GET /api/v1/companies

GET /api/v1/companies/{slug}

People API

Retrieve professional profiles, career histories, and network connections across the startup ecosystem.

GET /api/v1/people

Investors API

Access VC firm data, investment portfolios, funding patterns, and investor relationships.

GET /api/v1/investors

GET /api/v1/investors/{slug}

Search API

Unified search across companies, people, and investors with relevance scoring.

GET /api/v1/search

Analytics API

Comprehensive analytics and aggregations across all data entities.

GET /api/v1/analytics

Bulk Operations

Efficient batch processing for multiple entities in a single request.

POST /api/v1/bulk

Common Parameters

Parameter	Type	Description	Default	Example
page	integer	Page number for pagination	1	?page=2
limit	integer	Results per page (max 100)	20	?limit=50
sort	string	Field to sort by	name	?sort=founded
order	string	Sort order: asc or desc	asc	?order=desc
search	string	Search query string	-	?search=openai
include_*	boolean	Include related data	false	?include_team=true

HTTP Status Codes

Success Codes

200OK - Request successful

201Created - Resource created

204No Content - Successful deletion

Error Codes

400Bad Request - Invalid parameters

401Unauthorized - Invalid API key

403Forbidden - Insufficient permissions

404Not Found - Resource not found

429Rate Limited - Too many requests

500Server Error - Internal error

SDKs & Libraries

🟨

JavaScript

npm install @mentibus/sdk

Coming soon

🐍

Python

pip install mentibus-python

Coming soon

🐹

Go

go get github.com/mentibus/go-sdk

Coming soon

🐘

PHP

composer require mentibus/php-sdk

Coming soon

Ready to get started?

Get your API key and start building with Mentibus data in minutes.

Get API Key View Tutorial