Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/pratyay360/searchapi/llms.txt

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

The /search/specific/ endpoint is a generalization of the PDF search endpoint. Instead of hardcoding filetype:pdf, it accepts a filetype parameter and prepends filetype:{filetype} to your query before searching. This lets you find any publicly-indexed file format — spreadsheets, presentations, Word documents, plain text files, and more — with a single endpoint.
For PDFs specifically, you can use either this endpoint or /searchpdfs/. This endpoint is more flexible and supports all filetypes, but note that the limit parameter here is limit (without the trailing s).

​
Request

GET /search/specific/?query={query}&filetype={filetype}&limit={limit}

​
Parameters

​
query
string
required
The search query. Do not include a filetype: operator — this is added automatically. URL-encode spaces as + or %20.
​
filetype
string
required
The file extension to search for. Common values include pdf, doc, docx, ppt, pptx, xls, xlsx, txt, csv, and epub. The value is passed directly to the search engine’s filetype: operator.
​
limit
integer
required
Maximum number of file URLs to return.

​
Common filetype values

ValueFormat
pdfPDF documents
docxMicrosoft Word (modern)
docMicrosoft Word (legacy)
pptxMicrosoft PowerPoint (modern)
pptMicrosoft PowerPoint (legacy)
xlsxMicrosoft Excel (modern)
xlsMicrosoft Excel (legacy)
csvComma-separated values
txtPlain text
epubeBook format

​
Response

Returns a JSON array of URL strings pointing to files of the requested type on success.
​
[*]
string
A URL to a file matching the specified filetype.

​
Example

curl "http://localhost:8000/search/specific/?query=quarterly+earnings+report&filetype=xlsx&limit=5"
Response
[
  "https://example.com/reports/Q1-2024-earnings.xlsx",
  "https://investor.acmecorp.com/downloads/annual-report-2023.xlsx",
  "https://data.gov/dataset/financial-report-2024.xlsx",
  "https://company.example.org/financials/q3-results.xlsx",
  "https://opendata.example.net/budget/municipality-2024.xlsx"
]

​
Error response

500
{ "error": "Filetype search failed" }

Build docs developers (and LLMs) love

Get started for freeTalk to us