Instagram Music Search (by Keyword)

{
  "type": "object",
  "required": [
    "keyword"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "examples": [
        "happy"
      ],
      "description": "Search keyword"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "count": {
          "type": "number",
          "description": "Number of tracks returned. Observed as 10 on both real fixtures."
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "The track's numeric Instagram id, as a string."
              },
              "title": {
                "type": "string"
              },
              "audio_id": {
                "type": "string",
                "description": "A second numeric Instagram audio identifier, as a string, distinct from `id` on every track observed."
              },
              "subtitle": {
                "type": "string",
                "description": "A short qualifier (e.g. 'Instrumental'). Empty string on most tracks observed."
              },
              "has_lyrics": {
                "type": "boolean"
              },
              "is_explicit": {
                "type": "boolean"
              },
              "dark_message": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Observed as `null` on every track in both real fixtures -- a populated shape was never observed and is unconfirmed."
              },
              "allows_saving": {
                "type": "boolean"
              },
              "display_artist": {
                "type": "string",
                "description": "The track's public artist credit."
              },
              "duration_in_ms": {
                "type": "number"
              },
              "cover_artwork_uri": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The track's full-size cover artwork. Value withheld (stripped to `null`) in this tool's output, same treatment as `cover_artwork_thumbnail_uri`."
              },
              "licensed_music_subtype": {
                "type": "string",
                "description": "Observed only as 'DEFAULT' on every track in both real fixtures."
              },
              "progressive_download_url": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "A downloadable preview clip location. Value withheld (stripped to `null`) in this tool's output, same treatment as `fast_start_progressive_download_url`."
              },
              "cover_artwork_thumbnail_uri": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The track's cover artwork thumbnail. Value withheld (stripped to `null`) in this tool's output -- only whether cover art exists is observable."
              },
              "highlight_start_times_in_ms": {
                "type": "array",
                "items": {
                  "type": "number"
                },
                "description": "Millisecond offsets into the track marking suggested highlight/preview start points. 3 entries on every track observed."
              },
              "is_eligible_for_audio_effects": {
                "type": "boolean"
              },
              "is_eligible_for_vinyl_sticker": {
                "type": "boolean"
              },
              "fast_start_progressive_download_url": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "A streamable preview clip location. Value withheld (stripped to `null`) in this tool's output -- this tool surfaces track metadata, not playable media."
              }
            },
            "additionalProperties": true
          }
        }
      },
      "additionalProperties": true
    }
  },
  "description": "The music search result, as returned at routing.responseResultPath. Both real fixtures returned 10 tracks and a positive count; a genuinely empty/no-match result was never observed for this endpoint (see verification.notes).",
  "additionalProperties": true
}