Skip to main content
GET
/
v1
/
discovery
/
search
Search
curl --request GET \
  --url https://sdk.anghami.com/v1/discovery/search
{
  "results": [
    {
      "songId": {
        "value": "<string>"
      },
      "albumId": {
        "value": "<string>"
      },
      "artistId": {
        "value": "<string>"
      },
      "playlistId": {
        "value": "<string>"
      },
      "showId": {
        "value": "<string>"
      },
      "seasonId": {
        "value": "<string>"
      },
      "episodeId": {
        "value": "<string>"
      },
      "movieId": {
        "value": "<string>"
      },
      "title": "<string>",
      "subtitle": "<string>",
      "artwork": {
        "url": "<string>",
        "width": 123,
        "height": 123
      }
    }
  ],
  "nextPageToken": "<string>",
  "totalCount": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.sdk.anghami.com/llms.txt

Use this file to discover all available pages before exploring further.

Headers

Authorization
string

OAuth 2.0 Bearer token for user-authenticated requests. Format: Bearer <access_token>. Optional if x-api-key is provided.

Example:

"Bearer eyJhbGciOiJSUzI1NiIs..."

x-api-key
string

API key for server-to-server access without user context. Optional if Authorization is provided.

Example:

"ang_live_..."

Accept-Language
string

Preferred locale for localized content (BCP 47). Determines which language variant is returned for LocalizedString fields.

Example:

"ar"

Query Parameters

q
string
required

The search query string. Must not be empty.

types
string[]

Optional content type filters to narrow results. If empty, all content types are searched.

market
string

Optional market/region code to scope results (e.g., "LB", "SA"). If empty, the server uses the caller's default market.

page_size
integer<int32>

Maximum number of items to return per page (1-100, default 20).

page_token
string

Opaque page token from a previous response. Omit for the first page.

Response

Successful response

SearchResponse is the response message containing search results.

results
object[]
nextPageToken
string

Token for the next page of results. Empty if no more pages.

totalCount
integer<int32>

Estimated total number of results matching the query.