import {z} from 'zod' export type CreateApiApiV2ArtistUuidAudiencePlatformReportArgs = {uuid: string, platform: string}; export type CreateApiApiV2ArtistUuidAudiencePlatformReportOptions = {baseUrl: string, fetch?: typeof fetch | undefined}; export const coordinates = z.object({latitude: z.number().optional(), longitude: z.number().optional()}); export const country2 = z.object({code: z.string().optional(), name: z.string().optional(), coordinates: coordinates.optional()}); export const geo = z.object({country: country2.optional()}); export const language = z.object({name: z.string().optional(), code: z.string().optional()}); export const recentPostTypeStat = z.object({type: z.string().optional(), value: z.number().optional()}); export const userProfile = z.object({accountType: z.string().optional(), ageGroup: z.string().optional(), description: z.string().optional(), fullName: z.string().optional(), gender: z.string().optional(), geo: geo.optional(), verified: z.boolean().optional(), language: language.optional(), officialArtist: z.boolean().optional(), recentPostTypeStats: z.array(recentPostTypeStat).optional(), accountCategory: z.string().optional()}); export const codeWeight = z.object({code: z.string().optional(), weight: z.number().optional()}); export const sponsor = z.object({username: z.string().optional()}); export const post = z.object({likeCount: z.number().int().optional(), commentCount: z.number().int().optional(), playCount: z.number().int().optional(), viewCount: z.number().int().optional(), shareCount: z.number().int().optional(), saveCount: z.number().int().optional(), date: z.string().optional(), imageUrl: z.string().optional(), url: z.string().optional(), text: z.string().optional(), mentions: z.array(z.string()).optional(), hashTags: z.array(z.string()).optional(), sponsor: sponsor.optional()}); export const reel = z.object({date: z.string().optional(), url: z.string().optional(), text: z.string().optional(), likeCount: z.number().int().optional(), commentCount: z.number().int().optional(), playCount: z.number().int().optional(), mentions: z.array(z.string()).optional()}); export const top = z.object({mentions: z.array(codeWeight).optional(), hashtags: z.array(codeWeight).optional(), posts: z.array(post).optional(), commercialPosts: z.array(post).optional(), recentPosts: z.array(post).optional(), reels: z.array(reel).optional(), recentReels: z.array(reel).optional()}); export const stats = z.object({followerCount: z.number().int().optional(), postCount: z.number().int().optional(), viewCount: z.number().int().optional(), engagementCount: z.number().int().optional(), averageLikesPerPost: z.number().optional(), averageCommentsPerPost: z.number().optional(), averageViewsPerPost: z.number().optional(), engagementRate: z.number().optional(), averageReelsPlays: z.number().int().optional(), totalLikes: z.number().int().optional(), averageSharePerPost: z.number().optional(), averageSavePerPost: z.number().optional(), averageDislike: z.number().optional(), hiddenLikePosts: z.number().int().optional(), hiddenLikePostsRate: z.number().optional(), paidPostPerformance: z.number().optional()}); export const genderPerAge = z.object({code: z.string().optional(), maleWeight: z.number().optional(), femaleWeight: z.number().optional()}); export const countryWeight = z.object({weight: z.number().optional(), countryName: z.string().optional(), countryCode: z.string().optional()}); export const cityWeight = z.object({weight: z.number().optional(), countryName: z.string().optional(), countryCode: z.string().optional(), region: z.string().optional(), cityName: z.string().optional()}); export const user = z.object({username: z.string().optional(), fullName: z.string().optional(), followerCount: z.number().int().optional(), engagementCount: z.number().int().optional(), averageLikes: z.number().optional(), averageViews: z.number().optional(), averageComments: z.number().optional(), url: z.string().optional(), imageUrl: z.string().optional(), countryCode: z.string().optional(), countryName: z.string().optional()}); export const lookalike = z.object({username: z.string().optional(), fullName: z.string().optional(), followerCount: z.number().int().optional(), engagementCount: z.number().int().optional(), averageLikes: z.number().optional(), averageViews: z.number().optional(), averageComments: z.number().optional(), url: z.string().optional(), imageUrl: z.string().optional(), countryCode: z.string().optional(), countryName: z.string().optional(), score: z.number().optional()}); export const affinityWeight = z.object({name: z.string().optional(), weight: z.number().optional(), affinity: z.number().optional()}); export const audienceDetail = z.object({genders: z.array(codeWeight).optional(), ages: z.array(codeWeight).optional(), gendersPerAge: z.array(genderPerAge).optional(), ethnicities: z.array(codeWeight).optional(), languages: z.array(codeWeight).optional(), countries: z.array(countryWeight).optional(), cities: z.array(cityWeight).optional(), notableUsers: z.array(user).optional(), types: z.array(codeWeight).optional(), credibility: z.number().optional(), credibilityClass: z.string().optional(), reachabilities: z.array(codeWeight).optional(), notableUsersRatio: z.number().optional(), lookalikes: z.array(lookalike).optional(), interests: z.array(affinityWeight).optional(), brandAffinities: z.array(affinityWeight).optional(), audienceAccountsCreatedAt: z.array(codeWeight).optional()}); export const relevantTag = z.object({name: z.string().optional(), distance: z.number().optional(), freq: z.number().optional()}); export const audience2 = z.object({stats: stats.optional(), audienceLike: audienceDetail.optional(), audienceFollower: audienceDetail.optional(), audienceCommenter: audienceDetail.optional(), brandsAffinity: z.array(z.string()).optional(), interests: z.array(z.string()).optional(), relevantTags: z.array(relevantTag).optional(), similarUsers: z.array(user).optional()}); export const report = z.object({userProfile: userProfile.optional(), top: top.optional(), audience: audience2.optional()}); export const error = z.object({key: z.string().optional(), code: z.number().int().optional(), message: z.string().optional()}); export const audienceReportResponse = z.object({type: z.string().optional(), object: report.optional(), errors: z.array(error).optional()}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Unlock audience report * * POST /api/v2/artist/{uuid}/audience/{platform}/report */ export const createApiApiV2ArtistUuidAudiencePlatformReport = async (args: CreateApiApiV2ArtistUuidAudiencePlatformReportArgs, options: CreateApiApiV2ArtistUuidAudiencePlatformReportOptions) => { const {baseUrl, fetch: fetchFn = fetch} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") const url = `${baseUrl.replace(/\/+$/, '')}/api/v2/artist/${encodeURIComponent(String(args.uuid))}/audience/${encodeURIComponent(String(args.platform))}/report${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "POST", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(audienceReportResponse, await res.json()) };