People Search API

curl --request POST \
  --url https://www.tryfundable.ai/api/v1/people \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "page_size": 5
}'

{
  "success": true,
  "data": {
    "people": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Jane Doe",
        "title": "CEO",
        "linkedin_url": "<string>",
        "crunchbase_url": "<string>",
        "twitter_url": "<string>",
        "location": "San Francisco, CA",
        "city": "<string>",
        "country_code": "US",
        "about": "<string>",
        "is_founder": true,
        "current_company": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "permalink": "<string>",
          "domain": "<string>"
        },
        "employment_history": [
          {
            "title": "<string>",
            "company_name": "<string>",
            "company_id": "<string>",
            "company_url": "<string>",
            "location": "<string>",
            "description": "<string>",
            "start_date": "2023-12-25",
            "end_date": "2023-12-25",
            "is_current": true
          }
        ],
        "education_history": [
          {
            "school_name": "<string>",
            "school_id": "<string>",
            "school_url": "<string>",
            "degree": "<string>",
            "field_of_study": "<string>",
            "start_date": "<string>",
            "end_date": "<string>",
            "description": "<string>"
          }
        ],
        "is_investor": true,
        "is_angel": true,
        "has_led_deal": true,
        "investment_firms": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "name": "<string>",
            "permalink": "<string>",
            "domain": "<string>",
            "deal_count": 123,
            "last_deal_date": "2023-12-25"
          }
        ],
        "investor_highlights": {
          "total_deal_count": 12,
          "lead_deal_count": 123,
          "deal_count_last_12_months": 123,
          "lead_deal_count_last_12_months": 123,
          "most_recent_deal_date": "2023-12-25",
          "top_industries": [
            {
              "name": "<string>",
              "permalink": "<string>",
              "count": 123
            }
          ],
          "top_locations": [
            {
              "name": "<string>",
              "full_name": "<string>",
              "permalink": "<string>",
              "type": "CITY",
              "count": 123
            }
          ],
          "top_round_types": [
            {
              "type": "SERIES_A",
              "count": 123
            }
          ]
        },
        "filtered_deal_count": 123,
        "filtered_lead_count": 123,
        "filtered_most_recent_date": "2023-12-25"
      }
    ]
  },
  "meta": {
    "total_count": 1250,
    "page": 0,
    "page_size": 25,
    "credits_used": 25,
    "credit_source": "monthly",
    "monthly_credits_remaining": 990,
    "purchased_credits_remaining": 500
  },
  "message": "<string>"
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "<string>",
    "details": {
      "errors": [
        {
          "field": "<string>",
          "value": "<string>",
          "message": "<string>",
          "code": "<string>",
          "validOptions": [
            "<string>"
          ]
        }
      ]
    }
  }
}

{
  "success": false,
  "error": {
    "code": "AUTH_ERROR",
    "message": "<string>",
    "details": {
      "help": "<string>"
    }
  }
}

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "<string>",
    "details": {
      "credits_needed": 123,
      "monthly_credits_remaining": 123,
      "purchased_credits_remaining": 123,
      "help": "<string>"
    }
  },
  "success": false
}

{
  "success": false,
  "error": {
    "code": "UNKNOWN_PARAMETER",
    "message": "<string>",
    "details": {
      "unknownParameters": [
        "<string>"
      ],
      "allowedParameters": [
        "<string>"
      ]
    }
  }
}

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Maximum 200 requests per minute.",
    "details": {
      "limit": 200,
      "window": "60 seconds",
      "help": "<string>"
    }
  },
  "success": false
}

{
  "success": false,
  "error": {
    "code": "INTERNAL_SERVER_ERROR",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "TIMEOUT",
    "message": "The semantic search operation timed out. Please try a simpler query.",
    "details": {
      "failed_block": "company",
      "help": "Try a simpler query or fewer filters"
    }
  },
  "success": false
}

POST

people

curl --request POST \
  --url https://www.tryfundable.ai/api/v1/people \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "page_size": 5
}'

{
  "success": true,
  "data": {
    "people": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Jane Doe",
        "title": "CEO",
        "linkedin_url": "<string>",
        "crunchbase_url": "<string>",
        "twitter_url": "<string>",
        "location": "San Francisco, CA",
        "city": "<string>",
        "country_code": "US",
        "about": "<string>",
        "is_founder": true,
        "current_company": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "permalink": "<string>",
          "domain": "<string>"
        },
        "employment_history": [
          {
            "title": "<string>",
            "company_name": "<string>",
            "company_id": "<string>",
            "company_url": "<string>",
            "location": "<string>",
            "description": "<string>",
            "start_date": "2023-12-25",
            "end_date": "2023-12-25",
            "is_current": true
          }
        ],
        "education_history": [
          {
            "school_name": "<string>",
            "school_id": "<string>",
            "school_url": "<string>",
            "degree": "<string>",
            "field_of_study": "<string>",
            "start_date": "<string>",
            "end_date": "<string>",
            "description": "<string>"
          }
        ],
        "is_investor": true,
        "is_angel": true,
        "has_led_deal": true,
        "investment_firms": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "name": "<string>",
            "permalink": "<string>",
            "domain": "<string>",
            "deal_count": 123,
            "last_deal_date": "2023-12-25"
          }
        ],
        "investor_highlights": {
          "total_deal_count": 12,
          "lead_deal_count": 123,
          "deal_count_last_12_months": 123,
          "lead_deal_count_last_12_months": 123,
          "most_recent_deal_date": "2023-12-25",
          "top_industries": [
            {
              "name": "<string>",
              "permalink": "<string>",
              "count": 123
            }
          ],
          "top_locations": [
            {
              "name": "<string>",
              "full_name": "<string>",
              "permalink": "<string>",
              "type": "CITY",
              "count": 123
            }
          ],
          "top_round_types": [
            {
              "type": "SERIES_A",
              "count": 123
            }
          ]
        },
        "filtered_deal_count": 123,
        "filtered_lead_count": 123,
        "filtered_most_recent_date": "2023-12-25"
      }
    ]
  },
  "meta": {
    "total_count": 1250,
    "page": 0,
    "page_size": 25,
    "credits_used": 25,
    "credit_source": "monthly",
    "monthly_credits_remaining": 990,
    "purchased_credits_remaining": 500
  },
  "message": "<string>"
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "<string>",
    "details": {
      "errors": [
        {
          "field": "<string>",
          "value": "<string>",
          "message": "<string>",
          "code": "<string>",
          "validOptions": [
            "<string>"
          ]
        }
      ]
    }
  }
}

{
  "success": false,
  "error": {
    "code": "AUTH_ERROR",
    "message": "<string>",
    "details": {
      "help": "<string>"
    }
  }
}

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "<string>",
    "details": {
      "credits_needed": 123,
      "monthly_credits_remaining": 123,
      "purchased_credits_remaining": 123,
      "help": "<string>"
    }
  },
  "success": false
}

{
  "success": false,
  "error": {
    "code": "UNKNOWN_PARAMETER",
    "message": "<string>",
    "details": {
      "unknownParameters": [
        "<string>"
      ],
      "allowedParameters": [
        "<string>"
      ]
    }
  }
}

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Maximum 200 requests per minute.",
    "details": {
      "limit": 200,
      "window": "60 seconds",
      "help": "<string>"
    }
  },
  "success": false
}

{
  "success": false,
  "error": {
    "code": "INTERNAL_SERVER_ERROR",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "TIMEOUT",
    "message": "The semantic search operation timed out. Please try a simpler query.",
    "details": {
      "failed_block": "company",
      "help": "Try a simpler query or fewer filters"
    }
  },
  "success": false
}

Filtering by location, industry, or round type? Use exact permalinks — a wrong value for locations, industries, or super_categories returns zero results with no error. Resolve them via /location/search and /industry/search first. See Filtering & Permalinks.

Authorizations

Authorization

string

header

required

API key provided as a Bearer token

Body

application/json

person_type

enum<string>

default:any

Restrict results to one population. company returns only people with a current employer (founders, executives, employees). investor returns only people who invest. any (default) returns the union — anyone matching the other filter blocks regardless of population.

Available options:

company,

investor,

any

Example:

"company"

identifiers

object

Look up specific people by identifier

Show child attributes

person

object

Person attribute filters

Show child attributes

company

object

Current-employer attribute filters. Setting any field implicitly requires the person to have a current employer.

Show child attributes

investor

object

Filters on the investor entity (firm) and on the person's deal activity. Setting any field (including any nested deals.* field) implicitly requires the person to be an investor.

Show child attributes

page

integer

default:0

Page number (0-based)

Required range: x >= 0

page_size

integer

default:10

Number of results per page (max 500)

Required range: 1 <= x <= 500

sort_by

enum<string>

default:most_recent_deal_date

Sort order. All values are universally accepted — non-applicable values (e.g. lead_deal_count when no investor filter is set) resolve to 0 / null via COALESCE and naturally sort to the bottom (DESC). Ignored when company.search_query or investor.deals.search_query is set (results are then ordered by semantic relevance).

Available options:

most_recent_deal_date,

total_raised,

latest_deal_size,

name,

total_deal_count,

deal_count_last_12_months,

lead_deal_count,

lead_deal_count_last_12_months,

filtered_deal_count

Response

Successful search results

success

boolean

required

Example:

true

data

object

required

Show child attributes

Overview

Deals

Companies

Investors

People

Filters

Alerts

People Search API

Authorizations

Body

Response