> ## Documentation Index > Fetch the complete documentation index at: https://docs.gravitygtm.com/llms.txt > Use this file to discover all available pages before exploring further. # Find lookalike investors from competitor funders > Researches who funded one or more competitor/adjacent companies and surfaces those funders as new candidate investors, scored against the stored fundraising profile and tagged with which company each one funded. Defaults to the stored profile's own known_competitors when company_names is omitted (startup_equity profiles only -- returns 422 not_found if both are empty). Researches at most a few companies per call; newly-found investors are persisted to your account's stored investor list. Costs 35 credit(s) per call, charged even on a miss. ## OpenAPI ````yaml /helium/openapi.json post /v1/fundraising/find-lookalike-investors openapi: 3.1.0 info: title: Helium API version: '1.0' description: >- Helium is a fundraising-research REST API sharing Horizon's prepaid-credit account system. Every request authenticates with an `Authorization: Bearer ` header (the same key that works against Horizon) and, on a billed endpoint, debits a fixed number of credits from your shared prepaid balance. Check your balance any time with GET /v1/usage (shared with Horizon). servers: - url: https://lite.gravitygtm.com/api security: - bearerAuth: [] paths: /v1/fundraising/find-lookalike-investors: post: tags: - fundraising summary: Find lookalike investors from competitor funders description: >- Researches who funded one or more competitor/adjacent companies and surfaces those funders as new candidate investors, scored against the stored fundraising profile and tagged with which company each one funded. Defaults to the stored profile's own known_competitors when company_names is omitted (startup_equity profiles only -- returns 422 not_found if both are empty). Researches at most a few companies per call; newly-found investors are persisted to your account's stored investor list. Costs 35 credit(s) per call, charged even on a miss. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/FindLookalikeInvestorsRequest' responses: '200': description: >- 200 -- success. Charges 35 credit(s) on this endpoint. cached is always false today -- no Helium endpoint is currently cached. content: application/json: schema: type: object properties: data: type: object properties: newInvestors: type: array items: type: object properties: name: type: string sectorTags: type: array items: type: string geography: type: string lastActivityDate: type: string description: >- ISO date of most recent known investment/activity, if known. portfolioCompanies: type: array items: type: string lpType: type: string enum: - family_office - hnw_individual - recently_exited_founder - institutional - angel exitSizeUsd: type: number description: >- fund_lp side only -- the candidate's own exit size, if a recently-exited founder. networkProximity: type: number enum: - 0 - 1 description: >- 1 if a warm path was found via an imported network (see import_network). score: type: number tier: type: string enum: - A - B - C warmPath: type: boolean lookalikeVia: type: string description: >- Set when this candidate scored a boost for having backed a named competitor. rationale: type: string description: >- LLM-written 1-2 sentence fit rationale. Only present for the top-ranked candidates in a result set. conflict: type: boolean description: >- True if the rationale pass flagged a likely conflict (e.g. funded a direct competitor). firstSeenAt: type: string format: date-time description: >- When this investor was first added to your stored investor list. lastUpdatedAt: type: string format: date-time lookalikeCompanies: type: array items: type: string description: >- Every company this investor has been surfaced as a lookalike funder for, across every find_lookalike_investors call that has ever matched them. additionalProperties: true description: >- Investors not already on your stored investor list before this call. updatedInvestors: type: array items: type: object properties: name: type: string sectorTags: type: array items: type: string geography: type: string lastActivityDate: type: string description: >- ISO date of most recent known investment/activity, if known. portfolioCompanies: type: array items: type: string lpType: type: string enum: - family_office - hnw_individual - recently_exited_founder - institutional - angel exitSizeUsd: type: number description: >- fund_lp side only -- the candidate's own exit size, if a recently-exited founder. networkProximity: type: number enum: - 0 - 1 description: >- 1 if a warm path was found via an imported network (see import_network). score: type: number tier: type: string enum: - A - B - C warmPath: type: boolean lookalikeVia: type: string description: >- Set when this candidate scored a boost for having backed a named competitor. rationale: type: string description: >- LLM-written 1-2 sentence fit rationale. Only present for the top-ranked candidates in a result set. conflict: type: boolean description: >- True if the rationale pass flagged a likely conflict (e.g. funded a direct competitor). firstSeenAt: type: string format: date-time description: >- When this investor was first added to your stored investor list. lastUpdatedAt: type: string format: date-time lookalikeCompanies: type: array items: type: string description: >- Every company this investor has been surfaced as a lookalike funder for, across every find_lookalike_investors call that has ever matched them. additionalProperties: true description: >- Investors already on your list, refreshed by this call. companiesSearched: type: array items: type: string description: >- Company names actually researched this call (bounded by a small per-call cap). companiesSkipped: type: array items: type: string description: >- Company names provided/defaulted but not researched this call because the per-call cap was already reached. companyResults: type: array items: type: object properties: company: type: string status: type: string enum: - ok - no_profile - no_company_match - no_funders_found - margin_capped fundersFound: type: number additionalProperties: true additionalProperties: true description: >- Which investors were newly found vs. already known, plus per-company research detail. credits_charged: type: number description: 35 credit(s), charged even on a miss. credits_remaining: type: number cached: type: boolean description: >- Always false today -- no Helium endpoint is currently cached. request_id: type: string format: uuid required: - data - credits_charged - credits_remaining - cached - request_id '401': description: >- 401 unauthorized -- missing or invalid `Authorization: Bearer ` header. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '402': description: >- 402 insufficient_credits -- not enough credit balance to cover this endpoint's price. The vendor is never called. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: >- 422 not_found -- the vendor was called successfully but returned no result. Still charged at full price. content: application/json: schema: allOf: - $ref: '#/components/schemas/ErrorResponse' - type: object properties: credits_charged: type: number description: >- Full listed price -- every Helium billed endpoint charges on a miss. '429': description: 429 rate_limited -- per-key fixed-window rate limit exceeded. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '502': description: >- 502 vendor_error -- the upstream vendor call failed or threw. Any reserved credits are refunded in full. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '503': description: >- 503 vendor_capacity -- this endpoint's vendor has hit its global daily spend cap. No credits are reserved; try again later. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: FindLookalikeInvestorsRequest: type: object properties: company_names: type: array items: type: string minLength: 1 ErrorResponse: type: object description: >- Standard error body. Every response (success or error) carries a request_id for support reference. properties: error: type: string description: Machine-readable error code. enum: - unauthorized - insufficient_credits - not_found - rate_limited - vendor_error - vendor_capacity message: type: string description: Human-readable error detail. request_id: type: string format: uuid credits_remaining: type: number description: >- Present whenever a post-reservation/refund balance is known for this request. refund_issue: type: boolean description: >- Set only when a compensating credit refund itself failed (e.g. a transient store error) -- the customer may have been charged without the refund landing yet. required: - error - message - request_id securitySchemes: bearerAuth: type: http scheme: bearer ````