> ## Documentation Index > Fetch the complete documentation index at: https://developer.mogl.online/llms.txt > Use this file to discover all available pages before exploring further. # Get social media audience data > Retrieve aggregated social media metrics (impressions, engagements, age/gender/location demographics). Accepts the same filter set as searchAthleteV2 to scope the audience data. ## OpenAPI ````yaml /storage/api-docs/api-docs.json post /socialMediaAudienceData openapi: 3.0.0 info: title: MOGL Core API description: >- MOGL Platform Core API — powering athlete NIL deals, brand partnerships, agent management, payments, messaging, and more. * * ## Authentication * - **JWT Bearer Token**: Most endpoints require a Bearer token obtained via `/api/login`. * - **Server-to-Server API Key**: Internal/lambda/cron endpoints use an `X-API-KEY` header. * * ## Rate Limiting * - Registration & login endpoints: 4–15 requests per minute * - Public/influencer endpoints: 200 requests per minute * - Authenticated endpoints: standard Laravel throttle version: 1.0.0 servers: - url: http://localhost/mogl/mogl-backend/api description: Local - url: https://dev-api.mogl.online/api description: Dev - url: https://staging-api.mogl.online/api description: Staging - url: https://api.mogl.online/api description: Production security: - bearerAuth: [] tags: - name: Authentication description: Login, registration, password reset - name: User Registration - Common description: Common user registration & email check - name: User Registration - Athlete description: Athlete registration & onboarding steps - name: User Registration - Partner description: Partner/Brand registration & onboarding steps - name: User Registration - Agent description: Agent registration & onboarding steps - name: User Registration - Fan description: Fan registration & onboarding steps - name: User Profile description: User profile management, settings, social media - name: Athlete description: 'Athlete-specific endpoints: search, details, availability' - name: Athlete - Availability Confirmation description: Post-hiring availability confirmation workflow - name: Athlete - NIL Feed description: Athlete NIL feed and partner search - name: Athlete - AI Assistant description: AI-powered job assistant for athletes — chat and conversation history - name: Partner description: Partner/Brand-specific endpoints - name: Partner - External Job description: External job link & applicant management - name: Partner - Deliverable Report description: Deliverable detail reports for brands - name: Partner - Screening Questions description: Screening question reports - name: Partner - Contract Management description: Brand contract management with athletes - name: Partner - Content Library description: Brand content library for deliverable assets - name: Agent description: Agent profile, athlete management, contracts - name: Agent - Athletes description: Agent-athlete relationship management - name: Agent - Stripe description: Agent payment methods & billing via Stripe - name: Agent - Contracts description: Agent athlete contract management - name: Agent - Availability Confirmation description: Agent managing athlete job availability - name: Jobs description: Job/deal CRUD, search, invitations, hiring, deliverables - name: Deals description: Deal listing, my deals, bulk operations - name: Deal Folder description: >- Deal folder file workflow — uploads, replacements, approvals, revisions, comments. Accessible by athlete, partner/brand, agent, and iOS clients (per-action authorisation enforced server-side). - name: Deal Folder iOS API description: >- iOS-only direct-to-S3 multipart upload endpoints for deal folder files (initiate/complete for new uploads and replacements). Web clients should use the standard `Deal Folder` upload/replace endpoints instead. - name: Chat description: Messaging, chat contacts, notifications - name: Notifications description: Notification preferences, in-app notifications - name: Payments description: Stripe payments, payment history, cards, bulk pay - name: Subscription description: Brand subscription plans & management - name: Public Pages description: Public content endpoints (no auth required) - name: Public - Influencer/SEO description: Public influencer discovery, sitemaps, directories - name: Services description: Athlete service marketplace - name: iOS Device description: iOS device tokens, live activities - name: Onboarding Tutorial description: Onboarding tutorial progress - name: MOGL Rosters description: Roster management & display - name: Internal / Cron description: Server-to-server and cron job endpoints - name: Affiliate description: Athlete affiliate links & tracking paths: /socialMediaAudienceData: post: tags: - Athlete summary: Get social media audience data description: >- Retrieve aggregated social media metrics (impressions, engagements, age/gender/location demographics). Accepts the same filter set as searchAthleteV2 to scope the audience data. operationId: socialMediaAudienceData requestBody: required: true content: application/json: schema: properties: sortBy: description: Sort field type: string example: name nullable: true filterByMultiParameter: description: General search keyword type: string nullable: true filterByAthleteName: description: Filter by athlete name(s) type: array items: type: string nullable: true filterByAthleteID: description: Athlete ID(s) to get audience data for type: string nullable: true filterByName: description: Filter by name type: string nullable: true filterBySchool: description: Filter by school/university ID(s) type: array items: type: integer nullable: true filterByLocation: description: Filter by location keyword type: string nullable: true filterByPrice: description: Filter by price type: string nullable: true filterByPlatform: description: Platform filter flag type: boolean example: false nullable: true genderSelect: description: Gender filter enabled type: boolean example: false nullable: true eligibilitySelect: description: Eligibility filter enabled type: boolean example: false nullable: true gender: description: Filter by gender(s) type: array items: type: string nullable: true is_current_athlete: description: Y = current, N = former, empty = all type: string enum: - 'Y' - 'N' - '' example: 'Y' nullable: true filterByTeam: description: Filter by team type: string nullable: true filterskillsSearchKeywords: description: Filter by skills type: array items: type: string nullable: true filterBusinessCategorySearchKeywords: description: Filter by business category IDs type: array items: type: integer nullable: true filterSportsSearchKeywords: description: Filter by sport category IDs type: array items: type: integer nullable: true filterPlatFormSearchKeywords: description: Filter by social platforms type: array items: type: string enum: - facebook - instagram - twitter - google - youtube - tiktok nullable: true filterByInstaMin: description: Min Instagram followers type: string nullable: true filterByInstaMax: description: Max Instagram followers type: string nullable: true filterByTwitterMin: description: Min Twitter followers type: string nullable: true filterByTwitterMax: description: Max Twitter followers type: string nullable: true filterByTiktokMin: description: Min TikTok followers type: string nullable: true filterByTiktokMax: description: Max TikTok followers type: string nullable: true sortOrderInsta: description: Sort by Instagram followers type: string enum: - asc - desc nullable: true sortOrderTwitter: description: Sort by Twitter followers type: string enum: - asc - desc nullable: true sortOrderTiktok: description: Sort by TikTok followers type: string enum: - asc - desc nullable: true sortOrderDistance: description: Sort by distance type: string enum: - asc - desc nullable: true filterByRating: description: Min star rating type: number nullable: true filterByLatLong: description: '[longitude, latitude]' type: array items: type: number example: [] nullable: true filterByDistanceInMiles: description: Max distance in miles type: number nullable: true filterByDivisions: description: Filter by divisions type: array items: type: string nullable: true filterByConference: description: Filter by conference names type: array items: type: string nullable: true filterBySelectedLocation: description: Selected location label type: string nullable: true type: object responses: '200': description: >- Social media audience data (impressions, engagements, age/gender/location demographics) security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http description: >- JWT Bearer token authentication. Use the /api/login endpoint to obtain a token. scheme: bearer bearerFormat: JWT ````