Package com.wrapper.spotify.requests.data.browse

Class GetRecommendationsRequest.Builder

    • Constructor Detail

      • Builder

        public Builder​(String accessToken)
        Create a new GetRecommendationsRequest.Builder instance.
        Parameters:
        accessToken - Required. A valid access token from the Spotify Accounts service.

    • Method Detail

      • limit

        public GetRecommendationsRequest.Builder limit​(Integer limit)
        The limit setter.
        Parameters:
        limit - Optional. The target size of the list of recommended tracks. For seeds with unusually small pools or when highly restrictive filtering is applied, it may be impossible to generate the requested number of recommended tracks. Debugging information for such cases is available in the response. Default: 20. Minimum: 1. Maximum: 100.
        Returns:
        A GetRecommendationsRequest.Builder.

      • market

        public GetRecommendationsRequest.Builder market​(com.neovisionaries.i18n.CountryCode market)
        The country code setter.
        Parameters:
        market - Optional. An ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking. Because min_*, max_* and target_* are applied to pools before relinking, the generated results may not precisely match the filters applied. Original, non-relinked tracks are available via the linked_from attribute of the relinked track response.
        Returns:
        A GetRecommendationsRequest.Builder.
        See Also:
        Wikipedia: ISO 3166-1 alpha-2 country codes

      • max_acousticness

        public GetRecommendationsRequest.Builder max_acousticness​(Float max_acousticness)
        The maximum acousticness setter. Tracks with the attribute value above the maximum value will be omitted.
        Parameters:
        max_acousticness - A confidence measure from 0.0 to 1.0 of whether the track is acoustic. 1.0 represents high confidence the track is acoustic.
        Returns:
        A GetRecommendationsRequest.Builder.

      • max_danceability

        public GetRecommendationsRequest.Builder max_danceability​(Float max_danceability)
        The maximum danceability setter. Tracks with the attribute value above the maximum value will be omitted.
        Parameters:
        max_danceability - Danceability describes how suitable a track is for dancing based on a combination of musical elements including tempo, rhythm stability, beat strength, and overall regularity. A value of 0.0 is least danceable and 1.0 is most danceable.
        Returns:
        A GetRecommendationsRequest.Builder.

      • max_energy

        public GetRecommendationsRequest.Builder max_energy​(Float max_energy)
        The maximum energy setter. Tracks with the attribute value above the maximum value will be omitted.
        Parameters:
        max_energy - Energy is a measure from 0.0 to 1.0 and represents a perceptual measure of intensity and activity. Typically, energetic seed_tracks feel fast, loud, and noisy. For example, death metal has high energy, while a Bach prelude scores low on the scale. Perceptual features contributing to this attribute include dynamic range, perceived loudness, timbre, onset rate, and general entropy.
        Returns:
        A GetRecommendationsRequest.Builder.

      • max_instrumentalness

        public GetRecommendationsRequest.Builder max_instrumentalness​(Float max_instrumentalness)
        The maximum instrumentalness setter. Tracks with the attribute value above the maximum value will be omitted.
        Parameters:
        max_instrumentalness - Predicts whether a track contains no vocals. "Ooh" and "aah" sounds are treated as instrumental in this context. Rap or spoken word seed_tracks are clearly "vocal". The closer the instrumentalness value is to 1.0, the greater likelihood the track contains no vocal content. Values above 0.5 are intended to represent instrumental seed_tracks, but confidence is higher as the value approaches 1.0.
        Returns:
        A GetRecommendationsRequest.Builder.

      • max_liveness

        public GetRecommendationsRequest.Builder max_liveness​(Float max_liveness)
        The maximum liveness setter. Tracks with the attribute value above the maximum value will be omitted.
        Parameters:
        max_liveness - Detects the presence of an audience in the recording. Higher liveness values represent an increased probability that the track was performed live. A value above 0.8 provides strong likelihood that the track is live.
        Returns:
        A GetRecommendationsRequest.Builder.

      • max_loudness

        public GetRecommendationsRequest.Builder max_loudness​(Float max_loudness)
        The maximum loudness setter. Tracks with the attribute value above the maximum value will be omitted.
        Parameters:
        max_loudness - The overall loudness of a track in decibels (dB). Loudness values are averaged across the entire track and are useful for comparing relative loudness of seed_tracks. Loudness is the quality of a sound that is the primary psychological correlate of physical strength (amplitude). Values typical range between -60 and 0 db.
        Returns:
        A GetRecommendationsRequest.Builder.

      • max_mode

        public GetRecommendationsRequest.Builder max_mode​(Integer max_mode)
        The maximum mode setter. Tracks with the attribute value above the maximum value will be omitted.
        Parameters:
        max_mode - Mode indicates the modality (major or minor) of a track, the type of scale from which its melodic content is derived. Major is represented by 1 and minor is 0.
        Returns:
        A GetRecommendationsRequest.Builder.

      • max_popularity

        public GetRecommendationsRequest.Builder max_popularity​(Integer max_popularity)
        The maximum popularity setter. Tracks with the attribute value above the maximum value will be omitted.
        Parameters:
        max_popularity - The popularity of the track. The value will be between 0 and 100, with 100 being the most popular. The popularity is calculated by algorithm and is based, in the most part, on the total number of plays the track has had and how recent those plays are.
        Returns:
        A GetRecommendationsRequest.Builder.

      • max_speechiness

        public GetRecommendationsRequest.Builder max_speechiness​(Float max_speechiness)
        The maximum speechiness setter. Tracks with the attribute value above the maximum value will be omitted.
        Parameters:
        max_speechiness - Speechiness detects the presence of spoken words in a track. The more exclusively speech-like the recording (e.g. talk show, audio book, poetry), the closer to 1.0 the attribute value. Values above 0.66 describe seed_tracks that are probably made entirely of spoken words. Values between 0.33 and 0.66 describe seed_tracks that may contain both music and speech, either in sections or layered, including such cases as rap music. Values below 0.33 most likely represent music and other non-speech-like seed_tracks.
        Returns:
        A GetRecommendationsRequest.Builder.

      • max_tempo

        public GetRecommendationsRequest.Builder max_tempo​(Float max_tempo)
        The maximum tempo setter. Tracks with the attribute value above the maximum value will be omitted.
        Parameters:
        max_tempo - The overall estimated tempo of a track in beats per minute (BPM). In musical terminology, tempo is the speed or pace of a given piece and derives directly from the average beat duration.
        Returns:
        A GetRecommendationsRequest.Builder.

      • max_time_signature

        public GetRecommendationsRequest.Builder max_time_signature​(Integer max_time_signature)
        The maximum time signature setter. Tracks with the attribute value above the maximum value will be omitted.
        Parameters:
        max_time_signature - An estimated overall time signature of a track. The time signature (meter) is a notational convention to specify how many beats are in each bar (or measure).
        Returns:
        A GetRecommendationsRequest.Builder.

      • max_valence

        public GetRecommendationsRequest.Builder max_valence​(Float max_valence)
        The maximum valence setter. Tracks with the attribute value above the maximum value will be omitted.
        Parameters:
        max_valence - A measure from 0.0 to 1.0 describing the musical positiveness conveyed by a track. Tracks with high valence sound more positive (e.g. happy, cheerful, euphoric), while seed_tracks with low valence sound more negative (e.g. sad, depressed, angry).
        Returns:
        A GetRecommendationsRequest.Builder.

      • min_acousticness

        public GetRecommendationsRequest.Builder min_acousticness​(Float min_acousticness)
        The minimum acousticness setter. Tracks with the attribute value below the minimum value will be omitted.
        Parameters:
        min_acousticness - A confidence measure from 0.0 to 1.0 of whether the track is acoustic. 1.0 represents high confidence the track is acoustic.
        Returns:
        A GetRecommendationsRequest.Builder.

      • min_danceability

        public GetRecommendationsRequest.Builder min_danceability​(Float min_danceability)
        The minimum danceability setter. Tracks with the attribute value below the minimum value will be omitted.
        Parameters:
        min_danceability - Danceability describes how suitable a track is for dancing based on a combination of musical elements including tempo, rhythm stability, beat strength, and overall regularity. A value of 0.0 is least danceable and 1.0 is most danceable.
        Returns:
        A GetRecommendationsRequest.Builder.

      • min_energy

        public GetRecommendationsRequest.Builder min_energy​(Float min_energy)
        The minimum energy setter. Tracks with the attribute value below the minimum value will be omitted.
        Parameters:
        min_energy - Energy is a measure from 0.0 to 1.0 and represents a perceptual measure of intensity and activity. Typically, energetic seed_tracks feel fast, loud, and noisy. For example, death metal has high energy, while a Bach prelude scores low on the scale. Perceptual features contributing to this attribute include dynamic range, perceived loudness, timbre, onset rate, and general entropy.
        Returns:
        A GetRecommendationsRequest.Builder.

      • min_instrumentalness

        public GetRecommendationsRequest.Builder min_instrumentalness​(Float min_instrumentalness)
        The minimum instrumentalness setter. Tracks with the attribute value below the minimum value will be omitted.
        Parameters:
        min_instrumentalness - Predicts whether a track contains no vocals. "Ooh" and "aah" sounds are treated as instrumental in this context. Rap or spoken word seed_tracks are clearly "vocal". The closer the instrumentalness value is to 1.0, the greater likelihood the track contains no vocal content. Values above 0.5 are intended to represent instrumental seed_tracks, but confidence is higher as the value approaches 1.0.
        Returns:
        A GetRecommendationsRequest.Builder.

      • min_liveness

        public GetRecommendationsRequest.Builder min_liveness​(Float min_liveness)
        The minimum liveness setter. Tracks with the attribute value below the minimum value will be omitted.
        Parameters:
        min_liveness - Detects the presence of an audience in the recording. Higher liveness values represent an increased probability that the track was performed live. A value above 0.8 provides strong likelihood that the track is live.
        Returns:
        A GetRecommendationsRequest.Builder.

      • min_loudness

        public GetRecommendationsRequest.Builder min_loudness​(Float min_loudness)
        The minimum loudness setter. Tracks with the attribute value below the minimum value will be omitted.
        Parameters:
        min_loudness - The overall loudness of a track in decibels (dB). Loudness values are averaged across the entire track and are useful for comparing relative loudness of seed_tracks. Loudness is the quality of a sound that is the primary psychological correlate of physical strength (amplitude). Values typical range between -60 and 0 db.
        Returns:
        A GetRecommendationsRequest.Builder.

      • min_mode

        public GetRecommendationsRequest.Builder min_mode​(Integer min_mode)
        The minimum mode setter. Tracks with the attribute value below the minimum value will be omitted.
        Parameters:
        min_mode - Mode indicates the modality (major or minor) of a track, the type of scale from which its melodic content is derived. Major is represented by 1 and minor is 0.
        Returns:
        A GetRecommendationsRequest.Builder.

      • min_popularity

        public GetRecommendationsRequest.Builder min_popularity​(Integer min_popularity)
        The minimum popularity setter. Tracks with the attribute value below the minimum value will be omitted.
        Parameters:
        min_popularity - The popularity of the track. The value will be between 0 and 100, with 100 being the most popular. The popularity is calculated by algorithm and is based, in the most part, on the total number of plays the track has had and how recent those plays are.
        Returns:
        A GetRecommendationsRequest.Builder.

      • min_speechiness

        public GetRecommendationsRequest.Builder min_speechiness​(Float min_speechiness)
        The minimum speechiness setter. Tracks with the attribute value below the minimum value will be omitted.
        Parameters:
        min_speechiness - Speechiness detects the presence of spoken words in a track. The more exclusively speech-like the recording (e.g. talk show, audio book, poetry), the closer to 1.0 the attribute value. Values above 0.66 describe seed_tracks that are probably made entirely of spoken words. Values between 0.33 and 0.66 describe seed_tracks that may contain both music and speech, either in sections or layered, including such cases as rap music. Values below 0.33 most likely represent music and other non-speech-like seed_tracks.
        Returns:
        A GetRecommendationsRequest.Builder.

      • min_tempo

        public GetRecommendationsRequest.Builder min_tempo​(Float min_tempo)
        The minimum tempo setter. Tracks with the attribute value below the minimum value will be omitted.
        Parameters:
        min_tempo - The overall estimated tempo of a track in beats per minute (BPM). In musical terminology, tempo is the speed or pace of a given piece and derives directly from the average beat duration.
        Returns:
        A GetRecommendationsRequest.Builder.

      • min_time_signature

        public GetRecommendationsRequest.Builder min_time_signature​(Integer min_time_signature)
        The minimum time signature setter. Tracks with the attribute value below the minimum value will be omitted.
        Parameters:
        min_time_signature - An estimated overall time signature of a track. The time signature (meter) is a notational convention to specify how many beats are in each bar (or measure).
        Returns:
        A GetRecommendationsRequest.Builder.

      • min_valence

        public GetRecommendationsRequest.Builder min_valence​(Float min_valence)
        The minimum valence setter. Tracks with the attribute value below the minimum value will be omitted.
        Parameters:
        min_valence - A measure from 0.0 to 1.0 describing the musical positiveness conveyed by a track. Tracks with high valence sound more positive (e.g. happy, cheerful, euphoric), while seed_tracks with low valence sound more negative (e.g. sad, depressed, angry).
        Returns:
        A GetRecommendationsRequest.Builder.

      • target_acousticness

        public GetRecommendationsRequest.Builder target_acousticness​(Float target_acousticness)
        The target acousticness setter. Tracks with the attribute value nearest to the target value will be preferred. All target values will be weighed equally in ranking results.
        Parameters:
        target_acousticness - A confidence measure from 0.0 to 1.0 of whether the track is acoustic. 1.0 represents high confidence the track is acoustic.
        Returns:
        A GetRecommendationsRequest.Builder.

      • target_danceability

        public GetRecommendationsRequest.Builder target_danceability​(Float target_danceability)
        The target danceability setter. Tracks with the attribute value nearest to the target value will be preferred. All target values will be weighed equally in ranking results.
        Parameters:
        target_danceability - Danceability describes how suitable a track is for dancing based on a combination of musical elements including tempo, rhythm stability, beat strength, and overall regularity. A value of 0.0 is least danceable and 1.0 is most danceable.
        Returns:
        A GetRecommendationsRequest.Builder.

      • target_duration_ms

        public GetRecommendationsRequest.Builder target_duration_ms​(Integer target_duration_ms)
        The target duration setter. Tracks with the attribute value nearest to the target value will be preferred. All target values will be weighed equally in ranking results.
        Parameters:
        target_duration_ms - The duration of the track in milliseconds.
        Returns:
        A GetRecommendationsRequest.Builder.

      • target_energy

        public GetRecommendationsRequest.Builder target_energy​(Float target_energy)
        The target energy setter. Tracks with the attribute value nearest to the target value will be preferred. All target values will be weighed equally in ranking results.
        Parameters:
        target_energy - Energy is a measure from 0.0 to 1.0 and represents a perceptual measure of intensity and activity. Typically, energetic seed_tracks feel fast, loud, and noisy. For example, death metal has high energy, while a Bach prelude scores low on the scale. Perceptual features contributing to this attribute include dynamic range, perceived loudness, timbre, onset rate, and general entropy.
        Returns:
        A GetRecommendationsRequest.Builder.

      • target_instrumentalness

        public GetRecommendationsRequest.Builder target_instrumentalness​(Float target_instrumentalness)
        The target instrumentalness setter. Tracks with the attribute value nearest to the target value will be preferred. All target values will be weighed equally in ranking results.
        Parameters:
        target_instrumentalness - Predicts whether a track contains no vocals. "Ooh" and "aah" sounds are treated as instrumental in this context. Rap or spoken word seed_tracks are clearly "vocal". The closer the instrumentalness value is to 1.0, the greater likelihood the track contains no vocal content. Values above 0.5 are intended to represent instrumental seed_tracks, but confidence is higher as the value approaches 1.0.
        Returns:
        A GetRecommendationsRequest.Builder.

      • target_liveness

        public GetRecommendationsRequest.Builder target_liveness​(Float target_liveness)
        The target liveness setter. Tracks with the attribute value nearest to the target value will be preferred. All target values will be weighed equally in ranking results.
        Parameters:
        target_liveness - Detects the presence of an audience in the recording. Higher liveness values represent an increased probability that the track was performed live. A value above 0.8 provides strong likelihood that the track is live.
        Returns:
        A GetRecommendationsRequest.Builder.

      • target_loudness

        public GetRecommendationsRequest.Builder target_loudness​(Float target_loudness)
        The target loudness setter. Tracks with the attribute value nearest to the target value will be preferred. All target values will be weighed equally in ranking results.
        Parameters:
        target_loudness - The overall loudness of a track in decibels (dB). Loudness values are averaged across the entire track and are useful for comparing relative loudness of seed_tracks. Loudness is the quality of a sound that is the primary psychological correlate of physical strength (amplitude). Values typical range between -60 and 0 db.
        Returns:
        A GetRecommendationsRequest.Builder.

      • target_mode

        public GetRecommendationsRequest.Builder target_mode​(Integer target_mode)
        The target mode setter. Tracks with the attribute value nearest to the target value will be preferred. All target values will be weighed equally in ranking results.
        Parameters:
        target_mode - Mode indicates the modality (major or minor) of a track, the type of scale from which its melodic content is derived. Major is represented by 1 and minor is 0.
        Returns:
        A GetRecommendationsRequest.Builder.

      • target_popularity

        public GetRecommendationsRequest.Builder target_popularity​(Integer target_popularity)
        The target popularity setter. Tracks with the attribute value nearest to the target value will be preferred. All target values will be weighed equally in ranking results.
        Parameters:
        target_popularity - The value will be between 0 and 100, with 100 being the most popular. The popularity is calculated by algorithm and is based, in the most part, on the total number of plays the track has had and how recent those plays are.
        Returns:
        A GetRecommendationsRequest.Builder.

      • target_speechiness

        public GetRecommendationsRequest.Builder target_speechiness​(Float target_speechiness)
        The target speechiness setter. Tracks with the attribute value nearest to the target value will be preferred. All target values will be weighed equally in ranking results.
        Parameters:
        target_speechiness - Speechiness detects the presence of spoken words in a track. The more exclusively speech-like the recording (e.g. talk show, audio book, poetry), the closer to 1.0 the attribute value. Values above 0.66 describe seed_tracks that are probably made entirely of spoken words. Values between 0.33 and 0.66 describe seed_tracks that may contain both music and speech, either in sections or layered, including such cases as rap music. Values below 0.33 most likely represent music and other non-speech-like seed_tracks.
        Returns:
        A GetRecommendationsRequest.Builder.

      • target_tempo

        public GetRecommendationsRequest.Builder target_tempo​(Float target_tempo)
        The target tempo setter. Tracks with the attribute value nearest to the target value will be preferred. All target values will be weighed equally in ranking results.
        Parameters:
        target_tempo - The overall estimated tempo of a track in beats per minute (BPM). In musical terminology, tempo is the speed or pace of a given piece and derives directly from the average beat duration.
        Returns:
        A GetRecommendationsRequest.Builder.

      • target_time_signature

        public GetRecommendationsRequest.Builder target_time_signature​(Integer target_time_signature)
        The target time signature setter. Tracks with the attribute value nearest to the target value will be preferred. All target values will be weighed equally in ranking results.
        Parameters:
        target_time_signature - An estimated overall time signature of a track. The time signature (meter) is a notational convention to specify how many beats are in each bar (or measure).
        Returns:
        A GetRecommendationsRequest.Builder.

      • target_valence

        public GetRecommendationsRequest.Builder target_valence​(Float target_valence)
        The target valence setter. Tracks with the attribute value nearest to the target value will be preferred. All target values will be weighed equally in ranking results.
        Parameters:
        target_valence - A measure from 0.0 to 1.0 describing the musical positiveness conveyed by a track. Tracks with high valence sound more positive (e.g. happy, cheerful, euphoric), while seed_tracks with low valence sound more negative (e.g. sad, depressed, angry).
        Returns:
        A GetRecommendationsRequest.Builder.