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

Bazaarvoice Social Commerce Display (Media) API

The Social Commerce Display API serves visual user-generated content - gallery media, top images, recommendations, Instagram and Facebook sourcing, media upload and reporting, and Schema.org structured data for galleries. Bazaarvoice's own Social Commerce documentation states that all endpoints are served from edge.curalate.com, the platform of Curalate, the visual-commerce company Bazaarvoice acquired; the API still authenticates with an X-Curalate-Api-Key header.

Bazaarvoice Social Commerce Display (Media) API is one of 17 APIs that Bazaarvoice publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Social Commerce, Visual UGC, Galleries, Instagram, and Media. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and API documentation.

This API exposes 17 operations across 17 paths, organized into 7 resource areas, and defines 60 schemas. It is described by OpenAPI 3.0.1, at version V1.

Requests are made against a single base URL, https://edge.curalate.com.

17 operations 17 paths 60 schemas 14 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
V1
Base URL
https://edge.curalate.com
Authentication
API Key
Resource Areas
7

Authentication & Security 1

Bazaarvoice Social Commerce Display (Media) API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-Curalate-Api-Key (ApiKey).

Paths & Operations 17

Across 17 paths, the API surfaces 17 operations — 14 GET, 3 POST. They span 7 resource areas: Media, Report, Upload, Instagram, Facebook, Structured Data, Meta. Each is listed below with its method, path, parameters, and response codes.

Media 4
GET
/v1/media/{dataSourceId}
Get media
21 params → 200400404500503
GET
/v1/media/{dataSourceId}/items/{itemId}
Get media item
8 params → 200400404500503
GET
/v1/media/{dataSourceId}/items/{itemId}/recommendations
Get media item recommendations
3 params → 200400404500503
GET
/v1/media/{dataSourceId}/images/top
Get top media image for a data source
9 params → 200400404500503
Report 1
POST
/v1/media/report/{dataSourceId}/items/{itemId}
Allows end users to report media
2 params body → 200400404500503
Upload 3
POST
/v1/upload/{dataSourceId}
Upload media items
1 param body → 200400404500503
POST
/v1/upload/{dataSourceId}/submit
Submits uploaded content
1 param body → 200400404500503
GET
/v1/upload/{dataSourceId}/video-status/{videoId}
Check on transcode job status for a given video
2 params → 200400404500503
Instagram 3
GET
/v1/instagram/media
Retrieve Instagram media items for the user
4 params → 200400404500503
GET
/v1/instagram/auth/{accessToken}/validation
Validate an Instagram OAuth token
1 param → 200400404500503
GET
/v1/instagram/auth/{code}/exchange
Exchange an Instagram auth code for a long-life token
2 params → 200400404500503
Facebook 4
GET
/v1/facebook/media
Retrieve Facebook media items for the user
4 params → 200400404500503
GET
/v1/facebook/albums
Retrieve Facebook media items for the user
4 params → 200400404500503
GET
/v1/facebook/albums/{albumId}/media
Retrieve Facebook media items from the specified album
5 params → 200400404500503
GET
/v1/facebook/auth/{accessToken}/validation
Validate a Facebook OAuth token
1 param → 200400404500503
Structured Data 1
GET
/v1/structured-data/content
Get structured data for multiple galleries
4 params → 200400404500
Meta 1
GET
/api/v1/version
Get the current running version of this server
→ 200

Schemas 60

The contract defines 60 schemas that model the data the API accepts and returns. The most detailed are ContentSource (14 properties), NetworkPhoto (11 properties), ProductDetails (8 properties), MediaItem (7 properties). Each schema is shown below with its type and property counts.

DataSourceId
object
1 property 1 required
FilterQuery
object
1 property 1 required
BookmarkQuery
object
1 property 1 required
LocaleString
object
1 property 1 required
ProductMetadataQuery
object
1 property 1 required
AppId
object
1 property 1 required
Clickthrough
object
1 property 1 required
ContentSource
object
14 properties 3 required
Cursors
object
2 properties
GetMediaResponse
object
3 properties 3 required
Image
object
1 property 1 required
LocationDetails
object
3 properties
MediaApiMetadata
object
6 properties 1 required
MediaApiPaging
object
3 properties 1 required
MediaItem
object
7 properties 4 required
MediaItemsData
object
2 properties 2 required
NetworkGif
NetworkMedia
object
NetworkPhoto
object
11 properties 10 required
NetworkUser
object
6 properties
NetworkVideo
PdpMetadata
object
2 properties
Price
object
7 properties 1 required
ProductDetails
object
8 properties 5 required
ReviewStat
object
4 properties 1 required
SpatialTag
object
3 properties 3 required
ThumbnailPhoto
object
5 properties 5 required
Video
object
1 property 1 required
ErrorPayload
object
4 properties 2 required
DeetsItemId
object
1 property 1 required
GetMediaItemResponse
object
2 properties 2 required
MediaItemData
object
1 property 1 required
GetRecommendedMediaResponse
object
2 properties 2 required
ReportMediaRequestBody
object
3 properties 3 required
ReportMediaResponse
object
1 property 1 required
UploadData
object
2 properties 2 required
UploadError
object
3 properties 2 required
UploadResponse
object
2 properties 1 required
UploadVideoResponse
object
1 property 1 required
SubmitMediaRequestBody
object
7 properties 5 required
SubmittedMedia
object
5 properties 1 required
SubmitMediaResponse
object
1 property 1 required
VideoId
object
1 property 1 required
GetVideoStatusResponse
object
1 property 1 required
VideoProcessingStatusData
object
1 property 1 required
VideoProcessingVersion
object
5 properties 4 required
VideoProcessingVideo
object
4 properties 3 required
OAuthAccessToken
object
1 property 1 required
ExternalMedia
object
5 properties 3 required
GetInstagramMediaData
object
1 property 1 required
GetInstagramMediaResponse
object
2 properties 2 required
GetFacebookMediaData
object
1 property 1 required
GetFacebookMediaResponse
object
2 properties 2 required
FacebookAlbum
object
2 properties 2 required
GetFacebookAlbumsData
object
1 property 1 required
GetFacebookAlbumsResponse
object
2 properties 2 required
ValidTokenResponse
object
OAuthCode
object
1 property 1 required
ExchangeCodeResponse
object
3 properties 2 required
VersionResponse
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

bazaarvoice-social-commerce-media-openapi.yml Raw ↑

Other APIs Bazaarvoice publishes across the network.

Bazaarvoice Answers API
Bazaarvoice Clients API
Bazaarvoice Contributor API
Bazaarvoice Lookahead API
Bazaarvoice Questions API
Bazaarvoice Reviews API
Bazaarvoice Conversations Display API
Bazaarvoice Conversations Submission API
Bazaarvoice Response API
Bazaarvoice Response Count API
Bazaarvoice Notifications Subscriptions API
Bazaarvoice Transactions API
Where this information came from

This is an independent, third-party profile of Bazaarvoice Social Commerce Display (Media) 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.