> ## Documentation Index > Fetch the complete documentation index at: https://docs.creatordb.app/llms.txt > Use this file to discover all available pages before exploring further. # Get Instagram and YouTube brand report > Gets a detailed report about a brand that sponsors creators on YouTube or Instagram. ## OpenAPI ````yaml /api-v2/api-v2.yaml get /brandReportV2 openapi: 3.1.0 info: version: '2' title: CreatorDB Headless APIService description: >- Generated from swaggerComponentIndex.json by core-types-json-schema (https://github.com/grantila/core-types-json-schema). Use OpenAPI 3.1.0 version with direct JSON Schema support termsOfService: https://www.creatordb.app contact: name: CreatorDB url: https://www.creatordb.app email: support@creatordb.app license: url: http://www.apache.org/licenses/LICENSE-2.0.html name: Apache 2.0 x-id: indexForSwagger.yaml servers: - url: https://dev.creatordb.app/v2 description: CreatorDB API Endpoint - prod version security: [] tags: - name: General Operations description: >- General-purpose endpoints such as API status, content retrieval, and cross-platform operations - name: YouTube description: >- YouTube creator data endpoints including basic metrics, historical data, and detailed analytics - name: Instagram description: >- Instagram creator data endpoints with metrics and advanced search capabilities - name: TikTok description: >- TikTok creator data endpoints with metrics and advanced search functionality - name: Threads description: Threads creator data endpoints with basic metrics and historical data - name: Facebook description: Facebook creator data endpoints with metrics and search capabilities - name: Topic description: Topic-based analysis and reporting endpoints for content categorization - name: Brand description: Brand analysis endpoints including sponsor search and brand reports - name: Niches description: Niche-related endpoints for content category analysis and related searches paths: /brandReportV2: get: tags: - Brand summary: Get Instagram and YouTube brand report description: >- Gets a detailed report about a brand that sponsors creators on YouTube or Instagram. operationId: getBrandReportV2 parameters: - name: apiId in: header description: '' required: true schema: type: string examples: - LE6DPZQkR3TQShxofXoD2j8qCBu1-f0jti665m1t50dwDD12W - name: brandId in: query description: '' required: true schema: type: string examples: - acer.com responses: '200': description: OK content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/DetailBrandReportV2' quotaUsed: type: number description: API credits that were used to make this call. quotaUsedTotal: type: number description: Total API credits used since the last billing cycle. remainingPlanCredit: type: number description: >- The number of remaining free API credits that come with your subscription plan. These API credits are renewed every billing cycle. remainingPrepurchasedCredit: type: number description: >- The number of remaining extra purchased API credits. These API credits do not expire until used. timestamp: type: number description: >- Unix timestamp of the call request that the server received. error: type: string description: Errors that occurred during the API call. success: type: boolean description: It is TRUE when the call is successful. examples: default: value: data: ytDgMainCountry: TWN ytDgMainCountryRatio: 0.16812166666666675 ytDgCountryBreakdown: - country: TWN value: 0.16812166666666675 - country: USA value: 0.10227499999999999 - country: IDN value: 0.07609583333333331 ytDgGenderMaleRatio: 0.8128875 ytDgGenderFemaleRatio: 0.18695625 ytDgAvgAge: 33.87639648437501 ytDgAgeBreakdown: - 0.03404609375 - 0.2632984375 - 0.3055140625 brandId: acer.com domain: - acer.co - store.acer.com - acer.link companySize: 501-1,000 medianCompanySize: 750 brandName: Acer description: >- Acer is a Taiwanese multinational hardware and electronics corporation. logo: https://i.imgur.com/bazrFjP.png keyPeople: - CarolynYeh - GeorgeHuang - StanShih industries: - Computer - Consumer Electronics - Hardware city: Taipei country: TWN region: Eastern Asia website: http://www.acer.com socialMedia: - https://www.facebook.com/Acer - https://www.linkedin.com/company/acer - https://twitter.com/acer competitors: - Apple - HP - ASUS foundingDate: 189302400000 brandIgIds: - acer ytChannels: 135 ytVideos: 347 ytVideos30Days: 28 ytAllViews1Year: 14425961 ytAllViews30Days: 28 ytCountries: - country: TWN count: 24 - country: VNM count: 14 - country: IDN count: 12 ytLanguages: - lang: eng count: 48 - lang: zht count: 26 - lang: tha count: 13 ytMainCountry: TWN ytMainCountryRatio: 0.19047619047619047 ytMainLanguage: eng ytMainLanguageRatio: 0.35555555555555557 ytVideosViews: 19300283 ytVideosLikes: 400701 ytVideosComments: 32434 ytVideosAvgViews: 55620 ytVideosAvgLikes: 1155 ytVideosAvgComments: 93 ytVideosAvgEngagement: 0.03172689181876585 ytVideosViewsGrowth: 0.09911916287300525 ytVideosLikesGrowth: 0.08187333446731304 ytVideosCommentsGrowth: 0.08384294068504594 ytVideosAvgViewsGrowth: -0.018077819363039333 ytVideosAvgLikesGrowth: -0.03347280334728033 ytVideosAvgCommentsGrowth: -0.041237113402061855 ytVideosAvgEngagementGrowth: -0.04952072861651131 igAccounts: 0 igAccountAvgFollowers: 0 igAccountAvgFollowing: 0 igAccountAvgPosts: 0 igPosts: 0 igPosts30Days: 0 igPostAvgLikes: 0 igPostAvgComments: 0 igPostAvgEngagement: 0 igPostAvgPlays: 0 igPostsGrowth: 0 igPostAvgLikesGrowth: 0 igPostAvgCommentsGrowth: 0 igPostAvgEngagementGrowth: 0 igPostAvgPlaysGrowth: 0 igCountries: [] igLanguages: [] quotaUsed: 50 quotaUsedTotal: 6074 remainingPlanCredit: 993926 remainingPrepurchasedCredit: 0 timestamp: 1755503514724 error: '' success: true '403': description: Forbidden content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/DetailBrandReportV2' quotaUsed: type: number description: API credits that were used to make this call. quotaUsedTotal: type: number description: Total API credits used since the last billing cycle. remainingPlanCredit: type: number description: >- The number of remaining free API credits that come with your subscription plan. These API credits are renewed every billing cycle. remainingPrepurchasedCredit: type: number description: >- The number of remaining extra purchased API credits. These API credits do not expire until used. timestamp: type: number description: >- Unix timestamp of the call request that the server received. error: type: string description: Errors that occurred during the API call. success: type: boolean description: It is TRUE when the call is successful. examples: default: value: data: null quotaUsed: 0 quotaUsedTotal: 0 remainingPlanCredit: 0 remainingPrepurchasedCredit: 0 timestamp: 1755503513984 error: APIKeyOnlyForTesting success: false servers: - url: https://dev.creatordb.app/v2 description: CreatorDB API Endpoint - prod version x-codeSamples: - lang: bash label: cURL source: | curl --request GET \ --url 'https://dev.creatordb.app/v2/brandReportV2?brandId=acer.com' \ --header 'Accept: application/json' \ --header 'apiId: LE6DPZQkR3TQShxofXoD2j8qCBu1-f0jti665m1t50dwDD12W' components: schemas: DetailBrandReportV2: type: object description: The response data from calling the getBrandReportV2 endpoint. additionalProperties: false properties: ytDgMainCountry: type: string description: The country where the largest share of viewers is located ytDgMainCountryRatio: type: number description: The ratio of viewers in the country with the largest share ytDgCountryBreakdown: type: array description: Country breakdown of viewers items: type: object additionalProperties: false properties: country: type: string description: Countries where viewers are located. value: type: number description: The number of viewers from the country. required: - country - value ytDgGenderMaleRatio: type: number description: The ratio of male viewers ytDgGenderFemaleRatio: type: number description: The ratio of female viewers ytDgAvgAge: type: number description: The average viewer age ytDgAgeBreakdown: type: array description: >- The number of viewers in each age group: [13–17], [18–24], [25–34], [35–44], [45–54], [55–64], [65+] items: type: number brandId: type: string description: URL of the brand. domain: type: array description: URL or domain used to identify brands. items: type: string companySize: type: string description: The company size of the brand. medianCompanySize: type: number description: The median size of all companies in CreatorDB's database. brandName: type: string description: type: string description: A one-sentence description of the brand. logo: type: string description: URL of the brand logo. keyPeople: type: array description: >- Main representatives of the company. Typically, top executives, founders, or investors. items: type: string industries: type: array description: Different industries in which the brand operates. items: type: string city: type: string description: The city where the brand's headquarters is based. country: type: string description: The country where the brand's headquarters is based. region: type: string description: The region of the sponsoring brand or company's headquarters. website: type: string description: URL of the brand's homepage. socialMedia: type: array description: URLs to the brand's social media sites. items: type: string competitors: type: array description: ID of competing brands or products in the market. items: type: string foundingDate: type: number description: Unix timestamp of the company's founding date. brandIgIds: type: array description: The brand's Instagram IDs. items: type: string ytChannels: type: number description: The number of unique YouTube creators sponsored by this brand. ytVideos: type: number description: The total number of YouTube videos sponsored by this brand. ytVideos30Days: type: number description: >- The total number of YouTube videos sponsored by this brand in the last 30 days. ytAllViews1Year: type: number description: >- The total views of all sponsored YouTube videos by this brand within one year. ytAllViews30Days: type: number description: >- The total views of all sponsored YouTube videos by this brand in the last 30 days. ytCountries: type: array description: Where YouTube creators sponsored by this brand are from. items: type: object additionalProperties: false properties: country: type: string description: >- The countries of origin of the YouTube creators sponsored by this brand. count: type: number description: >- The number of YouTube creators sponsored by this brand, grouped by their country of origin. required: - country - count ytLanguages: type: array description: >- The language indicators of the YouTube creators sponsored by this brand. items: type: object additionalProperties: false properties: lang: type: string description: >- The languages that the YouTube creators sponsored by this brand use. count: type: number description: >- The number of YouTube creators sponsored by this brand, grouped by their language. required: - lang - count ytMainCountry: type: string description: >- The top country where most of the YouTube creators sponsored by this brand are from. ytMainCountryRatio: type: number description: >- The ratio of sponsored YouTube creators from the top country compared to all other countries. ytMainLanguage: type: string description: The main language used by YouTube creators sponsored by this brand. ytMainLanguageRatio: type: number description: >- The ratio of sponsored YouTube creators using the main language compared to all other languages. ytVideosViews: type: number description: The total views of YouTube videos sponsored by this brand. ytVideosLikes: type: number description: The total likes of YouTube videos sponsored by this brand. ytVideosComments: type: number description: The total comments on YouTube videos sponsored by this brand. ytVideosAvgViews: type: number description: The average views per YouTube video sponsored by this brand. ytVideosAvgLikes: type: number description: The average likes per YouTube video sponsored by this brand. ytVideosAvgComments: type: number description: The average comments per YouTube video sponsored by this brand. ytVideosAvgEngagement: type: number description: >- The average engagement rate per YouTube video sponsored by this brand. ytVideosViewsGrowth: type: number description: >- The 30-day growth rate of total views of YouTube videos sponsored by this brand. ytVideosLikesGrowth: type: number description: >- The 30-day growth rate of total likes per YouTube video sponsored by this brand. ytVideosCommentsGrowth: type: number description: >- The 30-day growth rate of total comments per YouTube video sponsored by this brand. ytVideosAvgViewsGrowth: type: number description: >- The 30-day growth rate of average views per YouTube video sponsored by this brand. ytVideosAvgLikesGrowth: type: number description: >- The 30-day growth rate of the average likes per YouTube video sponsored by this brand. ytVideosAvgCommentsGrowth: type: number description: >- The 30-day growth rate in the average comments per YouTube video sponsored by this brand. ytVideosAvgEngagementGrowth: type: number description: >- The 30-day growth rate in the average engagement rate per YouTube video sponsored by this brand. igAccounts: type: number description: The number of Instagram creators sponsored by this brand. igAccountAvgFollowers: type: number description: >- The average number of followers the Instagram creators sponsored by this brand have. igAccountAvgFollowing: type: number description: >- The average number of accounts the Instagram creators sponsored by this brand follow. igAccountAvgPosts: type: number description: >- The average number of posts the Instagram creators sponsored by this brand have. igPosts: type: number description: The total number of Instagram posts sponsored by this brand. igPosts30Days: type: number description: >- The total number of sponsored Instagram posts sponsored from this brand published in the past 30 days. igPostAvgLikes: type: number description: The average likes per Instagram post sponsored by this brand. igPostAvgComments: type: number description: The average comments per Instagram post sponsored by this brand. igPostAvgEngagement: type: number description: >- The average engagement rate of the Instagram posts sponsored by this brand. igPostAvgPlays: type: number description: The average plays per Instagram post sponsored by this brand. igPostsGrowth: type: number description: >- The 30-day growth rate in the total number of Instagram posts sponsored by this brand. igPostAvgLikesGrowth: type: number description: >- The 30-day growth rate in the average likes of Instagram posts sponsored by this brand. igPostAvgCommentsGrowth: type: number description: >- The 30-day growth rate in the average comments of the Instagram posts sponsored by this brand. igPostAvgEngagementGrowth: type: number description: >- The 30-day growth rate in the average engagement rate of the Instagram posts sponsored by this brand. igPostAvgPlaysGrowth: type: number description: >- The 30-day growth rate in the average plays of Instagram posts sponsored by this brand. igCountries: type: array description: Where Instagram creators sponsored by this brand are from. items: type: object additionalProperties: false properties: country: type: string description: >- The countries of origin of the Instagram creators sponsored by this brand. count: type: number description: >- The number of Instagram creators sponsored by this brand, grouped by their country of origin. required: - country - count igLanguages: type: array description: >- The language indicators of Instagram creators sponsored by this brand. items: type: object additionalProperties: false properties: lang: type: string description: >- The languages that the Instagram creators sponsored by this brand use. count: type: number description: >- The number of Instagram creators sponsored by this brand, grouped by their language. required: - lang - count required: - ytDgMainCountry - ytDgMainCountryRatio - ytDgCountryBreakdown - ytDgGenderMaleRatio - ytDgGenderFemaleRatio - ytDgAvgAge - ytDgAgeBreakdown - brandId - domain - companySize - medianCompanySize - brandName - description - logo - keyPeople - industries - city - country - region - website - socialMedia - competitors - foundingDate - brandIgIds - ytChannels - ytVideos - ytVideos30Days - ytAllViews1Year - ytAllViews30Days - ytCountries - ytLanguages - ytMainCountry - ytMainCountryRatio - ytMainLanguage - ytMainLanguageRatio - ytVideosViews - ytVideosLikes - ytVideosComments - ytVideosAvgViews - ytVideosAvgLikes - ytVideosAvgComments - ytVideosAvgEngagement - ytVideosViewsGrowth - ytVideosLikesGrowth - ytVideosCommentsGrowth - ytVideosAvgViewsGrowth - ytVideosAvgLikesGrowth - ytVideosAvgCommentsGrowth - ytVideosAvgEngagementGrowth - igAccounts - igAccountAvgFollowers - igAccountAvgFollowing - igAccountAvgPosts - igPosts - igPosts30Days - igPostAvgLikes - igPostAvgComments - igPostAvgEngagement - igPostAvgPlays - igPostsGrowth - igPostAvgLikesGrowth - igPostAvgCommentsGrowth - igPostAvgEngagementGrowth - igPostAvgPlaysGrowth - igCountries - igLanguages ````