Skip to navigation
Guides

Answer a Real Question

Go from a question to funding rounds in three calls with the API, CLI, or MCP server
View as Markdown

The question: which seed-stage companies in Austin are in the dataset, and what has one of them raised? Each step shows the API, CLI, and MCP form. Finish a quickstart first so you are signed in.

1

Narrow the Dataset to the Companies You Mean

Filters go in the company search’s JSON body, and they combine. "typeRecord":["Company"] excludes products, services, and other record types. stage and headquartersCity narrow the companies further.

curl -X POST -H "Authorization: Bearer $AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"typeRecord":["Company"],"headquartersCity":["Austin"],"stage":["Seed"]}' \
  "https://api.aventure.vc/v1/entities/search?size=5"

totalElements counts the whole matching set, not only your page, so it answers “how many are there”. content holds up to five records. Each record’s core.slug identifies it for the next step.

Location filters take the full name, not the postal abbreviation: "headquartersState":["Texas"] matches, and "headquartersState":["TX"] returns no records. Pagination and filtering explains how filters combine.

2

Open One Record

Take core.slug from a record in the previous response, such as closing-theory-austin-tx-us, and read the full record. The response includes the record’s identity, research, linked news, and linked people. Its core.id is the UUID that funding-round operations take.

curl -H "Authorization: Bearer $AUTH_TOKEN" \
  "https://api.aventure.vc/v1/entities/lookup-exact?slug=closing-theory-austin-tx-us"

The API parameter is slug on every surface. The CLI names the flag --entity-slug so that it cannot be confused with the --slug flag of batch commands.

3

Read the Funding Rounds

core.id from step 2 is the entityId path parameter here.

curl -H "Authorization: Bearer $AUTH_TOKEN" \
  "https://api.aventure.vc/v1/entities/03418f84-8e9f-4f68-b82c-1fd35a15e083/fundraise-rounds?size=3"

Each round carries round, amountRaised, currency, dateAnnounced, and investorCount:

{
  "content": [
    {
      "id": "65296e8c-3445-4db2-b69f-929e7ea1484d",
      "round": "Seed",
      "amountRaised": 2300000,
      "currency": "USD",
      "dateAnnounced": "2023-07-24T00:00:00.000Z",
      "investorCount": 3
    }
  ],
  "totalElements": 1
}

amountRaised is in the round’s own currency, and the API does not convert amounts to USD, so convert before you compare rounds. The amount, currency, round, and announcement date can each be null, and a missing amount does not mean zero.

The Pattern Behind Other Questions

These three steps are the pattern for most questions: filter a list, open one record, and read what is attached to it. People and news work the same way, and use cases and examples applies the pattern to brand kits, investor portfolios, founders, competitors, and news. Operations for records attached to a company, such as news, people, and investors, all take the same core.id.

When you have a phrase instead of a set of filters, replace step 1 with search: POST /v1/search searches companies, people, and news together, and aventure search --query "..." is the CLI form. The free plan includes a daily allowance of searches; past it, search needs a paid plan (AI Plus or AI Pro). Search is also rate-limited per account; a 429 with limitType NATURAL_SEARCH means wait the Retry-After seconds before retrying.

Calls draw on your plan’s monthly allowances; opening a full record counts one profile view. Plans and usage explains what counts.

To find the CLI command and MCP tool for any API reference operation, run aventure help <operationId>. It prints the route, the required flags, and the matching MCP tool without calling the API.

Next Steps