I want to confirm what is the total search keywords can be searched at a single query in Azure AI Search

Nagar, Sunil 0 Reputation points
2026-08-11T08:06:50.9266667+00:00

I am searching within Azure Index via REST API, now I want to confirm what is the search query limit such as how many keywords searches I can do within one single query with AI Search.

Azure AI Search
Azure AI Search

An Azure search service with built-in artificial intelligence capabilities that enrich information to help identify and explore relevant content at scale.

4 answers

Sort by: Oldest
Most helpful Newest Oldest

  1. AI answer

    2026-08-11T08:07:05.02+00:00

    For a single Azure AI Search query, the supported limits are:

    • Maximum search clause length: 100,000 characters
    • Maximum number of clauses in search: 3,000 for Query APIs
    • For simple query syntax: 1,024 clauses when expressions are separated by AND or OR
    • Maximum search term size: about 32 KB for a term in UTF-8 text
    • Prefix search term size: 1,000 characters
    • REST GET URL length: 8 KB maximum
    • POST request payload size: 16 MB maximum

    If “how many keywords” means how many terms can be combined in one query, the practical limit is controlled by the number of clauses and the total search clause length, not by a separate keyword-count setting.

    If the query is being built programmatically, keep it bounded because very large queries can destabilize the service.

    References:

    AI-generated content may be incorrect. Read our transparency notes for more information.

    Was this answer helpful?

  2. Andrew Taylor - COREZENN 1,390 Reputation points Volunteer Moderator
    2026-08-11T23:33:21.1+00:00

    Hi @Nagar, Sunil

    Thanks for reaching out to Microsoft Q&A. I understand you are evaluating the Azure AI Search capabilities, and for such there isn't really a "number of keywords" limit, but instead, what Azure AI Search actually caps is the number of search clauses (terms/expressions joined by AND/OR) in a single search query, plus a few related size limits on the query and on individual terms.

    Based on the Service limits in Azure AI Search documentation, the current limits for the Query APIs are:

    • Maximum number of clauses in a search query: 3,000
    • Maximum length of a single search clause: 100,000 characters
    • Maximum search term size: 32,766 bytes (32 KB minus 2 bytes) of UTF-8 encoded text for keyword search and vector-search text
    • Maximum search term size for prefix search or regex search: 1,000 characters
    • Overall request payload: up to 16 MB for POST requests; GET requests are limited to an 8‑KB URL

    One thing worth flagging: the Simple query syntax doc page lists the max clause count as 1,024 rather than 3,000. I'd treat the dedicated Service limits page as the current source of truth for capacity planning, since it's the article Microsoft maintains specifically for these numbers. Still, if you're building a query composer that could realistically approach these limits, it's worth designing it so it can't generate an unbounded number of clauses in the first place, since both pages call out that unbounded queries can destabilize the search service.

    Please 'Upvote ' (thumbs-up) and 'Accept' as an answer. This will be helpful to other community members facing the same issue.

    Best regards, Andrew S Taylor

    Was this answer helpful?

    0 comments
  3. Nithin 330 Reputation points
    2026-08-17T02:48:31.0933333+00:00

    Hi,

    Here are the official query and search keyword limits for Azure AI Search:

    • Individual Search Term Limit: Maximum 32,766 bytes (~32 KB) per keyword term (or 1,000 characters for prefix/regex searches).
    • Total Search Clause Limit: Maximum 100,000 characters in the search query string.
    • Maximum Query Expressions: Up to 3,000 clauses (or 1,024 in simple syntax) joined by AND/OR.
    • Request Payload: Up to 16 MB for POST requests (or 8 KB URL length for GET requests).

    Ref: Azure AI Search Query & Service Limits

    Was this answer helpful?

    0 comments
  4. Abhinaba Das 115 Reputation points Microsoft External Staff Moderator
    2026-08-19T22:27:50.8066667+00:00

    Hi @Nagar, Sunil

    Thank you for your question.

    Azure AI Search does not have a fixed limit on the number of individual keywords that can be included in a single search query. Instead, the practical limit depends on the query syntax and the number of search clauses being used.

    For the Query APIs, the current service limits are:

    Maximum number of clauses in search: 3,000

    Maximum length of a search clause: 100,000 characters

    Maximum size of an individual search term: 32,766 bytes (UTF-8)

    For prefix and regex searches: 1,000 characters

    Maximum REST API request size: 16 MB

    Maximum URL length for GET requests: 8 KB

    If you are using the simple query syntax, the simple syntax documentation specifically lists a maximum of 1,024 clauses for expressions separated by AND or OR.

    Therefore, if your question is how many keywords can be searched in one request, the answer is that there is no single fixed keyword count. The actual limit depends on how the query is constructed, including the number of clauses, the total query length, and the query syntax being used.

    For large programmatically generated queries, I recommend keeping the query size bounded and splitting very large keyword lists into multiple requests rather than approaching the supported limits.

    References:

    https://learn.microsoft.com/bs-latn-ba/azure/search/search-limits-quotas-capacity

    https://learn.microsoft.com/th-th/azure/search/query-simple-syntax

    If the answer is helpful, please do click "Accept the answer” and Yes, this can be beneficial to other community members.

    Was this answer helpful?

    0 comments

Your answer

Answers can be marked as 'Accepted' by the question author and 'Recommended' by moderators, which helps users know the answer solved the author's problem.