Use Cases and Examples

Each recipe below answers one job with real calls and real responses, abridged. Every call is deterministic: the same input returns the same record, and nothing is guessed from a name. Finish a quickstart first so you are signed in.

The examples use Stripe (4eabfc26-3ed9-4ad3-a935-9be07ae3329a), Sequoia Capital, and Patrick Collison. Swap in your own ids.

Get a Company Brand Kit From Its Website

Send any website or profile URL the company owns and read its brand name, legal name, logo, links, and tags from the full record. The lookup ignores the scheme, a leading www., and host case; a different path is a different URL.

curl -s -H "Authorization: Bearer $AUTH_TOKEN" \
  "https://api.aventure.vc/v1/entities/lookup-exact?url=stripe.com" |
  jq '{id: .core.id, nameBrand: .core.nameBrand, nameLegal: .core.nameLegal,
       tag: [.enrichment.classification.tag[] | {name, isPrimary}],
       link: [.enrichment.urlLink[] | {url, urlType}]}'

{
  "id": "4eabfc26-3ed9-4ad3-a935-9be07ae3329a",
  "nameBrand": "Stripe",
  "nameLegal": "Stripe, Inc.",
  "tag": [
    { "name": "Fintech", "isPrimary": false },
    { "name": "Platform", "isPrimary": false },
    { "name": "SaaS", "isPrimary": true }
  ],
  "link": [
    { "url": "https://github.com/stripe", "urlType": "github" },
    { "url": "https://www.linkedin.com/company/stripe", "urlType": "linkedin" },
    { "url": "https://x.com/stripe", "urlType": "twitter" }
  ]
}

For a logo you can put in an <img> tag, read the logo slot with the core.id from the first call. Its cdnUrl is a full image URL:

curl -H "Authorization: Bearer $AUTH_TOKEN" \
  "https://api.aventure.vc/v1/entities/4eabfc26-3ed9-4ad3-a935-9be07ae3329a/logo"

{
  "path": "/logos/gfc/gfcNIiXzgUdP6tGupXsKe.png",
  "cdnUrl": "https://images-v2.aventure.vc/logos/gfc/gfcNIiXzgUdP6tGupXsKe.png"
}

The full record counts one company profile view; reading it again that month is free. A domain that two records share answers 409; add typeRecord, such as typeRecord=Investment Firm, to pick one.

Match a List of Websites to Companies

POST /v1/entities/lookup-matches answers one row per input, in input order, so you can join the answer back to a spreadsheet or CRM export. Each row’s status is MATCHED, AMBIGUOUS, or MISSING.

curl -X POST -H "Authorization: Bearer $AUTH_TOKEN" -H "Content-Type: application/json" \
  -d '{"url": ["stripe.com", "notion.so", "zzqx-unknown-domain-4417.com"]}' \
  "https://api.aventure.vc/v1/entities/lookup-matches"

[
  { "input": "stripe.com", "inputType": "URL", "status": "MATCHED", "detail": { "core": { "nameBrand": "Stripe" } } },
  { "input": "notion.so", "inputType": "URL", "status": "MATCHED", "detail": { "core": { "nameBrand": "Notion", "slug": "notion" } } },
  { "input": "zzqx-unknown-domain-4417.com", "inputType": "URL", "status": "MISSING", "candidateEntityId": [] }
]

An AMBIGUOUS row lists the records that share the URL in candidateEntityId; read each by id to choose. The body also takes entityId and slug arrays. Each matched record counts one profile view. POST /v1/entities/lookup-batch takes the same body but returns only the records it found, as a page, and drops the rest. To identify a bare name with no URL, use Identify a company or person.

Build a Target List With Filters

Filters on the company list combine, and totalElements sizes the whole market. This one finds seed-stage fintech companies headquartered in New York.

curl -H "Authorization: Bearer $AUTH_TOKEN" \
  "https://api.aventure.vc/v1/entities?stage=Seed&tag=Fintech&headquartersState=New%20York&size=3"

The answer counts 111 companies, led by Alloy (alloy-brooklyn-ny-us), Floret, and Parthean. Each row’s name and slug sit at content[].core.nameBrand and content[].core.slug.

Filter values are case-sensitive display names: the tag is Fintech, and the state is New York, not NY. GET /v1/entities/filters (CLI: aventure entities filters list) lists every accepted value. Pagination and filtering covers paging through the full list.

Read a Funding History and the Investors in a Round

List the rounds newest first, then name a round’s label to list its investors.

curl -H "Authorization: Bearer $AUTH_TOKEN" \
  "https://api.aventure.vc/v1/entities/4eabfc26-3ed9-4ad3-a935-9be07ae3329a/fundraise-rounds?size=5&sort=dateAnnounced,desc"
curl -H "Authorization: Bearer $AUTH_TOKEN" \
  "https://api.aventure.vc/v1/entities/4eabfc26-3ed9-4ad3-a935-9be07ae3329a/fundraise-investor-joins?round=Series%20I&size=5"

Stripe has 19 rounds. Its Series I:

{
  "id": "1d9e0ca8-6653-40ee-93ac-6c000e08fe98",
  "round": "Series I",
  "amountRaised": 6500000000,
  "currency": "USD",
  "dateAnnounced": "2023-03-15T00:00:00.000Z",
  "investorCount": 10
}

Each investor row names the investor by id only, in investor.entityId or investor.personId. Send several firm ids to the company list at once (aventure entities list --entity-id <id> <id>) to read their names; for this round they include General Catalyst, Thrive Capital, and Goldman Sachs Asset Management. entityId is always the company that raised, never the investor. Amounts stay in each round’s own currency, and a missing amount does not mean zero.

List the Recent Portfolio of an Investor

Resolve the firm from its website, then list what it backed. A firm’s website can also belong to its fund records, so name the record type.

curl -H "Authorization: Bearer $AUTH_TOKEN" \
  "https://api.aventure.vc/v1/entities/lookup-exact?url=sequoiacap.com&typeRecord=Investment%20Firm"
curl -H "Authorization: Bearer $AUTH_TOKEN" \
  "https://api.aventure.vc/v1/entities/9187060c-8107-4f4c-9719-f185d2c8ee7d/investments?latestPerEntity=true&dateFrom=2025-01-01&size=3"

Sequoia Capital has 44 portfolio companies with a round since January 2025. The newest, abridged:

{
  "round": "Series B",
  "amountRaised": 50000000,
  "currency": "USD",
  "dateAnnounced": "2026-09-30T00:00:00.000Z",
  "entity": { "core": { "nameBrand": "Flow Engineering", "slug": "flow-engineering-san-francisco-ca-us" } },
  "investorAttribution": { "leadInvestor": false, "attributionType": "direct" }
}

latestPerEntity=true keeps one row per company. dateFrom and dateTo take YYYY-MM-DD. For an angel investor, GET /v1/people/{personId}/investments (CLI: aventure people investments list) lists the person’s investments. It has no date or one-row-per-company filter, so sort it with sort=date,desc. The reverse question, who backed one company, is GET /v1/entities/{entityId}/investors.

Trace Every Company a Founder Has Worked At

Resolve the person from a profile URL or slug, then list every role, current and past.

curl -H "Authorization: Bearer $AUTH_TOKEN" \
  "https://api.aventure.vc/v1/people/lookup-exact?url=linkedin.com/in/patrickcollison"
curl -H "Authorization: Bearer $AUTH_TOKEN" \
  "https://api.aventure.vc/v1/people/44a15937-50df-4970-a32e-130e2c3ca150/entities?size=5"

[
  { "entityName": "Stripe", "entitySlug": "stripe-south-san-francisco-ca-us", "titleName": "Co-Founder & CEO", "isCurrent": true },
  { "entityName": "Auctomatic", "entitySlug": "auctomatic-san-francisco-ca-us", "titleName": "Cofounder", "isCurrent": false,
    "startDate": "2007-01-01T00:00Z", "endDate": "2008-01-01T00:00Z" }
]

The person lookup counts one person profile view; the role list does not. GET /v1/entities/{entityId}/people answers the reverse question: who works at one company.

Find the Competitors of a Company

curl -H "Authorization: Bearer $AUTH_TOKEN" \
  "https://api.aventure.vc/v1/entities/4eabfc26-3ed9-4ad3-a935-9be07ae3329a/similar?relationshipType=competitor&size=5"

Each row pairs a company with why it is listed:

{
  "entity": { "core": { "nameBrand": "Block", "slug": "block-san-francisco-ca-us" } },
  "similarity": {
    "origin": "curated",
    "curatedRelationshipType": "competitor",
    "curatedSource": "Stripe competes with Block across payments and financial infrastructure."
  }
}

Stripe’s stored competitors include Block, Wise, and Visa. Without relationshipType, the list ranks every similar company. This read is free on every plan. To find companies that match a description instead of a known company, use POST /v1/search/natural/entities (CLI: aventure search natural entities --query "...").

Monitor News About a Company

Ask for articles linked to a company since your last check.

curl -H "Authorization: Bearer $AUTH_TOKEN" \
  "https://api.aventure.vc/v1/news?owner.entityId=4eabfc26-3ed9-4ad3-a935-9be07ae3329a&publishedAfter=2026-09-01&size=3"

Each article carries title, publication, publishedAt, excerpt, and newsUrlOriginal, newest first. publishedAfter includes the date you send, so store the date of each check and send it next time. The query key is the dotted owner.entityId; owner.personId does the same for a person. An article can mention the company in passing, so read its excerpt before you alert on it. To start from an article instead, identify names in an article finds every company and person it names.

Costs at a Glance

Plans and usage covers every allowance, and the API reference lists every parameter and response field.