# Query Communities

The `queryCommunities` method can be useful for users who are new to your app or are exploring their community options. By providing a way to explore for communities, you can help users to discover the full range of community options available within your app.

To query communities with certain criteria, the following parameters are used:

* `displayName` allows you to filter communities based on the community's displayName. (deprecated)
* `filter/membership` allows you filter communities based on the logged-in user membership status.
* `categoryId` allows you filter communities based on community categories.
* `sortBy` allows you filter communities based on the order that the communities were created or based on alphabetical order, last created, and first created.
* `includeDeleted` allows you specify if you want to include deleted communities in your query. By passing `true` or `false` to this method, you can include or exclude deleted communities from the results.

If you'd like to fetch all communities, you can pass the keyword as `null`. (deprecated)

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

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

{% tab title="JavaScript" %}
{% embed url="<https://gist.github.com/amythee/8d1ae63afa6fd36cfafcd4c8413aed23#file-querycommunity-js>" %}
{% endtab %}

{% tab title="TypeScript" %}
{% embed url="<https://gist.github.com/amythee/102ecb7f374c94a49ae74469335a56df#file-querycommunities-ts>" %}
{% endtab %}

{% tab title="Flutter" %}
{% embed url="<https://gist.github.com/amythee/d22e645d88768aeb6c0ab69c9bca0525#file-amitycommunityquery-dart>" %}
{% endtab %}
{% endtabs %}

### Search for communities

To search for communities, users can call the relevant method and provide the desired keyword,  membership options, and other parameters.&#x20;

If no keyword is supplied, the list of users for the specified community will be sorted by the date they joined.&#x20;

To search for communities with certain criteria, the following parameters are used:

* `keyword` allows you to filter communities based on the community's displayName.
* `filter/membership` allows you to filter communities based on the logged-in user membership status.
* `categoryId` allows you to filter communities based on community categories.
* `sortBy` allows you to filter communities based on the order in which the communities were created or based on alphabetical order, last created, and first created.
* `includeDeleted` allows you to specify if you want to include deleted communities in your query. By passing `true` or `false` to this method, you can include or exclude deleted communities from the results.

{% tabs %}
{% tab title="iOS" %}
{% embed url="<https://gist.github.com/amythee/8be44f3e6072945f3abe4bc16eb179e3>" %}
{% endtab %}

{% tab title="Android" %}
{% embed url="<https://gist.github.com/amythee/3be5134ee8e3c62585281d27588d166f>" %}
{% endtab %}
{% endtabs %}


---

# 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/communities/query-communities.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.