upriver-ai Creators API is one of 12 APIs that upriver-ai publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
This API exposes 6 JSON Schema definitions.
Tagged areas include Creators. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.
This API exposes
5 operations
across 5 paths,
and defines 46 schemas.
It is described by OpenAPI 3.2.0, at version 1.0.0.
Requests are made against a single base URL, https://api.upriver.ai.
The identity and technical contract details declared by the specification.
EnrichmentSkipReason
object
Structured reason why an enrichment block was deterministically skipped.
3 properties
3 required
CreatorBatchItemResult
object
Result for a single URL in the batch response. On success: contains url, channels, labels, tags (no error field). On failure: contains url, error (no channels/…
7 properties
1 required
CreatorBatchResponse
object
Response for batch creator lookup.
3 properties
3 required
CreatorSkippedEnrichments
object
Compact metadata for omitted enrichment blocks.
2 properties
2 required
CreatorSimilarAnchor
object
Requested and resolved identity for a similarity search.
5 properties
2 required
CreatorOriginEvidence
object
2 properties
2 required
CreatorBio
object
Biographical summary of a creator.
3 properties
CreatorSimilarValidationErrorResponse
object
Field-validation error returned before similarity execution begins.
1 property
1 required
FollowerBucket
object
Advertiser-facing follower bucket for a channel.
4 properties
3 required
CreatorSearchResult
object
Single search match containing primary channels for a creator.
13 properties
AudienceAge
object
Age distribution with confidence. The minage/maxage range is a directional envelope where the creator has meaningful audience concentration. It is not an exact…
4 properties
CreatorSearchInput
object
Input payload for creator discovery.
18 properties
CreatorBatchInput
object
Input payload for batch creator lookup.
1 property
1 required
RelativeMetrics
object
Public benchmark summaries relative to similar creators.
1 property
CreatorSimilarChannel
object
Lean owned-channel reference returned for a similar creator.
4 properties
2 required
EngagementMetrics
object
Engagement metrics from recent videos/posts.
4 properties
CreatorRedirectInfo
object
Metadata about a creator ID redirect/merge.
3 properties
2 required
HTTPValidationError
object
1 property
RelativeMetricSignal
object
Public-facing benchmark summary for a single metric.
1 property
1 required
CreatorSimilarity
object
Evidence supporting one creator-peer result.
1 property
1 required
CreatorPlatform
object
Primary social profile discovered for a creator.
13 properties
3 required
RelativeEngagementMetrics
object
Relative benchmark output for engagement metrics.
3 properties
1 required
VideoMetrics
object
Video-specific metrics for ad inventory estimation. Computed from the creator's trailing 12-week long-form upload window. Includes average duration (useful for…
6 properties
CreatorLabel
object
Descriptive label for a creator (category or tag). Labels come in two types: - category: Stable classifications from the taxonomy (see /mediacategories). Use t…
5 properties
3 required
CreatorSimilarResult
object
Lean canonical creator returned by creator-peer discovery.
6 properties
5 required
CreatorTag
object
User-facing tag object for creator search results. Deprecated: Use CreatorLabel instead for richer metadata.
2 properties
2 required
CreatorSimilarErrorDetail
object
Stable machine-readable creator-similarity error.
2 properties
2 required
AudienceGender
object
Gender distribution with confidence. The percentage field is only included when explicit numerical data exists. When gender skew is inferred without specific p…
3 properties
ValidationError
object
3 properties
3 required
AudienceGeography
object
Geographic distribution with confidence. The countries field lists countries where the creator has significant audience presence — NOT necessarily ranked by do…
3 properties
RelativeMetricBenchmarkBasis
object
Public explanation of which peer cohort powered a benchmark.
5 properties
4 required
CreatorSimilarErrorResponse
object
Error envelope returned by the similar-creators endpoint.
1 property
1 required
CreatorSimilarResponse
object
Envelope returned by the similar-creators endpoint.
5 properties
3 required
RelativeMetricContentCategory
object
Content category actually used in a public benchmark basis.
2 properties
2 required
CreatorSimilarityReason
object
Factual display evidence explaining a similarity result.
2 properties
2 required
CreatorAssociatedCreator
object
Reference to a related but separate creator cluster.
2 properties
2 required
CreatorSearchResponse
object
Envelope returned by the creator search endpoint.
2 properties
CreatorLocationCandidate
object
3 properties
3 required
CreatorGetResponse
object
Response returned by the creator get endpoint.
11 properties
AudienceLanguageSegment
object
Language segment with percentage breakdown.
2 properties
2 required
CreatorAudience
object
Audience demographic information for a creator. All fields are directional signals — they indicate where the creator has significant audience presence, not exa…
7 properties
AudienceAgeSegment
object
Age segment with percentage breakdown.
3 properties
1 required
AudienceLanguages
object
Language distribution with confidence. The breakdown field is only included when explicit percentage data exists. When language is inferred without specific br…
3 properties
1 required
CreatorLocation
object
3 properties
1 required
AudienceCountrySegment
object
Country segment with optional percentage breakdown.
3 properties
1 required
The full machine-readable OpenAPI contract behind this narrative.
Other APIs upriver-ai publishes across the network.
