Search filters
The "search filters" API allows users perform multisearch for different filters, e.g search for users, tags, surah, ayah or ayah ranges.
This api is just like search, only difference is you can search using multiple queries and this is a POST request instead of GET.
Each search query follow the following format:
- If the search query starts with "#" (hashtag), the API will search for matching tags.
- If the search query starts with "@" (at sign), the API will search for matching usernames.
- Otherwise, the API will search for matching text in translations.
Auth header are optional, but if you're searching in user group/page then you'll need to provide the auth headers as well.
Query Parameters
client_auth_token string required
Client API token
Header Parameters
access-token string
user access token
client string
client access token
expiry string
timestamp of token expiry
Example: 1531315250
token-type string
access token type
Example: Bearer
uid string
user uid
Example: user@quranreflect.com
application/json
Request Body
q string[]
Responses
- 200
OK
Response Headers
application/json
Schema
Example (from schema)
Example 1
Example
Schema
- Array [
- ]
anyOf
MOD1
MOD2
id string
user id
text string
username
full_text string
full name with username
avatar string
url avatar url
collection string
Default value: authors
id string
language string
text string
collection string
Default value: tags
[
null,
null
]
{
"items": [
{
"id": 1,
"text": "#Allah",
"language": "English",
"collection": "tags"
},
{
"id": 1,
"text": "@naveed",
"full_text": "Naveed Ahmad (@naveed)",
"avatar": null,
"collection": "authors"
},
{
"from": null,
"to": null,
"text": "Maryam",
"collection": "filters",
"chapter": {
"id": 20,
"number": 19,
"size": 98,
"citation_names": [
{
"id": 19,
"name": "Maryam",
"language_id": 2,
"translation_id": 6,
"default": false,
"default_for_filter": true
}
],
"name": "Maryam"
}
}
]
}
{
"success": true,
"items": [
[
{
"id": 4,
"text": "#Akhera",
"collection": "tags"
}
],
[
{
"from": 1,
"to": 3,
"text": "Al-Faatiha: 1 - 3",
"collection": "filters",
"chapter": {
"id": 2,
"number": 1,
"size": 7,
"citation_names": [
{
"id": 1,
"name": "Al-Faatiha",
"language_id": 2,
"translation_id": 5,
"default": false,
"default_for_filter": true
},
{
"id": 155,
"name": "الفاتحة",
"language_id": 1,
"translation_id": 1,
"default": true,
"default_for_filter": false
},
{
"id": 269,
"name": "The Opening",
"language_id": 2,
"translation_id": 6,
"default": true,
"default_for_filter": false
},
{
"id": 497,
"name": "La Apertura",
"language_id": 3,
"translation_id": 7,
"default": true,
"default_for_filter": false
}
],
"name": "Al-Faatiha"
}
}
],
[
{
"from": null,
"to": null,
"text": "Al-Baqara",
"collection": "filters",
"chapter": {
"id": 3,
"number": 2,
"size": 286,
"citation_names": [
{
"id": 2,
"name": "Al-Baqara",
"language_id": 2,
"translation_id": 5,
"default": false,
"default_for_filter": true
},
{
"id": 156,
"name": "البقرة",
"language_id": 1,
"translation_id": 1,
"default": true,
"default_for_filter": false
},
{
"id": 270,
"name": "The Cow",
"language_id": 2,
"translation_id": 6,
"default": true,
"default_for_filter": false
},
{
"id": 498,
"name": "La Vaca",
"language_id": 3,
"translation_id": 7,
"default": true,
"default_for_filter": false
}
],
"name": "Al-Baqara"
}
}
],
[
{
"id": 4,
"text": "@amerabbas",
"collection": "authors"
},
{
"id": 5,
"text": "@samerabbas",
"collection": "authors"
}
]
]
}
Loading...