# Search API implementation and SDKs do not match API docs and SDK docs **URL:** \ **Category:** Bug Reports\ **Tags:** search-api\ **Created:** [September 26, 2025, 3:06pm UTC](https://community.perplexity.ai/t/search-api-implementation-and-sdks-do-not-match-api-docs-and-sdk-docs/1616 "2025-09-26T15:06:28Z")\ **Posts on this page:** 5\ **Page:** 1
**Author:** ![kremalicious](https://sea1.discourse-cdn.com/flex001/user_avatar/community.perplexity.ai/kremalicious/32/1120_2.png) [@kremalicious](https://community.perplexity.ai/u/kremalicious)\ **Post date:** [September 26, 2025, 3:06pm UTC](https://community.perplexity.ai/t/search-api-implementation-and-sdks-do-not-match-api-docs-and-sdk-docs/1616/1 "2025-09-26T15:06:28Z")
## πŸ› Describe the Bug There are significant differences between the [Search API docs](https://docs.perplexity.ai/guides/search-quickstart), the actual implementation shown in the [Search API references](https://docs.perplexity.ai/api-reference/search-post) and the SDKs and their [docs](https://docs.perplexity.ai/guides/perplexity-sdk-search): - `search_recency_filter` does not exist as option in endpoint or Typescript SDK or Python SDK, the latter [being reported here](https://community.perplexity.ai/t/python-api-examples-not-correct/1613) - `return_images`also does not exist in API references or in Typescript SDK. Likewise, does not include it in the `SearchCreateResponse.Result` typings either - Same for `return_snippets`, `user_location_filter`, and more, basically almost everything listed in the [advanced search for the SDK](https://docs.perplexity.ai/guides/perplexity-sdk-search#advanced-usage) can’t be used: - for many options there’s a discrepancy in casing between docs and SDKs, e.g all Quick Start examples for Typescript SDK use `maxTokens` but the typings expect `max_tokens` ## βœ… Expected Behavior I expect the API docs to match the actual implementation and SDKs and their typings ## ❌ Actual Behavior Endpoint and/or SDK do not support all options mentioned in API docs ## πŸ“Œ API Request & Response E.g. [Best Practices](https://docs.perplexity.ai/guides/search-best-practices) examples for Typescript say: `const webSearch = await client.search.create({ ` `query: "latest tech news",` ` searchMode: "web",` ` searchRecencyFilter: "day"` `});` When based on the typings it should be: `const webSearch = await client.search.create({ ` `query: "latest tech news",` ` search_mode: "web",` ` search_recency_filter: "day"` `});` But even then `search_recency_filter` does not exist in the typings. ## 🌍 Environment - **API Version:** Search API - **SDK (if applicable):** Python, Typescript (@perplexity-ai/perplexity\_ai v0.6.0) - **Operating System:** all of them ## πŸ“ Additional Context Mismatched documentation also applies to the GitHub repo readme [accessible through npm](https://www.npmjs.com/package/@perplexity-ai/perplexity_ai) where the documented code examples are not what the underlying library expects. The linked api.md in there leads to 404 on GitHub as I would assume the underlying [GitHub repo](https://github.com/ppl-ai/perplexity-node) has not been made public for whatever reason. All in all a pretty frustrating experience trying to use this new API where all developer touchpoints are either wrong or incomplete or not accessible. ---
**Author:** ![Jeremy\_He](https://sea1.discourse-cdn.com/flex001/user_avatar/community.perplexity.ai/jeremy_he/32/389_2.png) [@Jeremy\_He](https://community.perplexity.ai/u/Jeremy_He)\ **Post date:** [September 28, 2025, 7:50am UTC](https://community.perplexity.ai/t/search-api-implementation-and-sdks-do-not-match-api-docs-and-sdk-docs/1616/2 "2025-09-28T07:50:31Z")
Multi-Query Search example not working either. Only returning results for the first element in a query list ---
**Author:** ![Kapil\_Reddy](https://sea1.discourse-cdn.com/flex001/user_avatar/community.perplexity.ai/kapil_reddy/32/1148_2.png) [@Kapil\_Reddy](https://community.perplexity.ai/u/Kapil_Reddy)\ **Post date:** [September 28, 2025, 2:19pm UTC](https://community.perplexity.ai/t/search-api-implementation-and-sdks-do-not-match-api-docs-and-sdk-docs/1616/3 "2025-09-28T14:19:05Z")
When I pass `search_domain_filter` in the body payload to `https://api.perplexity.ai/search` it returns 400. This was strangely working for me until yesterday. ---
**Author:** ![esafev](https://sea1.discourse-cdn.com/flex001/user_avatar/community.perplexity.ai/esafev/32/1304_2.png) [@esafev](https://community.perplexity.ai/u/esafev)\ **Post date:** [October 8, 2025, 10:04am UTC](https://community.perplexity.ai/t/search-api-implementation-and-sdks-do-not-match-api-docs-and-sdk-docs/1616/4 "2025-10-08T10:04:42Z")
Hey! Same issue with `search_domain_filter` popping up for us. Are there any plans to bring this option back? ---
**Author:** ![Brian\_Tam](https://sea1.discourse-cdn.com/flex001/user_avatar/community.perplexity.ai/brian_tam/32/1411_2.png) [@Brian\_Tam](https://community.perplexity.ai/u/Brian_Tam)\ **Post date:** [October 14, 2025, 10:14am UTC](https://community.perplexity.ai/t/search-api-implementation-and-sdks-do-not-match-api-docs-and-sdk-docs/1616/5 "2025-10-14T10:14:19Z")
me too, hope they fix it