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 182 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
Get creators with reports
getCreatorsWithReports 1 param → 200400403404500
GET
/v1/brand-suitability/global-users/{globalUserId}/reports/{reportId}
Get report by id
getReportById 2 params → 200400403404500
DELETE
/v1/brand-suitability/global-users/{globalUserId}/reports/{reportId}
Delete report
deleteReport 2 params → 200400403404500
GET
/v1/brand-suitability/global-users/{globalUserId}/report
Get latest report
getLatestReport 2 params → 200400403404500
GET
/v1/brand-suitability/global-users/{globalUserId}/reports
Get reports for creator
getReportsForCreator 2 params → 200400403404500
POST
/v1/brand-suitability/global-users/{globalUserId}/reports
Generate report
generateReport 1 param body → 201400403404500
POST
/v1/brand-suitability/global-users/{globalUserId}/reports/sync
Generate report sync
generateReportSync 1 param body → 201400403404500
PUT
/v1/brand-suitability/global-users/{globalUserId}/research/refresh
Refresh creator research
refreshCreatorResearch 3 params → 200400403404500
PUT
/v1/brand-suitability/global-users/{globalUserId}/research/refresh/sync
Refresh creator research sync
refreshCreatorResearchSync 3 params → 200400403404500
GET
/v1/brand-suitability/global-users/{globalUserId}/research
Get creator research
getCreatorResearch 1 param → 200400403404500
GET
/v1/brand-suitability/global-users/{globalUserId}/research/status
Get creator research status
getCreatorResearchStatus 1 param → 200400403404500
PUT
/v1/brand-suitability/global-users/{globalUserId}/reports/{reportId}/findings/exclude
Update finding exclusions
updateFindingExclusions 2 params body → 200400403404500
GET
/v1/brand-suitability/stats
Get report stats
getReportStats → 200400403404500
POST
/v1/brand-suitability/batches
Create batch
createBatch body → 202400403404500
GET
/v1/brand-suitability/batches
List batches
listBatches → 200400403404500
GET
/v1/brand-suitability/batches/{batchId}
Get batch
getBatch 1 param → 200400403404500
POST
/v1/brand-suitability/batches/{batchId}/creators
Add batch creators
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.

BatchListItem
object
13 properties 8 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…
GetCreatorsWithReportsResponse
object
2 properties 2 required
BrandSuitabilityReportSummary
object
8 properties 7 required
AddCreatorsRequest
object
1 property 1 required
BrandSuitabilityReportStatus
string
ListBatchesResponse
object
1 property 1 required
StoredFinding
object
11 properties
AddCreatorsResponse
object
1 property 1 required
BatchMetricRisk
object
5 properties 4 required
CreatorWithReports
object
3 properties 2 required
CreateBatchRequest
object
7 properties
NotFoundError
object
2 properties 2 required
BrandSuitabilityReportProgress
string
GetBrandSuitabilityReportResponse
object
2 properties 1 required
GenerateReportResponse
object
3 properties 2 required
GenerateReportRequest
object
3 properties
FindingExclusion
object
2 properties 2 required
CreateBatchResponse
object
2 properties 2 required
CreatorResearchRecord
object
7 properties 6 required
ValidateErrorJSON
object
2 properties 2 required
BatchStatus
string
ReportStatsResponse
object
5 properties 5 required
BrandSuitabilityReport
object
GetReportsForCreatorResponse
object
1 property 1 required
BatchReportItem
object
12 properties 4 required
DeleteReportResponse
object
2 properties 2 required
ForbiddenError
object
2 properties 2 required
BatchDetailResponse
object
11 properties 6 required
UpdateFindingExclusionsRequest
object
1 property 1 required
BatchSummaryCounts
object
4 properties 4 required
ServerError
object
2 properties 2 required
ExtractedAttributes
object
6 properties 6 required

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 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 Group Scheduled Messages API
Mavrck Action Groups Status API
Mavrck Actions API
Mavrck Activations 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.