# Intelligent Search - Community

## **Introduction**

The Intelligent Search Community API allows users to search for communities with advanced filtering options. The search covers all communities across categories and tags. However, you can refine the results by applying specific filters such as category IDs, tags, or membership status.

### **Category Filtering**

By default, the search will include communities from all categories. However, you can narrow the search scope to specific categories by specifying `categoryIds` array.

### **Tag Filtering**

By default, the search will include communities regardless of tags. However, you can narrow the search scope to specific tags by specifying `tags` array.

### **Membership Status Filtering**

You can choose to narrow the search by membership status option

`ALL` - Include communities regardless of membership status (default option)

`MEMBER` - Include only communities that the user is a member of.

`NOT_MEMBER` - Include only communities that the user is **not** a member of.

### Example Use Cases <a href="#example-use-cases" id="example-use-cases"></a>

### **Search for Communities** <a href="#search-for-communities" id="search-for-communities"></a>

When the user searches for "ice cream," the output may include communities ranked by their relevance score. For example:

```
Community 1st:
Name: "Ice Cream Society"
Description: "Share your favorite frozen dessert spots and homemade recipes."


Community 2nd:
Name: "Summer Vibes"
Description: "Your guide to the best ice cream parlors and gelato shops in town."


Community 3rd:
Name: "Frozen Treats United"
Description: "Connect with other ice cream and gelato enthusiasts."


Community 4th:
Name: "Sweet Tooth Adventures"
Description: "Explore the world of frozen desserts, from gelato to sorbets."


Community 5th:
Name: "Pastry Lovers"
Description: "Indulge in the best dessert experiences, from cakes to chilled treats."
```

The following code snippet demonstrates how to search for communities across the entire network using semantic search.&#x20;

{% tabs %}
{% tab title="iOS" %}
{% embed url="<https://gist.github.com/amythee/476c37ec3b37d59130cd4720958e57cb#file-semantic_search_communities-swift>" %}
{% endtab %}

{% tab title="Android" %}
{% embed url="<https://gist.github.com/amythee/dd8864a04a45393431c883005933c59f#file-amitycommunitysemanticsearch-kt>" %}
{% endtab %}

{% tab title="Typescript" %}
{% embed url="<https://gist.github.com/amythee/652174c82bdfc4fb1c11ffb395b38e21>" %}
{% endtab %}
{% endtabs %}

### Limitations <a href="#limitations" id="limitations"></a>

* The search is limited to community names and descriptions, excluding all content within communities


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.social.plus/social-plus-sdk/social/intelligent-search/intelligent-search-community.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.