aid: genius
name: Genius
description: >-
  Crowdsourced music knowledge — the Genius/Rap Genius platform. The Genius API
  exposes structured metadata for songs, artists, albums, annotations,
  referents, and contributors. Raw lyric text is not served by the API;
  consumers receive the public song page URL and scrape lyrics from there.
url: https://docs.genius.com/
image: https://assets.genius.com/images/apple-touch-icon.png
specificationVersion: '0.20'
created: '2026-05-28'
modified: '2026-05-29'
x-source: public-apis/public-apis
x-category: Music
x-type: company
x-tier: 2
x-tier-reason: enriched-with-openapi-capabilities-and-schemas

tags:
  - Music
  - Lyrics
  - Annotations
  - Crowdsourced
  - Reference Data
  - Public APIs

apis:
  - name: Genius
    description: >-
      Crowdsourced music knowledge — songs, artists, albums, annotations,
      referents, and contributor data.
    humanURL: https://docs.genius.com/
    baseURL: https://api.genius.com
    tags:
      - Music
      - Lyrics
      - Annotations
    properties:
      - type: Documentation
        url: https://docs.genius.com/
      - type: SignUp
        url: https://genius.com/api-clients
      - type: Authentication
        url: https://docs.genius.com/#/authentication-h1
      - type: TermsOfService
        url: https://genius.com/static/terms
      - type: OpenAPI
        url: openapi/genius-openapi.yml
      - type: JSONSchema
        title: Song
        url: json-schema/genius-song-schema.json
      - type: JSONSchema
        title: Artist
        url: json-schema/genius-artist-schema.json
      - type: JSONSchema
        title: Album
        url: json-schema/genius-album-schema.json
      - type: JSONSchema
        title: Annotation
        url: json-schema/genius-annotation-schema.json
      - type: JSONSchema
        title: Referent
        url: json-schema/genius-referent-schema.json
      - type: JSONSchema
        title: User
        url: json-schema/genius-user-schema.json
      - type: JSONSchema
        title: WebPage
        url: json-schema/genius-web-page-schema.json
      - type: JSONStructure
        title: Song
        url: json-structure/genius-song-structure.json
      - type: JSONStructure
        title: Annotation
        url: json-structure/genius-annotation-structure.json
      - type: Example
        title: Search
        url: examples/genius-search-example.json
      - type: Example
        title: Get Song
        url: examples/genius-get-song-example.json
      - type: Example
        title: Get Artist
        url: examples/genius-get-artist-example.json
      - type: Example
        title: List Artist Songs
        url: examples/genius-list-artist-songs-example.json
      - type: Example
        title: Get Referents
        url: examples/genius-get-referents-example.json
      - type: Example
        title: Get Annotation
        url: examples/genius-get-annotation-example.json
      - type: Example
        title: Lookup Web Page
        url: examples/genius-lookup-web-page-example.json
      - type: NaftikoCapability
        title: Account
        url: capabilities/genius-account.yaml
      - type: NaftikoCapability
        title: Search
        url: capabilities/genius-search.yaml
      - type: NaftikoCapability
        title: Songs
        url: capabilities/genius-songs.yaml
      - type: NaftikoCapability
        title: Artists
        url: capabilities/genius-artists.yaml
      - type: NaftikoCapability
        title: Albums
        url: capabilities/genius-albums.yaml
      - type: NaftikoCapability
        title: Annotations
        url: capabilities/genius-annotations.yaml
      - type: NaftikoCapability
        title: Referents
        url: capabilities/genius-referents.yaml
      - type: NaftikoCapability
        title: WebPages
        url: capabilities/genius-web-pages.yaml
      - type: NaftikoCapability
        title: Users
        url: capabilities/genius-users.yaml
      - type: Plans
        url: plans/genius-plans-pricing.yml
      - type: RateLimits
        url: rate-limits/genius-rate-limits.yml

      # ── Community SDKs (Genius does not maintain official SDKs) ──
      - type: SDK
        title: Python SDK (lyricsgenius)
        url: https://github.com/johnwmillr/LyricsGenius
      - type: SDK
        title: Python SDK (wrap-genius)
        url: https://github.com/fedecalendino/wrap-genius
      - type: SDK
        title: Node.js SDK (genius-api)
        url: https://github.com/jahrlin/genius-api
      - type: SDK
        title: Node.js SDK (node-genius)
        url: https://github.com/bookercodes/node-genius
      - type: SDK
        title: Ruby SDK (timrogers/genius)
        url: https://github.com/timrogers/genius
      - type: SDK
        title: PHP SDK (Genius-PHP)
        url: https://github.com/simivar/Genius-PHP
      - type: SDK
        title: R SDK (geniusr)
        url: https://cran.r-project.org/web/packages/geniusr/

common:
  - type: Website
    url: https://genius.com/
  - type: DeveloperPortal
    url: https://docs.genius.com/
  - type: APIClientRegistration
    url: https://genius.com/api-clients
  - type: TermsOfService
    url: https://genius.com/static/terms
  - type: GitHubOrganization
    url: https://github.com/Genius
  - type: SpectralRuleset
    url: rules/genius-rules.yml
  - type: JSONLDContext
    url: json-ld/genius-context.jsonld
  - type: Vocabulary
    url: vocabulary/genius-vocabulary.yml
  - type: PublicAPIsListing
    url: https://github.com/public-apis/public-apis

  # ── MCP servers (community — Genius does not publish a first-party server) ──
  - type: Tools
    title: MCP Server (jchoi2x/genius-mcp)
    url: https://github.com/jchoi2x/genius-mcp
  - type: Tools
    title: MCP Server (federicogarciav/genius-mcp)
    url: https://github.com/federicogarciav/genius-mcp
  - type: Tools
    title: MCP Server (Sergiolm17/genius-mcp-server)
    url: https://mcp.so/server/genius-mcp-server/Sergiolm17

  # ── OAuth-related Genius org artifacts ──
  - type: Tools
    title: omniauth-genius (OAuth strategy)
    url: https://github.com/Genius/omniauth-genius

maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com