> ## Documentation Index
> Fetch the complete documentation index at: https://algolia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hits

> Shows a list of search results.

## About this widget

Use the `Hits` view and helper components to display a list of search results.
Use [`HitsPaging`](/doc/api-reference/widgets/infinite-hits/android) if you want to use [infinite scrolling](/doc/guides/building-search-ui/ui-and-ux-patterns/infinite-scroll/android) in your search.

To add `Hits` to your search experience, use these components:

* `Searcher`. The [`Searcher`](/doc/api-reference/widgets/instantsearch/android) that handles your searches.
* `T`. A `data class` representing a search result.
* `HitsView<T>`. The view that renders objects of type `T`.

See also:

* [Get started with imperative UI](/doc/guides/building-search-ui/getting-started/how-to/programmatically/android)
* [Multi-index search](/doc/guides/building-search-ui/ui-and-ux-patterns/multi-index-search/android)
* [Searches without results](/doc/guides/building-search-ui/going-further/conditional-display/android#handling-no-results)

<Card title="Explore example code" icon="github" href="https://github.com/algolia/instantsearch-android/tree/master/examples/android">
  Browse the Hits example code on GitHub.
</Card>

## Examples

You can use `deserialize` to convert raw hits into your own `data class` using the `Serializable` annotation.

```kotlin Kotlin icon=code theme={"system"}
class MyActivity : AppCompatActivity() {

    val searcher = HitsSearcher(
        applicationID = "YourApplicationID",
        apiKey = "YourSearchOnlyAPIKey",
        indexName = "YourIndexName"
    )
    val connection = ConnectionHandler()
    val adapter = MovieAdapter()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        connection += searcher.connectHitsView(adapter) { response ->
            response.hits.deserialize(Movie.serializer())
        }
        searcher.searchAsync()
    }

    override fun onDestroy() {
        super.onDestroy()
        connection.disconnect()
        searcher.cancel()
    }
}

@Serializable
data class Movie(
    val title: String
)

class MovieViewHolder(val view: TextView): RecyclerView.ViewHolder(view) {

    fun bind(data: Movie) {
        view.text = data.title
    }
}

class MovieAdapter : RecyclerView.Adapter<MovieViewHolder>(), HitsView<Movie> {

    private var movies: List<Movie> = listOf()

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): MovieViewHolder {
        return MovieViewHolder(TextView(parent.context))
    }

    override fun onBindViewHolder(holder: MovieViewHolder, position: Int) {
        val movie = movies[position]

        holder.bind(movie)
    }

    override fun setHits(hits: List<Movie>) {
        movies = hits
        notifyDataSetChanged()
    }

    override fun getItemCount(): Int {
        return movies.size
    }
}
```

### Compose UI

InstantSearch provides the `LoadingState` as a state model, which is an implementation of the `LoadingView` interface.
You need to connect `LoadingState` to the `LoadingConnector` or `LoadingViewModel` like any other `LoadingView` implementation.

```kotlin Kotlin icon=code theme={"system"}
class MyActivity : AppCompatActivity() {
    val searcher = HitsSearcher(
        applicationID = "YourApplicationID",
        apiKey = "YourSearchOnlyAPIKey",
        indexName = "YourIndexName"
    )
    val hitsState = HitsState<Movie>()
    val connections = ConnectionHandler()

    init {
        connections += searcher.connectHitsView(hitsState) {
            it.hits.deserialize(Movie.serializer())
        }
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            LazyColumn {
                items(hitsState.hits) { movie ->
                    Text(movie.title)
                }
            }
        }
        searcher.searchAsync()
    }

    override fun onDestroy() {
        super.onDestroy()
        connections.disconnect()
        searcher.cancel()
    }
}
```

## Parameters

<ParamField body="transform" type="(SearchResponse) -> List<T>" required>
  A function transforming the search response into a list of results of your class `T`.

  ```kotlin Kotlin icon=code theme={"system"}
  import com.algolia.client.model.search.SearchResponse

  val transform: (SearchResponse) -> List<Movie> = { response ->
      response.hits.map { hit -> Movie(hit.json.getPrimitive("title").content) }
  }
  searcher.connectHitsView(adapter, transform)
  ```
</ParamField>