Skip to navigation

Get One Person Blog Post

View as Markdown

Returns one person-owned external link by id. Any signed-in user may call this.

Authentication

AuthorizationBearer

Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token

Path parameters

personIdstringRequiredformat: "uuid"
Person UUID owning the blog post row
blogPostIdstringRequiredformat: "uuid"
Blog post UUID

Response headers

X-RateLimit-Limitinteger

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-Remaininginteger

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-Resetinteger

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

OK
createdAtdatetime
idstringformat: "uuid"

Type-safe UUID identifier for research-side external blog article links

isCurrentboolean
mentionedEntityIdlist of strings

Entities mentioned in the blog-post body, excluding the owner

mentionedPersonIdlist of strings

People mentioned in the blog-post body, excluding the owner

ownerobject

Owning record, nested ids only: owner.entityId or owner.personId — exactly one is set.

typeenum

External research-side blog-post source classification

updatedAtdatetime
urlstring
authorstring or nullOptional

Blog-post author when discovered by ingest

externalIdstring or nullOptional

Stable external feed/item identifier when available

lastFetchedAtdatetime or nullOptional

Last time ingest fetched or summarized this blog-post URL

publishedAtdatetime or nullOptional
summarystring or nullOptional

LLM-generated blog-post summary from blog-post-ingest

summaryGeneratedAtdatetime or nullOptional
Timestamp when summary was last generated
titlestring or nullOptional
topicstring or nullOptional

Nullable Library topic key the article classifier assigned: funding, product, partnership, acquisition, leadership, legal, research, financials, careers, blog, or press. Rows classified before that classifier may still carry a web-crawl section key.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
406
Not Acceptable Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error