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

# Overview

> Use SDK search APIs for semantic post search, hashtag post search, and semantic community search.

The SDK search pages in this section cover the client-side APIs for finding posts and communities. Keep the mental model simple: search is requested through SDK repository methods, filters narrow the search scope, and the backend returns ranked results.

<Note>
  Semantic search availability depends on your network configuration. Confirm that the feature is enabled for your network before building UI that depends on semantic search results.
</Note>

## Search Surfaces

| Surface                   | TypeScript                                        | iOS                                                              | Android                                                                  | Flutter                                                                     |
| ------------------------- | ------------------------------------------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------ | --------------------------------------------------------------------------- |
| Semantic community search | `CommunityRepository.semanticSearchCommunities()` | `AmityCommunityRepository().semanticSearchCommunities(options:)` | `AmitySocialClient.newCommunityRepository().semanticSearchCommunities()` | Not exposed in the current public Flutter SDK source reviewed for this page |
| Semantic post search      | `PostRepository.semanticSearchPosts()`            | `AmityPostRepository().semanticSearchPosts(options:)`            | `AmitySocialClient.newPostRepository().semanticSearchPosts()`            | Not exposed in the current public Flutter SDK source reviewed for this page |
| Hashtag post search       | `PostRepository.searchPostsByHashtag()`           | `AmityPostRepository().searchPostsByHashtag(options:)`           | `AmitySocialClient.newPostRepository().searchPostsByHashtag()`           | Not exposed in the current public Flutter SDK source reviewed for this page |

## Filters

| Filter            | Community search                                                    | Post search                                                                                  |
| ----------------- | ------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| Search text       | `query`                                                             | `query` for semantic search, `hashtags` for hashtag search                                   |
| Category IDs      | Supported for community semantic search                             | Not applicable                                                                               |
| Tags              | Supported for community semantic search                             | Use post query APIs for tag filters; hashtag search uses `hashtags`                          |
| Membership status | Supported by TypeScript, iOS, and Android community semantic search | Not applicable                                                                               |
| Target scope      | Not applicable                                                      | Semantic post search can scope to a user or community target on TypeScript, iOS, and Android |
| Post data types   | Not applicable                                                      | Supported for semantic post search; hashtag search support differs by platform               |
| Mixed structure   | Not applicable                                                      | Supported by TypeScript, iOS, and Android post search APIs                                   |

## Implementation Guides

<CardGroup cols={2}>
  <Card title="Search Communities" icon="users" href="./intelligent-search-community">
    Find communities by semantic query, category, tag, and membership status
  </Card>

  <Card title="Search Posts" icon="messages-square" href="./intelligent-search-post">
    Search posts by semantic query or by hashtag
  </Card>
</CardGroup>

## Notes

* Do not assume a fixed client-visible scoring formula. The SDK APIs return ranked collections, but ranking details are owned by the backend service.
* Debounce user-entered queries before starting a new search request.
* Keep empty, loading, and error states separate in your UI because search results may legitimately be empty.
* Dispose live collection subscriptions and notification tokens when the screen is destroyed.