# DomainListing

class `praw.models.``DomainListing`(reddit, domain)

  Provide a set of functions to interact with domain listings.

  `__init__`(reddit, domain)

    Initialize a DomainListing instance.

    Parameters:

    - reddit – An instance of Reddit.
    - domain – The domain for which to obtain listings.

  `controversial`(time_filter='all', **generator_kwargs)

    Return a ListingGenerator for controversial submissions.

    Parameters: | time_filter – Can be one of: all, day, hour, month, week, year (default: all).

    Raise `ValueError` if `time_filter` is invalid.

    Additional keyword arguments are passed in the initialization of `ListingGenerator`.

    This method can be used like:

        reddit.domain('imgur.com').controversial('week')
        reddit.multireddit('samuraisam', 'programming').controversial('day')
        reddit.redditor('spez').controversial('month')
        reddit.redditor('spez').comments.controversial('year')
        reddit.redditor('spez').submissions.controversial('all')
        reddit.subreddit('all').controversial('hour')

  `hot`(**generator_kwargs)

    Return a ListingGenerator for hot items.

    Additional keyword arguments are passed in the initialization of `ListingGenerator`.

    This method can be used like:

        reddit.domain('imgur.com').hot()
        reddit.multireddit('samuraisam', 'programming').hot()
        reddit.redditor('spez').hot()
        reddit.redditor('spez').comments.hot()
        reddit.redditor('spez').submissions.hot()
        reddit.subreddit('all').hot()

  `new`(**generator_kwargs)

    Return a ListingGenerator for new items.

    Additional keyword arguments are passed in the initialization of `ListingGenerator`.

    This method can be used like:

        reddit.domain('imgur.com').new()
        reddit.multireddit('samuraisam', 'programming').new()
        reddit.redditor('spez').new()
        reddit.redditor('spez').comments.new()
        reddit.redditor('spez').submissions.new()
        reddit.subreddit('all').new()

  classmethod `parse`(data, reddit)

    Return an instance of `cls` from `data`.

    Parameters:

    - data – The structured data.
    - reddit – An instance of `Reddit`.

  `random_rising`(**generator_kwargs)

    Return a ListingGenerator for random rising submissions.

    Additional keyword arguments are passed in the initialization of `ListingGenerator`.

  `rising`(**generator_kwargs)

    Return a ListingGenerator for rising submissions.

    Additional keyword arguments are passed in the initialization of `ListingGenerator`.

  `top`(time_filter='all', **generator_kwargs)

    Return a ListingGenerator for top submissions.

    Parameters: | time_filter – Can be one of: all, day, hour, month, week, year (default: all).

    Raise `ValueError` if `time_filter` is invalid.

    Additional keyword arguments are passed in the initialization of `ListingGenerator`.

    This method can be used like:

        reddit.domain('imgur.com').top('week')
        reddit.multireddit('samuraisam', 'programming').top('day')
        reddit.redditor('spez').top('month')
        reddit.redditor('spez').comments.top('year')
        reddit.redditor('spez').submissions.top('all')
        reddit.subreddit('all').top('hour')