> ## Documentation Index
> Fetch the complete documentation index at: https://social-b97141fb-feat-user-history-moderation-detail.mintlify.site/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.

  For Flutter, semantic post and community search are available from `amity_sdk` 7.8.7.
</Note>

## Search Surfaces

| Surface | TypeScript | iOS | Android | Flutter |
| - | - | - | - | - |
| Semantic community search | `CommunityRepository.semanticSearchCommunities()` | `AmityCommunityRepository().semanticSearchCommunities(options:)` | `AmitySocialClient.newCommunityRepository().semanticSearchCommunities()` | `AmitySocialClient.newCommunityRepository().semanticSearchCommunities()` |
| Semantic post search | `PostRepository.semanticSearchPosts()` | `AmityPostRepository().semanticSearchPosts(options:)` | `AmitySocialClient.newPostRepository().semanticSearchPosts()` | `AmitySocialClient.newPostRepository().semanticSearchPosts()` |
| Hashtag post search | `PostRepository.searchPostsByHashtag()` | `AmityPostRepository().searchPostsByHashtag(options:)` | `AmitySocialClient.newPostRepository().searchPostsByHashtag()` | Not available |

## 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, Android, and Flutter community semantic search | Not applicable |
| Target scope | Not applicable | Semantic post search can scope to a user or community target on TypeScript, iOS, Android, and Flutter |
| Post data types | Not applicable | Supported for semantic post search on all platforms; hashtag search support differs by platform |
| Mixed structure | Not applicable | Supported by semantic post search on TypeScript, iOS, Android, and Flutter; not exposed on Flutter's regular `getPosts()` builder |

## 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.
* The SDK exposes semantic search for both posts and communities. Current Android, iOS, and Flutter UIKit global-search screens use semantic search for posts, while their community tabs use keyword search; use the SDK community repository when you need semantic community discovery in UIKit.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.