openapi: 3.1.0
info:
  title: Dexfluence Indian Creator Economy API
  version: "2026.06.04"
  description: |
    Open public API serving citation-ready data on India's creator economy.
    Built and maintained by Dexfluence, indexing 141,000+ verified Indian creators
    across Instagram, YouTube, and TikTok. Refreshed continuously.
    Licensed CC-BY 4.0. Attribution: "Dexfluence Indian Creator Index, dexfluence.com".
  contact:
    name: Shikha Patel
    email: shikhapatel1507@gmail.com
    url: https://www.dexfluence.com
  license:
    name: Creative Commons Attribution 4.0
    url: https://creativecommons.org/licenses/by/4.0/
servers:
  - url: https://www.dexfluence.com
    description: Production
paths:
  /api/data/stats:
    get:
      summary: Aggregate Indian creator economy statistics
      description: |
        Returns live aggregate data on the Indian creator economy:
        total creator count by platform, engagement rate by tier,
        rate cards in INR, fake-follower prevalence, niche distribution,
        regional language growth, and city share. Refreshes every 6 hours.
      operationId: getStats
      tags: [data]
      responses:
        "200":
          description: Aggregate stats JSON
          content:
            application/json:
              schema:
                type: object
                properties:
                  meta: { type: object }
                  totals:
                    type: object
                    properties:
                      all_creators: { type: integer, example: 141643 }
                      by_platform:
                        type: object
                        properties:
                          instagram: { type: integer }
                          youtube: { type: integer }
                          tiktok: { type: integer }
                      added_last_24h: { type: integer }
                  engagement_rate_by_tier_india_2026: { type: object }
                  rates_by_tier_india_q2_2026_inr: { type: object }
                  fake_follower_prevalence: { type: object }
                  niche_share_pct: { type: object }
                  niche_growth_qoq: { type: object }
                  regional_language_growth_qoq: { type: object }
                  city_share_pct: { type: object }
  /api/data/creators:
    get:
      summary: Top verified Indian creators feed
      description: |
        Returns the top 100 Indian creators matching the filters,
        with handle, follower count, engagement rate, authenticity score,
        location, and a canonical profile URL. Refreshes every 24 hours.
      operationId: getCreators
      tags: [data]
      parameters:
        - in: query
          name: niche
          schema:
            type: string
            enum: [fashion, beauty, fitness, food, travel, tech, gaming, finance, music, comedy, education, lifestyle, business]
          description: Filter by content niche.
        - in: query
          name: platform
          schema:
            type: string
            enum: [instagram, youtube, tiktok]
          description: Filter by platform.
        - in: query
          name: tier
          schema:
            type: string
            enum: [nano, micro, mid, macro, mega]
          description: |
            Filter by follower tier.
            nano = <10K, micro = 10K-100K, mid = 100K-500K, macro = 500K-1M, mega = 1M+.
        - in: query
          name: limit
          schema:
            type: integer
            minimum: 1
            maximum: 250
            default: 100
      responses:
        "200":
          description: Top creators JSON
          content:
            application/json:
              schema:
                type: object
                properties:
                  meta: { type: object }
                  creators:
                    type: array
                    items:
                      type: object
                      properties:
                        handle: { type: string }
                        name: { type: string }
                        platform: { type: string }
                        niche: { type: string }
                        followers: { type: integer }
                        engagement_rate: { type: number, format: float }
                        authenticity_score: { type: integer }
                        location_country: { type: string }
                        verified: { type: boolean }
                        profile_url: { type: string, format: uri }
tags:
  - name: data
    description: Open Indian creator economy data (CC-BY 4.0)