githunt-ai Profile API

openapi: 3.2.0
info:
  title: GitHunt Profile API
  version: 1.0.0
  description: 'Search, look up, and analyze GitHub developers programmatically. GitHunt gives you millisecond access to millions of developers available on GitHub - ranked, scored, and with contact details where publicly available. Every request is billed against your plan''s monthly API call quota; all plans are additionally capped at 2000 calls/day.

    Quotas: Free 50 calls/month (trial), Pro 1000 calls/month, Team 1500 calls/month (unused credits roll over, up to one extra month''s allowance), Enterprise unlimited. Endpoints cost different amounts of quota: search 1 credit, get user 1 credit, evidence report 3 credits (0 when the report is still pending), analyze profile 3 credits, and every /v1/lists operation 0 credits. Endpoints that debit 0 credits still count against the daily cap.'
  contact:
    email: support@githunt.ai
servers:
- url: https://api.githunt.ai
security:
- bearerAuth: []
- apiKeyAuth: []
tags:
- name: Profile
paths:
  /v1/profile/analyze:
    post:
      operationId: analyzeProfile
      summary: Run a deep profile analysis for a single GitHub username
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - username
              properties:
                username:
                  type: string
                  description: GitHub username to analyze
      responses:
        '200':
          description: Profile analysis
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProfileAnalyzeResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/QuotaExceeded'
        '500':
          $ref: '#/components/responses/InternalError'
      tags:
      - Profile
components:
  responses:
    InternalError:
      description: Unexpected server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: Missing, invalid, or revoked API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFound:
      description: No matching developer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    QuotaExceeded:
      description: Monthly or daily quota exceeded
      headers:
        Retry-After:
          schema:
            type: integer
          description: Seconds until the quota resets
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    BadRequest:
      description: Invalid request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  schemas:
    ErrorResponse:
      type: object
      required:
      - success
      - error
      properties:
        success:
          type: boolean
          const: false
        error:
          type: object
          required:
          - code
          - message
          properties:
            code:
              type: string
              enum:
              - unauthorized
              - quota_exceeded
              - invalid_request
              - not_found
              - internal
            message:
              type: string
    ProfileAnalyzeResponse:
      type: object
      properties:
        success:
          type: boolean
          const: true
        data:
          type: object
          description: 'Deep analysis payload. Top-level keys: profile (basic profile facts), emails ({emails: [{address, sources, commitCount, isPrimary}]}), commitQuality, repositories, activity, roleMatch (ranked array of role fits with score breakdowns), proficiency ({level, score, experienceYears}), scores (best-role score with detailed breakdown), badges, summary. Sub-shapes may gain fields over time (additive only).

            '
          additionalProperties: true
          properties:
            proficiency:
              type: object
              properties:
                level:
                  type: string
                  example: Senior
                score:
                  type: number
                experienceYears:
                  type: number
            emails:
              type: object
              properties:
                emails:
                  type: array
                  items:
                    type: object
                    properties:
                      address:
                        type: string
                      sources:
                        type: array
                        items:
                          type: string
                      isPrimary:
                        type: boolean
            roleMatch:
              type: array
              items:
                type: object
                properties:
                  role:
                    type: string
                  displayName:
                    type: string
                  score:
                    type: number
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Authorization: Bearer ghk_live_...'
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key