How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Mavrck Brand Suitability API

The BrandSuitability API from Mavrck — 14 operation(s) for brandsuitability.

Mavrck Brand Suitability API is one of 183 APIs that Mavrck publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Brand Suitability. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

This API exposes 17 operations across 14 paths, and defines 33 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 2 base URLs: http://app.splashscore.com/v1, https://app.splashscore.com/v1.

17 operations 14 paths 33 schemas 1 DELETE9 GET4 POST3 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.mavrck.co/v1
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Mavrck Brand Suitability API declares 1 security scheme for authenticating requests. An API key is passed in the header as api-key (apiKey). By default, every request must be authenticated.

Paths & Operations 17

Across 14 paths, the API surfaces 17 operations — 1 DELETE, 9 GET, 4 POST, 3 PUT. Each is listed below with its method, path, parameters, and response codes.

BrandSuitability 17
GET
/v1/brand-suitability/global-users
Frontend: unused for now -- TODO for admin view.
getCreatorsWithReports 1 param → 200400403404500
GET
/v1/brand-suitability/global-users/{globalUserId}/reports/{reportId}
Frontend: Lightbox (polling during generation), Admin DetailView
getReportById 2 params → 200400403404500
DELETE
/v1/brand-suitability/global-users/{globalUserId}/reports/{reportId}
deleteReport 2 params → 200400403404500
GET
/v1/brand-suitability/global-users/{globalUserId}/report
Frontend: Lightbox reports
getLatestReport 2 params → 200400403404500
GET
/v1/brand-suitability/global-users/{globalUserId}/reports
Frontend: Admin — DetailView, ReportsSelector
getReportsForCreator 2 params → 200400403404500
POST
/v1/brand-suitability/global-users/{globalUserId}/reports
Frontend: Lightbox — generate + refresh buttons, Admin DetailView
generateReport 1 param body → 201400403404500
POST
/v1/brand-suitability/global-users/{globalUserId}/reports/sync
Frontend: Admin — DetailView
generateReportSync 1 param body → 201400403404500
PUT
/v1/brand-suitability/global-users/{globalUserId}/research/refresh
Frontend: unused (async version)
refreshCreatorResearch 3 params → 200400403404500
PUT
/v1/brand-suitability/global-users/{globalUserId}/research/refresh/sync
Frontend: Admin — DetailView, TableView
refreshCreatorResearchSync 3 params → 200400403404500
GET
/v1/brand-suitability/global-users/{globalUserId}/research
Frontend: Admin — DetailView
getCreatorResearch 1 param → 200400403404500
GET
/v1/brand-suitability/global-users/{globalUserId}/research/status
getCreatorResearchStatus 1 param → 200400403404500
PUT
/v1/brand-suitability/global-users/{globalUserId}/reports/{reportId}/findings/exclude
Frontend: Lightbox — ResearchFindingsTable action bar
updateFindingExclusions 2 params body → 200400403404500
GET
/v1/brand-suitability/stats
getReportStats → 200400403404500
POST
/v1/brand-suitability/batches
Frontend: Bulk dashboard — create a batch of reports for a set of creators (explicit ids or a search query).
createBatch body → 202400403404500
GET
/v1/brand-suitability/batches
Frontend: Bulk dashboard — list batches for the community (cached counters; no report reads).
listBatches → 200400403404500
GET
/v1/brand-suitability/batches/{batchId}
Frontend: Bulk dashboard — batch detail: per-creator status table + derived counts.
getBatch 1 param → 200400403404500
POST
/v1/brand-suitability/batches/{batchId}/creators
Frontend: Bulk dashboard — add more creators to an existing batch (R4).
addBatchCreators 1 param body → 202400403404500

Schemas 33

The contract defines 33 schemas that model the data the API accepts and returns. The most detailed are BatchListItem (13 properties), BatchReportItem (12 properties), StoredFinding (11 properties), BatchDetailResponse (11 properties). Each schema is shown below with its type and property counts.

BrandSuitabilityReport
object
BrandSuitabilityReportSummary
object
8 properties 7 required
AddCreatorsRequest
object
1 property 1 required
NotFoundError
object
2 properties 2 required
GetCreatorsWithReportsResponse
object
2 properties 2 required
ReportStatsResponse
object
5 properties 5 required
BatchReportItem
object
12 properties 4 required
GenerateReportRequest
object
3 properties
CreatorResearchRecord
object
7 properties 6 required
GetBrandSuitabilityReportResponse
object
2 properties 1 required
DataScoreLevelDTO
string
Brand Suitability LLM/assessment output DTOs. v0.3 UI: notes track field consumption by the v0.3 report view. "unused" = not read by v0.3 (may be used by legac…
ForbiddenError
object
2 properties 2 required
AddCreatorsResponse
object
1 property 1 required
DeleteReportResponse
object
2 properties 2 required
BrandSuitabilityReportProgress
string
ServerError
object
2 properties 2 required
CreateBatchResponse
object
2 properties 2 required
ListBatchesResponse
object
1 property 1 required
CreatorWithReports
object
3 properties 2 required
BatchSummaryCounts
object
4 properties 4 required
StoredFinding
object
11 properties
CreateBatchRequest
object
7 properties
BatchDetailResponse
object
11 properties 6 required
BatchMetricRisk
object
5 properties 4 required
BatchListItem
object
13 properties 8 required
FindingExclusion
object
2 properties 2 required
ValidateErrorJSON
object
2 properties 2 required
UpdateFindingExclusionsRequest
object
1 property 1 required
BatchStatus
string
GenerateReportResponse
object
3 properties 2 required
ExtractedAttributes
object
6 properties 6 required
GetReportsForCreatorResponse
object
1 property 1 required
BrandSuitabilityReportStatus
string

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

mavrck-brandsuitability-api-openapi.yml Raw ↑

Other APIs Mavrck publishes across the network.

Later Influence (Mavrck) Reporting API
Mavrck Platform API
Mavrck Workflow Stage Change Event Webhook
Mavrck Account Invitations API
Mavrck Action Groups API
Mavrck Action Group Brief API
Mavrck Action Group Bulk Scheduled Messages API
Mavrck Action Group Conversation Templates API
Mavrck Action Group Custom Influencer Statuses API
Mavrck Action Group Custom Statuses API
Mavrck Action Groups API
Mavrck Action Group Scheduled Messages API
Where this information came from

This is an independent, third-party profile of Mavrck Brand Suitability API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.