exa-py 1.16.0__py3-none-any.whl → 2.0.0__py3-none-any.whl

exa_py/api.py

@@ -47,6 +47,9 @@ from .research import ResearchClient, AsyncResearchClient
 
 is_beta = os.getenv("IS_BETA") == "True"
 
+# Default max characters for text contents
+DEFAULT_MAX_CHARACTERS = 10_000
+
 
 def snake_to_camel(snake_str: str) -> str:
     """Convert snake_case string to camelCase.
@@ -141,7 +144,6 @@ SEARCH_OPTIONS_TYPES = {
     "exclude_text": [
         list
     ],  # Must not be present in webpage text. (One string, up to 5 words)
-    "use_autoprompt": [bool],  # Convert query to Exa. (Default: false)
     "type": [
         str
     ],  # 'keyword', 'neural', 'hybrid', 'fast', 'deep', or 'auto' (Default: auto)
@@ -150,6 +152,7 @@ SEARCH_OPTIONS_TYPES = {
     ],  # A data category to focus on: 'company', 'research paper', 'news', 'pdf', 'github', 'tweet', 'personal site', 'linkedin profile', 'financial report'
     "flags": [list],  # Experimental flags array for Exa usage.
     "moderation": [bool],  # If true, moderate search results for safety.
+    "contents": [dict, bool],  # Options for retrieving page contents
 }
 
 FIND_SIMILAR_OPTIONS_TYPES = {
@@ -166,6 +169,7 @@ FIND_SIMILAR_OPTIONS_TYPES = {
     "exclude_source_domain": [bool],
     "category": [str],
     "flags": [list],  # Experimental flags array for Exa usage.
+    "contents": [dict, bool],  # Options for retrieving page contents
 }
 
 # the livecrawl options
@@ -174,7 +178,6 @@ LIVECRAWL_OPTIONS = Literal["always", "fallback", "never", "auto", "preferred"]
 CONTENTS_OPTIONS_TYPES = {
     "urls": [list],
     "text": [dict, bool],
-    "highlights": [dict, bool],
     "summary": [dict, bool],
     "context": [dict, bool],
     "metadata": [dict, bool],
@@ -255,24 +258,6 @@ class TextContentsOptions(TypedDict, total=False):
     include_html_tags: bool
 
 
-class HighlightsContentsOptions(TypedDict, total=False):
-    """A class representing the options that you can specify when requesting highlights
-
-    Attributes:
-        query (str): The query string for the highlights.
-        num_sentences (int): Size of highlights to return, in sentences. Default: 5
-        highlights_per_url (int): Number of highlights to return per URL. Default: 1
-
-    NOTE: When using the "deep" search type, only the default highlights=True is supported.
-          These options will NOT be respected. Highlights will always be based on the user's query,
-          and the number and length may vary.
-    """
-
-    query: str
-    num_sentences: int
-    highlights_per_url: int
-
-
 class JSONSchema(TypedDict, total=False):
     """Represents a JSON Schema definition used for structured summary output.
 
@@ -341,7 +326,6 @@ class CostDollarsContents(TypedDict, total=False):
     """Represents the cost breakdown for contents."""
 
     text: float
-    highlights: float
     summary: float
 
 
@@ -424,18 +408,14 @@ class _Result:
 @dataclass
 class Result(_Result):
     """
-    A class representing a search result with optional text, highlights, summary.
+    A class representing a search result with optional text and summary.
 
     Attributes:
         text (str, optional)
-        highlights (List[str], optional)
-        highlight_scores (List[float], optional)
         summary (str, optional)
     """
 
     text: Optional[str] = None
-    highlights: Optional[List[str]] = None
-    highlight_scores: Optional[List[float]] = None
     summary: Optional[str] = None
 
     def __init__(
@@ -451,9 +431,9 @@ class Result(_Result):
         subpages=None,
         extras=None,
         text=None,
-        highlights=None,
-        highlight_scores=None,
         summary=None,
+        highlights=None,  # Deprecated, for backward compatibility
+        highlight_scores=None,  # Deprecated, for backward compatibility
     ):
         super().__init__(
             url,
@@ -468,18 +448,11 @@ class Result(_Result):
             extras,
         )
         self.text = text
-        self.highlights = highlights
-        self.highlight_scores = highlight_scores
         self.summary = summary
 
     def __str__(self):
         base_str = super().__str__()
-        return base_str + (
-            f"Text: {self.text}\n"
-            f"Highlights: {self.highlights}\n"
-            f"Highlight Scores: {self.highlight_scores}\n"
-            f"Summary: {self.summary}\n"
-        )
+        return base_str + (f"Text: {self.text}\nSummary: {self.summary}\n")
 
 
 @dataclass
@@ -526,113 +499,6 @@ class ResultWithText(_Result):
         return base_str + f"Text: {self.text}\n"
 
 
-@dataclass
-class ResultWithHighlights(_Result):
-    """
-    A class representing a search result with highlights present.
-
-    Attributes:
-        highlights (List[str])
-        highlight_scores (List[float])
-    """
-
-    highlights: List[str] = dataclasses.field(default_factory=list)
-    highlight_scores: List[float] = dataclasses.field(default_factory=list)
-
-    def __init__(
-        self,
-        url,
-        id,
-        title=None,
-        score=None,
-        published_date=None,
-        author=None,
-        image=None,
-        favicon=None,
-        subpages=None,
-        extras=None,
-        highlights=None,
-        highlight_scores=None,
-    ):
-        super().__init__(
-            url,
-            id,
-            title,
-            score,
-            published_date,
-            author,
-            image,
-            favicon,
-            subpages,
-            extras,
-        )
-        self.highlights = highlights if highlights is not None else []
-        self.highlight_scores = highlight_scores if highlight_scores is not None else []
-
-    def __str__(self):
-        base_str = super().__str__()
-        return base_str + (
-            f"Highlights: {self.highlights}\n"
-            f"Highlight Scores: {self.highlight_scores}\n"
-        )
-
-
-@dataclass
-class ResultWithTextAndHighlights(_Result):
-    """
-    A class representing a search result with text and highlights present.
-
-    Attributes:
-        text (str)
-        highlights (List[str])
-        highlight_scores (List[float])
-    """
-
-    text: str = dataclasses.field(default_factory=str)
-    highlights: List[str] = dataclasses.field(default_factory=list)
-    highlight_scores: List[float] = dataclasses.field(default_factory=list)
-
-    def __init__(
-        self,
-        url,
-        id,
-        title=None,
-        score=None,
-        published_date=None,
-        author=None,
-        image=None,
-        favicon=None,
-        subpages=None,
-        extras=None,
-        text="",
-        highlights=None,
-        highlight_scores=None,
-    ):
-        super().__init__(
-            url,
-            id,
-            title,
-            score,
-            published_date,
-            author,
-            image,
-            favicon,
-            subpages,
-            extras,
-        )
-        self.text = text
-        self.highlights = highlights if highlights is not None else []
-        self.highlight_scores = highlight_scores if highlight_scores is not None else []
-
-    def __str__(self):
-        base_str = super().__str__()
-        return base_str + (
-            f"Text: {self.text}\n"
-            f"Highlights: {self.highlights}\n"
-            f"Highlight Scores: {self.highlight_scores}\n"
-        )
-
-
 @dataclass
 class ResultWithSummary(_Result):
     """
@@ -725,123 +591,6 @@ class ResultWithTextAndSummary(_Result):
         return base_str + f"Text: {self.text}\n" + f"Summary: {self.summary}\n"
 
 
-@dataclass
-class ResultWithHighlightsAndSummary(_Result):
-    """
-    A class representing a search result with highlights and summary present.
-
-    Attributes:
-        highlights (List[str])
-        highlight_scores (List[float])
-        summary (str)
-    """
-
-    highlights: List[str] = dataclasses.field(default_factory=list)
-    highlight_scores: List[float] = dataclasses.field(default_factory=list)
-    summary: str = dataclasses.field(default_factory=str)
-
-    def __init__(
-        self,
-        url,
-        id,
-        title=None,
-        score=None,
-        published_date=None,
-        author=None,
-        image=None,
-        favicon=None,
-        subpages=None,
-        extras=None,
-        highlights=None,
-        highlight_scores=None,
-        summary="",
-    ):
-        super().__init__(
-            url,
-            id,
-            title,
-            score,
-            published_date,
-            author,
-            image,
-            favicon,
-            subpages,
-            extras,
-        )
-        self.highlights = highlights if highlights is not None else []
-        self.highlight_scores = highlight_scores if highlight_scores is not None else []
-        self.summary = summary
-
-    def __str__(self):
-        base_str = super().__str__()
-        return base_str + (
-            f"Highlights: {self.highlights}\n"
-            f"Highlight Scores: {self.highlight_scores}\n"
-            f"Summary: {self.summary}\n"
-        )
-
-
-@dataclass
-class ResultWithTextAndHighlightsAndSummary(_Result):
-    """
-    A class representing a search result with text, highlights, and summary present.
-
-    Attributes:
-        text (str)
-        highlights (List[str])
-        highlight_scores (List[float])
-        summary (str)
-    """
-
-    text: str = dataclasses.field(default_factory=str)
-    highlights: List[str] = dataclasses.field(default_factory=list)
-    highlight_scores: List[float] = dataclasses.field(default_factory=list)
-    summary: str = dataclasses.field(default_factory=str)
-
-    def __init__(
-        self,
-        url,
-        id,
-        title=None,
-        score=None,
-        published_date=None,
-        author=None,
-        image=None,
-        favicon=None,
-        subpages=None,
-        extras=None,
-        text="",
-        highlights=None,
-        highlight_scores=None,
-        summary="",
-    ):
-        super().__init__(
-            url,
-            id,
-            title,
-            score,
-            published_date,
-            author,
-            image,
-            favicon,
-            subpages,
-            extras,
-        )
-        self.text = text
-        self.highlights = highlights if highlights is not None else []
-        self.highlight_scores = highlight_scores if highlight_scores is not None else []
-        self.summary = summary
-
-    def __str__(self):
-        base_str = super().__str__()
-        return base_str + (
-            f"Text: {self.text}\n"
-            f"Highlights: {self.highlights}\n"
-            f"Highlight Scores: {self.highlight_scores}\n"
-            f"Summary: {self.summary}\n"
-        )
-
-
 @dataclass
 class AnswerResult:
     """A class representing a result for an answer.
@@ -1073,7 +822,6 @@ class SearchResponse(Generic[T]):
 
     Attributes:
         results (List[Result]): A list of search results.
-        autoprompt_string (str, optional): The Exa query created by autoprompt.
         resolved_search_type (str, optional): 'neural' or 'keyword' if auto.
         auto_date (str, optional): A date for filtering if autoprompt found one.
         context (str, optional): Combined context string when requested via contents.context.
@@ -1082,7 +830,6 @@ class SearchResponse(Generic[T]):
     """
 
     results: List[T]
-    autoprompt_string: Optional[str]
     resolved_search_type: Optional[str]
     auto_date: Optional[str]
     context: Optional[str] = None
@@ -1093,8 +840,6 @@ class SearchResponse(Generic[T]):
         output = "\n\n".join(str(result) for result in self.results)
         if self.context:
             output += f"\nContext: {self.context}"
-        if self.autoprompt_string:
-            output += f"\n\nAutoprompt String: {self.autoprompt_string}"
         if self.resolved_search_type:
             output += f"\nResolved Search Type: {self.resolved_search_type}"
         if self.cost_dollars:
@@ -1230,312 +975,28 @@ class Exa:
                 return res
             else:
                 res = requests.post(
-                    self.base_url + endpoint, data=json_data, headers=request_headers
-                )
-        elif method.upper() == "PATCH":
-            res = requests.patch(
-                self.base_url + endpoint, data=json_data, headers=request_headers
-            )
-        elif method.upper() == "DELETE":
-            res = requests.delete(self.base_url + endpoint, headers=request_headers)
-        else:
-            raise ValueError(f"Unsupported HTTP method: {method}")
-
-        if res.status_code >= 400:
-            raise ValueError(
-                f"Request failed with status code {res.status_code}: {res.text}"
-            )
-        return res.json()
-
-    def search(
-        self,
-        query: str,
-        *,
-        num_results: Optional[int] = None,
-        include_domains: Optional[List[str]] = None,
-        exclude_domains: Optional[List[str]] = None,
-        start_crawl_date: Optional[str] = None,
-        end_crawl_date: Optional[str] = None,
-        start_published_date: Optional[str] = None,
-        end_published_date: Optional[str] = None,
-        include_text: Optional[List[str]] = None,
-        exclude_text: Optional[List[str]] = None,
-        use_autoprompt: Optional[bool] = None,
-        type: Optional[str] = None,
-        category: Optional[str] = None,
-        flags: Optional[List[str]] = None,
-        moderation: Optional[bool] = None,
-        user_location: Optional[str] = None,
-    ) -> SearchResponse[_Result]:
-        """Perform a search with a prompt-engineered query to retrieve relevant results.
-
-        Args:
-            query (str): The query string.
-            num_results (int, optional): Number of search results to return (default 10).
-            include_domains (List[str], optional): Domains to include in the search.
-            exclude_domains (List[str], optional): Domains to exclude from the search.
-            start_crawl_date (str, optional): Only links crawled after this date.
-            end_crawl_date (str, optional): Only links crawled before this date.
-            start_published_date (str, optional): Only links published after this date.
-            end_published_date (str, optional): Only links published before this date.
-            include_text (List[str], optional): Strings that must appear in the page text.
-            exclude_text (List[str], optional): Strings that must not appear in the page text.
-            use_autoprompt (bool, optional): Convert query to Exa (default False).
-            type (str, optional): 'keyword', 'neural', 'hybrid', 'fast', 'deep', or 'auto' (default 'auto').
-            category (str, optional): e.g. 'company'
-            flags (List[str], optional): Experimental flags for Exa usage.
-            moderation (bool, optional): If True, the search results will be moderated for safety.
-            user_location (str, optional): Two-letter ISO country code of the user (e.g. US).
-
-        Returns:
-            SearchResponse: The response containing search results, etc.
-        """
-        options = {k: v for k, v in locals().items() if k != "self" and v is not None}
-        validate_search_options(options, SEARCH_OPTIONS_TYPES)
-        options = to_camel_case(options)
-        data = self.request("/search", options)
-        cost_dollars = parse_cost_dollars(data.get("costDollars"))
-        results = []
-        for result in data["results"]:
-            snake_result = to_snake_case(result)
-            results.append(
-                Result(
-                    url=snake_result.get("url"),
-                    id=snake_result.get("id"),
-                    title=snake_result.get("title"),
-                    score=snake_result.get("score"),
-                    published_date=snake_result.get("published_date"),
-                    author=snake_result.get("author"),
-                    image=snake_result.get("image"),
-                    favicon=snake_result.get("favicon"),
-                    subpages=snake_result.get("subpages"),
-                    extras=snake_result.get("extras"),
-                    text=snake_result.get("text"),
-                    highlights=snake_result.get("highlights"),
-                    highlight_scores=snake_result.get("highlight_scores"),
-                    summary=snake_result.get("summary"),
-                )
-            )
-        return SearchResponse(
-            results,
-            data["autopromptString"] if "autopromptString" in data else None,
-            data["resolvedSearchType"] if "resolvedSearchType" in data else None,
-            data["autoDate"] if "autoDate" in data else None,
-            cost_dollars=cost_dollars,
-        )
-
-    @overload
-    def search_and_contents(
-        self,
-        query: str,
-        *,
-        num_results: Optional[int] = None,
-        include_domains: Optional[List[str]] = None,
-        exclude_domains: Optional[List[str]] = None,
-        start_crawl_date: Optional[str] = None,
-        end_crawl_date: Optional[str] = None,
-        start_published_date: Optional[str] = None,
-        end_published_date: Optional[str] = None,
-        include_text: Optional[List[str]] = None,
-        exclude_text: Optional[List[str]] = None,
-        use_autoprompt: Optional[bool] = None,
-        type: Optional[str] = None,
-        category: Optional[str] = None,
-        flags: Optional[List[str]] = None,
-        moderation: Optional[bool] = None,
-        user_location: Optional[str] = None,
-        livecrawl_timeout: Optional[int] = None,
-        livecrawl: Optional[LIVECRAWL_OPTIONS] = None,
-        filter_empty_results: Optional[bool] = None,
-        subpages: Optional[int] = None,
-        subpage_target: Optional[Union[str, List[str]]] = None,
-        extras: Optional[ExtrasOptions] = None,
-    ) -> SearchResponse[ResultWithText]: ...
-
-    @overload
-    def search_and_contents(
-        self,
-        query: str,
-        *,
-        text: Union[TextContentsOptions, Literal[True]],
-        num_results: Optional[int] = None,
-        include_domains: Optional[List[str]] = None,
-        exclude_domains: Optional[List[str]] = None,
-        start_crawl_date: Optional[str] = None,
-        end_crawl_date: Optional[str] = None,
-        start_published_date: Optional[str] = None,
-        end_published_date: Optional[str] = None,
-        include_text: Optional[List[str]] = None,
-        exclude_text: Optional[List[str]] = None,
-        use_autoprompt: Optional[bool] = None,
-        type: Optional[str] = None,
-        category: Optional[str] = None,
-        flags: Optional[List[str]] = None,
-        moderation: Optional[bool] = None,
-        subpages: Optional[int] = None,
-        livecrawl_timeout: Optional[int] = None,
-        livecrawl: Optional[LIVECRAWL_OPTIONS] = None,
-        filter_empty_results: Optional[bool] = None,
-        subpage_target: Optional[Union[str, List[str]]] = None,
-        extras: Optional[ExtrasOptions] = None,
-    ) -> SearchResponse[ResultWithText]: ...
-
-    @overload
-    def search_and_contents(
-        self,
-        query: str,
-        *,
-        highlights: Union[HighlightsContentsOptions, Literal[True]],
-        num_results: Optional[int] = None,
-        include_domains: Optional[List[str]] = None,
-        exclude_domains: Optional[List[str]] = None,
-        start_crawl_date: Optional[str] = None,
-        end_crawl_date: Optional[str] = None,
-        start_published_date: Optional[str] = None,
-        end_published_date: Optional[str] = None,
-        include_text: Optional[List[str]] = None,
-        exclude_text: Optional[List[str]] = None,
-        use_autoprompt: Optional[bool] = None,
-        type: Optional[str] = None,
-        category: Optional[str] = None,
-        subpages: Optional[int] = None,
-        subpage_target: Optional[Union[str, List[str]]] = None,
-        flags: Optional[List[str]] = None,
-        moderation: Optional[bool] = None,
-        user_location: Optional[str] = None,
-        livecrawl_timeout: Optional[int] = None,
-        livecrawl: Optional[LIVECRAWL_OPTIONS] = None,
-        filter_empty_results: Optional[bool] = None,
-        extras: Optional[ExtrasOptions] = None,
-    ) -> SearchResponse[ResultWithHighlights]: ...
-
-    @overload
-    def search_and_contents(
-        self,
-        query: str,
-        *,
-        text: Union[TextContentsOptions, Literal[True]],
-        highlights: Union[HighlightsContentsOptions, Literal[True]],
-        num_results: Optional[int] = None,
-        include_domains: Optional[List[str]] = None,
-        exclude_domains: Optional[List[str]] = None,
-        start_crawl_date: Optional[str] = None,
-        end_crawl_date: Optional[str] = None,
-        start_published_date: Optional[str] = None,
-        end_published_date: Optional[str] = None,
-        include_text: Optional[List[str]] = None,
-        exclude_text: Optional[List[str]] = None,
-        use_autoprompt: Optional[bool] = None,
-        type: Optional[str] = None,
-        category: Optional[str] = None,
-        subpages: Optional[int] = None,
-        subpage_target: Optional[Union[str, List[str]]] = None,
-        flags: Optional[List[str]] = None,
-        moderation: Optional[bool] = None,
-        user_location: Optional[str] = None,
-        livecrawl_timeout: Optional[int] = None,
-        livecrawl: Optional[LIVECRAWL_OPTIONS] = None,
-        filter_empty_results: Optional[bool] = None,
-        extras: Optional[ExtrasOptions] = None,
-    ) -> SearchResponse[ResultWithTextAndHighlights]: ...
-
-    @overload
-    def search_and_contents(
-        self,
-        query: str,
-        *,
-        summary: Union[SummaryContentsOptions, Literal[True]],
-        num_results: Optional[int] = None,
-        include_domains: Optional[List[str]] = None,
-        exclude_domains: Optional[List[str]] = None,
-        start_crawl_date: Optional[str] = None,
-        end_crawl_date: Optional[str] = None,
-        start_published_date: Optional[str] = None,
-        end_published_date: Optional[str] = None,
-        include_text: Optional[List[str]] = None,
-        exclude_text: Optional[List[str]] = None,
-        use_autoprompt: Optional[bool] = None,
-        type: Optional[str] = None,
-        category: Optional[str] = None,
-        subpages: Optional[int] = None,
-        subpage_target: Optional[Union[str, List[str]]] = None,
-        flags: Optional[List[str]] = None,
-        moderation: Optional[bool] = None,
-        user_location: Optional[str] = None,
-        livecrawl_timeout: Optional[int] = None,
-        livecrawl: Optional[LIVECRAWL_OPTIONS] = None,
-        filter_empty_results: Optional[bool] = None,
-        extras: Optional[ExtrasOptions] = None,
-    ) -> SearchResponse[ResultWithSummary]: ...
-
-    @overload
-    def search_and_contents(
-        self,
-        query: str,
-        *,
-        text: Union[TextContentsOptions, Literal[True]],
-        summary: Union[SummaryContentsOptions, Literal[True]],
-        num_results: Optional[int] = None,
-        include_domains: Optional[List[str]] = None,
-        exclude_domains: Optional[List[str]] = None,
-        start_crawl_date: Optional[str] = None,
-        end_crawl_date: Optional[str] = None,
-        start_published_date: Optional[str] = None,
-        end_published_date: Optional[str] = None,
-        include_text: Optional[List[str]] = None,
-        exclude_text: Optional[List[str]] = None,
-        use_autoprompt: Optional[bool] = None,
-        type: Optional[str] = None,
-        category: Optional[str] = None,
-        subpages: Optional[int] = None,
-        subpage_target: Optional[Union[str, List[str]]] = None,
-        flags: Optional[List[str]] = None,
-        moderation: Optional[bool] = None,
-        user_location: Optional[str] = None,
-        livecrawl_timeout: Optional[int] = None,
-        livecrawl: Optional[LIVECRAWL_OPTIONS] = None,
-        filter_empty_results: Optional[bool] = None,
-        extras: Optional[ExtrasOptions] = None,
-    ) -> SearchResponse[ResultWithTextAndSummary]: ...
-
-    @overload
-    def search_and_contents(
-        self,
-        query: str,
-        *,
-        highlights: Union[HighlightsContentsOptions, Literal[True]],
-        summary: Union[SummaryContentsOptions, Literal[True]],
-        num_results: Optional[int] = None,
-        include_domains: Optional[List[str]] = None,
-        exclude_domains: Optional[List[str]] = None,
-        start_crawl_date: Optional[str] = None,
-        end_crawl_date: Optional[str] = None,
-        start_published_date: Optional[str] = None,
-        end_published_date: Optional[str] = None,
-        include_text: Optional[List[str]] = None,
-        exclude_text: Optional[List[str]] = None,
-        use_autoprompt: Optional[bool] = None,
-        type: Optional[str] = None,
-        category: Optional[str] = None,
-        subpages: Optional[int] = None,
-        subpage_target: Optional[Union[str, List[str]]] = None,
-        flags: Optional[List[str]] = None,
-        moderation: Optional[bool] = None,
-        user_location: Optional[str] = None,
-        livecrawl_timeout: Optional[int] = None,
-        livecrawl: Optional[LIVECRAWL_OPTIONS] = None,
-        filter_empty_results: Optional[bool] = None,
-        extras: Optional[ExtrasOptions] = None,
-    ) -> SearchResponse[ResultWithHighlightsAndSummary]: ...
+                    self.base_url + endpoint, data=json_data, headers=request_headers
+                )
+        elif method.upper() == "PATCH":
+            res = requests.patch(
+                self.base_url + endpoint, data=json_data, headers=request_headers
+            )
+        elif method.upper() == "DELETE":
+            res = requests.delete(self.base_url + endpoint, headers=request_headers)
+        else:
+            raise ValueError(f"Unsupported HTTP method: {method}")
 
-    @overload
-    def search_and_contents(
+        if res.status_code >= 400:
+            raise ValueError(
+                f"Request failed with status code {res.status_code}: {res.text}"
+            )
+        return res.json()
+
+    def search(
         self,
         query: str,
         *,
-        text: Union[TextContentsOptions, Literal[True]],
-        highlights: Union[HighlightsContentsOptions, Literal[True]],
-        summary: Union[SummaryContentsOptions, Literal[True]],
+        contents: Optional[Union[Dict, bool]] = None,
         num_results: Optional[int] = None,
         include_domains: Optional[List[str]] = None,
         exclude_domains: Optional[List[str]] = None,
@@ -1545,33 +1006,102 @@ class Exa:
         end_published_date: Optional[str] = None,
         include_text: Optional[List[str]] = None,
         exclude_text: Optional[List[str]] = None,
-        use_autoprompt: Optional[bool] = None,
         type: Optional[str] = None,
         category: Optional[str] = None,
         flags: Optional[List[str]] = None,
         moderation: Optional[bool] = None,
         user_location: Optional[str] = None,
-        livecrawl_timeout: Optional[int] = None,
-        livecrawl: Optional[LIVECRAWL_OPTIONS] = None,
-        subpages: Optional[int] = None,
-        subpage_target: Optional[Union[str, List[str]]] = None,
-        filter_empty_results: Optional[bool] = None,
-        extras: Optional[ExtrasOptions] = None,
-    ) -> SearchResponse[ResultWithTextAndHighlightsAndSummary]: ...
+    ) -> SearchResponse[Result]:
+        """Perform a search.
+
+        By default, returns text contents with 10,000 max characters. Use contents=False to opt-out.
+
+        Args:
+            query (str): The query string.
+            contents (dict | bool, optional): Options for retrieving page contents.
+                Defaults to {"text": {"maxCharacters": 10000}}. Use False to disable contents.
+            num_results (int, optional): Number of search results to return (default 10).
+            include_domains (List[str], optional): Domains to include in the search.
+            exclude_domains (List[str], optional): Domains to exclude from the search.
+            start_crawl_date (str, optional): Only links crawled after this date.
+            end_crawl_date (str, optional): Only links crawled before this date.
+            start_published_date (str, optional): Only links published after this date.
+            end_published_date (str, optional): Only links published before this date.
+            include_text (List[str], optional): Strings that must appear in the page text.
+            exclude_text (List[str], optional): Strings that must not appear in the page text.
+            type (str, optional): 'keyword', 'neural', 'hybrid', 'fast', 'deep', or 'auto' (default 'auto').
+            category (str, optional): e.g. 'company'
+            flags (List[str], optional): Experimental flags for Exa usage.
+            moderation (bool, optional): If True, the search results will be moderated for safety.
+            user_location (str, optional): Two-letter ISO country code of the user (e.g. US).
+
+        Returns:
+            SearchResponse: The response containing search results, etc.
+        """
+        options = {k: v for k, v in locals().items() if k != "self" and v is not None}
+
+        # Handle contents parameter with default behavior
+        if contents is False:
+            # Explicitly no contents - remove from options
+            options.pop("contents", None)
+        elif contents is None and "contents" not in options:
+            # No contents specified - add default text with 10,000 max characters
+            options["contents"] = {"text": {"max_characters": DEFAULT_MAX_CHARACTERS}}
+        elif contents is not None:
+            # User provided contents - use as-is
+            options["contents"] = contents
+
+        validate_search_options(options, SEARCH_OPTIONS_TYPES)
+        options = to_camel_case(options)
+        data = self.request("/search", options)
+        cost_dollars = parse_cost_dollars(data.get("costDollars"))
+        results = []
+        for result in data["results"]:
+            snake_result = to_snake_case(result)
+            results.append(
+                Result(
+                    url=snake_result.get("url"),
+                    id=snake_result.get("id"),
+                    title=snake_result.get("title"),
+                    score=snake_result.get("score"),
+                    published_date=snake_result.get("published_date"),
+                    author=snake_result.get("author"),
+                    image=snake_result.get("image"),
+                    favicon=snake_result.get("favicon"),
+                    subpages=snake_result.get("subpages"),
+                    extras=snake_result.get("extras"),
+                    text=snake_result.get("text"),
+                    summary=snake_result.get("summary"),
+                )
+            )
+        return SearchResponse(
+            results,
+            data["resolvedSearchType"] if "resolvedSearchType" in data else None,
+            data["autoDate"] if "autoDate" in data else None,
+            cost_dollars=cost_dollars,
+        )
 
     def search_and_contents(self, query: str, **kwargs):
+        """
+        DEPRECATED: Use search() instead. The search() method now returns text contents by default.
+
+        Migration:
+        - search_and_contents(query) → search(query)
+        - search_and_contents(query, text=True) → search(query, contents={"text": True})
+        - search_and_contents(query, summary=True) → search(query, contents={"summary": True})
+        """
+
         options = {"query": query}
         for k, v in kwargs.items():
             if v is not None:
                 options[k] = v
-        # If user didn't ask for any particular content, default to text
+        # If user didn't ask for any particular content, default to text with max characters
         if (
             "text" not in options
-            and "highlights" not in options
             and "summary" not in options
             and "extras" not in options
         ):
-            options["text"] = True
+            options["text"] = {"max_characters": DEFAULT_MAX_CHARACTERS}
 
         merged_options = {}
         merged_options.update(SEARCH_OPTIONS_TYPES)
@@ -1590,7 +1120,6 @@ class Exa:
             options,
             [
                 "text",
-                "highlights",
                 "summary",
                 "context",
                 "subpages",
@@ -1620,16 +1149,13 @@ class Exa:
                     subpages=snake_result.get("subpages"),
                     extras=snake_result.get("extras"),
                     text=snake_result.get("text"),
-                    highlights=snake_result.get("highlights"),
-                    highlight_scores=snake_result.get("highlight_scores"),
                     summary=snake_result.get("summary"),
                 )
             )
         return SearchResponse(
             results,
-            data["autopromptString"] if "autopromptString" in data else None,
-            data["resolvedSearchType"] if "resolvedSearchType" in data else None,
-            data["autoDate"] if "autoDate" in data else None,
+            data.get("resolvedSearchType"),
+            data.get("autoDate"),
             context=data.get("context"),
             cost_dollars=cost_dollars,
         )
@@ -1662,37 +1188,6 @@ class Exa:
         flags: Optional[List[str]] = None,
     ) -> SearchResponse[ResultWithText]: ...
 
-    @overload
-    def get_contents(
-        self,
-        urls: Union[str, List[str], List[_Result]],
-        *,
-        highlights: Union[HighlightsContentsOptions, Literal[True]],
-        livecrawl_timeout: Optional[int] = None,
-        livecrawl: Optional[LIVECRAWL_OPTIONS] = None,
-        filter_empty_results: Optional[bool] = None,
-        subpages: Optional[int] = None,
-        subpage_target: Optional[Union[str, List[str]]] = None,
-        extras: Optional[ExtrasOptions] = None,
-        flags: Optional[List[str]] = None,
-    ) -> SearchResponse[ResultWithHighlights]: ...
-
-    @overload
-    def get_contents(
-        self,
-        urls: Union[str, List[str], List[_Result]],
-        *,
-        text: Union[TextContentsOptions, Literal[True]],
-        highlights: Union[HighlightsContentsOptions, Literal[True]],
-        livecrawl_timeout: Optional[int] = None,
-        livecrawl: Optional[LIVECRAWL_OPTIONS] = None,
-        filter_empty_results: Optional[bool] = None,
-        subpages: Optional[int] = None,
-        subpage_target: Optional[Union[str, List[str]]] = None,
-        extras: Optional[ExtrasOptions] = None,
-        flags: Optional[List[str]] = None,
-    ) -> SearchResponse[ResultWithTextAndHighlights]: ...
-
     @overload
     def get_contents(
         self,
@@ -1724,40 +1219,14 @@ class Exa:
         flags: Optional[List[str]] = None,
     ) -> SearchResponse[ResultWithTextAndSummary]: ...
 
-    @overload
-    def get_contents(
-        self,
-        urls: Union[str, List[str], List[_Result]],
-        *,
-        highlights: Union[HighlightsContentsOptions, Literal[True]],
-        summary: Union[SummaryContentsOptions, Literal[True]],
-        livecrawl_timeout: Optional[int] = None,
-        livecrawl: Optional[LIVECRAWL_OPTIONS] = None,
-        filter_empty_results: Optional[bool] = None,
-        subpages: Optional[int] = None,
-        subpage_target: Optional[Union[str, List[str]]] = None,
-        extras: Optional[ExtrasOptions] = None,
-        flags: Optional[List[str]] = None,
-    ) -> SearchResponse[ResultWithHighlightsAndSummary]: ...
-
-    @overload
-    def get_contents(
-        self,
-        urls: Union[str, List[str], List[_Result]],
-        *,
-        text: Union[TextContentsOptions, Literal[True]],
-        highlights: Union[HighlightsContentsOptions, Literal[True]],
-        summary: Union[SummaryContentsOptions, Literal[True]],
-        livecrawl_timeout: Optional[int] = None,
-        livecrawl: Optional[LIVECRAWL_OPTIONS] = None,
-        filter_empty_results: Optional[bool] = None,
-        subpages: Optional[int] = None,
-        subpage_target: Optional[Union[str, List[str]]] = None,
-        extras: Optional[ExtrasOptions] = None,
-        flags: Optional[List[str]] = None,
-    ) -> SearchResponse[ResultWithTextAndHighlightsAndSummary]: ...
-
     def get_contents(self, urls: Union[str, List[str], List[_Result]], **kwargs):
+        # Normalize urls to always be a list
+        if isinstance(urls, str):
+            urls = [urls]
+        elif isinstance(urls, list) and len(urls) > 0 and isinstance(urls[0], _Result):
+            # Extract URLs from Result objects
+            urls = [r.url for r in urls]
+
         options = {"urls": urls}
         for k, v in kwargs.items():
             if k != "self" and v is not None:
@@ -1765,11 +1234,10 @@ class Exa:
 
         if (
             "text" not in options
-            and "highlights" not in options
             and "summary" not in options
             and "extras" not in options
         ):
-            options["text"] = True
+            options["text"] = {"max_characters": DEFAULT_MAX_CHARACTERS}
 
         merged_options = {}
         merged_options.update(CONTENTS_OPTIONS_TYPES)
@@ -1810,14 +1278,11 @@ class Exa:
                     subpages=snake_result.get("subpages"),
                     extras=snake_result.get("extras"),
                     text=snake_result.get("text"),
-                    highlights=snake_result.get("highlights"),
-                    highlight_scores=snake_result.get("highlight_scores"),
                     summary=snake_result.get("summary"),
                 )
             )
         return SearchResponse(
             results,
-            data.get("autopromptString"),
             data.get("resolvedSearchType"),
             data.get("autoDate"),
             context=data.get("context"),
@@ -1829,6 +1294,7 @@ class Exa:
         self,
         url: str,
         *,
+        contents: Optional[Union[Dict, bool]] = None,
         num_results: Optional[int] = None,
         include_domains: Optional[List[str]] = None,
         exclude_domains: Optional[List[str]] = None,
@@ -1841,11 +1307,15 @@ class Exa:
         exclude_source_domain: Optional[bool] = None,
         category: Optional[str] = None,
         flags: Optional[List[str]] = None,
-    ) -> SearchResponse[_Result]:
+    ) -> SearchResponse[Result]:
         """Finds similar pages to a given URL, potentially with domain filters and date filters.
 
+        By default, returns text contents with 10,000 max characters. Use contents=False to opt-out.
+
         Args:
             url (str): The URL to find similar pages for.
+            contents (dict | bool, optional): Options for retrieving page contents.
+                Defaults to {"text": {"maxCharacters": 10000}}. Use False to disable contents.
             num_results (int, optional): Number of results to return. Default is None (server default).
             include_domains (List[str], optional): Domains to include in the search.
             exclude_domains (List[str], optional): Domains to exclude from the search.
@@ -1860,9 +1330,21 @@ class Exa:
             flags (List[str], optional): Experimental flags.
 
         Returns:
-            SearchResponse[_Result]
+            SearchResponse[Result]
         """
         options = {k: v for k, v in locals().items() if k != "self" and v is not None}
+
+        # Handle contents parameter with default behavior
+        if contents is False:
+            # Explicitly no contents - remove from options
+            options.pop("contents", None)
+        elif contents is None and "contents" not in options:
+            # No contents specified - add default text with 10,000 max characters
+            options["contents"] = {"text": {"max_characters": DEFAULT_MAX_CHARACTERS}}
+        elif contents is not None:
+            # User provided contents - use as-is
+            options["contents"] = contents
+
         validate_search_options(options, FIND_SIMILAR_OPTIONS_TYPES)
         options = to_camel_case(options)
         data = self.request("/findSimilar", options)
@@ -1883,14 +1365,11 @@ class Exa:
                     subpages=snake_result.get("subpages"),
                     extras=snake_result.get("extras"),
                     text=snake_result.get("text"),
-                    highlights=snake_result.get("highlights"),
-                    highlight_scores=snake_result.get("highlight_scores"),
                     summary=snake_result.get("summary"),
                 )
             )
         return SearchResponse(
             results,
-            data.get("autopromptString"),
             data.get("resolvedSearchType"),
             data.get("autoDate"),
             cost_dollars=cost_dollars,
@@ -1947,39 +1426,12 @@ class Exa:
         extras: Optional[ExtrasOptions] = None,
     ) -> SearchResponse[ResultWithText]: ...
 
-    @overload
-    def find_similar_and_contents(
-        self,
-        url: str,
-        *,
-        highlights: Union[HighlightsContentsOptions, Literal[True]],
-        num_results: Optional[int] = None,
-        include_domains: Optional[List[str]] = None,
-        exclude_domains: Optional[List[str]] = None,
-        start_crawl_date: Optional[str] = None,
-        end_crawl_date: Optional[str] = None,
-        start_published_date: Optional[str] = None,
-        end_published_date: Optional[str] = None,
-        include_text: Optional[List[str]] = None,
-        exclude_text: Optional[List[str]] = None,
-        exclude_source_domain: Optional[bool] = None,
-        category: Optional[str] = None,
-        flags: Optional[List[str]] = None,
-        subpages: Optional[int] = None,
-        subpage_target: Optional[Union[str, List[str]]] = None,
-        livecrawl_timeout: Optional[int] = None,
-        livecrawl: Optional[LIVECRAWL_OPTIONS] = None,
-        filter_empty_results: Optional[bool] = None,
-        extras: Optional[ExtrasOptions] = None,
-    ) -> SearchResponse[ResultWithHighlights]: ...
-
     @overload
     def find_similar_and_contents(
         self,
         url: str,
         *,
         text: Union[TextContentsOptions, Literal[True]],
-        highlights: Union[HighlightsContentsOptions, Literal[True]],
         num_results: Optional[int] = None,
         include_domains: Optional[List[str]] = None,
         exclude_domains: Optional[List[str]] = None,
@@ -1998,7 +1450,7 @@ class Exa:
         subpages: Optional[int] = None,
         subpage_target: Optional[Union[str, List[str]]] = None,
         extras: Optional[ExtrasOptions] = None,
-    ) -> SearchResponse[ResultWithTextAndHighlights]: ...
+    ) -> SearchResponse[ResultWithText]: ...
 
     @overload
     def find_similar_and_contents(
@@ -2053,73 +1505,23 @@ class Exa:
         extras: Optional[ExtrasOptions] = None,
     ) -> SearchResponse[ResultWithTextAndSummary]: ...
 
-    @overload
-    def find_similar_and_contents(
-        self,
-        url: str,
-        *,
-        highlights: Union[HighlightsContentsOptions, Literal[True]],
-        summary: Union[SummaryContentsOptions, Literal[True]],
-        num_results: Optional[int] = None,
-        include_domains: Optional[List[str]] = None,
-        exclude_domains: Optional[List[str]] = None,
-        start_crawl_date: Optional[str] = None,
-        end_crawl_date: Optional[str] = None,
-        start_published_date: Optional[str] = None,
-        end_published_date: Optional[str] = None,
-        include_text: Optional[List[str]] = None,
-        exclude_text: Optional[List[str]] = None,
-        exclude_source_domain: Optional[bool] = None,
-        category: Optional[str] = None,
-        flags: Optional[List[str]] = None,
-        subpages: Optional[int] = None,
-        subpage_target: Optional[Union[str, List[str]]] = None,
-        livecrawl_timeout: Optional[int] = None,
-        livecrawl: Optional[LIVECRAWL_OPTIONS] = None,
-        filter_empty_results: Optional[bool] = None,
-        extras: Optional[ExtrasOptions] = None,
-    ) -> SearchResponse[ResultWithHighlightsAndSummary]: ...
+    def find_similar_and_contents(self, url: str, **kwargs):
+        """
+        DEPRECATED: Use find_similar() instead. The find_similar() method now returns text contents by default.
 
-    @overload
-    def find_similar_and_contents(
-        self,
-        url: str,
-        *,
-        text: Union[TextContentsOptions, Literal[True]],
-        highlights: Union[HighlightsContentsOptions, Literal[True]],
-        summary: Union[SummaryContentsOptions, Literal[True]],
-        num_results: Optional[int] = None,
-        include_domains: Optional[List[str]] = None,
-        exclude_domains: Optional[List[str]] = None,
-        start_crawl_date: Optional[str] = None,
-        end_crawl_date: Optional[str] = None,
-        start_published_date: Optional[str] = None,
-        end_published_date: Optional[str] = None,
-        include_text: Optional[List[str]] = None,
-        exclude_text: Optional[List[str]] = None,
-        exclude_source_domain: Optional[bool] = None,
-        category: Optional[str] = None,
-        flags: Optional[List[str]] = None,
-        livecrawl_timeout: Optional[int] = None,
-        livecrawl: Optional[LIVECRAWL_OPTIONS] = None,
-        filter_empty_results: Optional[bool] = None,
-        subpages: Optional[int] = None,
-        subpage_target: Optional[Union[str, List[str]]] = None,
-        extras: Optional[ExtrasOptions] = None,
-    ) -> SearchResponse[ResultWithTextAndHighlightsAndSummary]: ...
+        Migration:
+        - find_similar_and_contents(url) → find_similar(url)
+        - find_similar_and_contents(url, text=True) → find_similar(url, contents={"text": True})
+        - find_similar_and_contents(url, summary=True) → find_similar(url, contents={"summary": True})
+        """
 
-    def find_similar_and_contents(self, url: str, **kwargs):
         options = {"url": url}
         for k, v in kwargs.items():
             if v is not None:
                 options[k] = v
-        # Default to text if none specified
-        if (
-            "text" not in options
-            and "highlights" not in options
-            and "summary" not in options
-        ):
-            options["text"] = True
+        # Default to text with max characters if none specified
+        if "text" not in options and "summary" not in options:
+            options["text"] = {"max_characters": DEFAULT_MAX_CHARACTERS}
 
         merged_options = {}
         merged_options.update(FIND_SIMILAR_OPTIONS_TYPES)
@@ -2138,7 +1540,6 @@ class Exa:
             options,
             [
                 "text",
-                "highlights",
                 "summary",
                 "context",
                 "subpages",
@@ -2168,14 +1569,11 @@ class Exa:
                     subpages=snake_result.get("subpages"),
                     extras=snake_result.get("extras"),
                     text=snake_result.get("text"),
-                    highlights=snake_result.get("highlights"),
-                    highlight_scores=snake_result.get("highlight_scores"),
                     summary=snake_result.get("summary"),
                 )
             )
         return SearchResponse(
             results,
-            data.get("autopromptString"),
             data.get("resolvedSearchType"),
             data.get("autoDate"),
             context=data.get("context"),
@@ -2205,7 +1603,6 @@ class Exa:
             model: Union[str, ChatModel],
             # Exa args
             use_exa: Optional[Literal["required", "none", "auto"]] = "auto",
-            highlights: Union[HighlightsContentsOptions, Literal[True], None] = None,
             num_results: Optional[int] = 3,
             include_domains: Optional[List[str]] = None,
             exclude_domains: Optional[List[str]] = None,
@@ -2215,7 +1612,6 @@ class Exa:
             end_published_date: Optional[str] = None,
             include_text: Optional[List[str]] = None,
             exclude_text: Optional[List[str]] = None,
-            use_autoprompt: Optional[bool] = True,
             type: Optional[str] = None,
             category: Optional[str] = None,
             result_max_len: int = 2048,
@@ -2227,14 +1623,12 @@ class Exa:
                 "num_results": num_results,
                 "include_domains": include_domains,
                 "exclude_domains": exclude_domains,
-                "highlights": highlights,
                 "start_crawl_date": start_crawl_date,
                 "end_crawl_date": end_crawl_date,
                 "start_published_date": start_published_date,
                 "end_published_date": end_published_date,
                 "include_text": include_text,
                 "exclude_text": exclude_text,
-                "use_autoprompt": use_autoprompt,
                 "type": type,
                 "category": category,
                 "flags": flags,
@@ -2301,14 +1695,12 @@ class Exa:
             num_results=exa_kwargs.get("num_results"),
             include_domains=exa_kwargs.get("include_domains"),
             exclude_domains=exa_kwargs.get("exclude_domains"),
-            highlights=exa_kwargs.get("highlights"),
             start_crawl_date=exa_kwargs.get("start_crawl_date"),
             end_crawl_date=exa_kwargs.get("end_crawl_date"),
             start_published_date=exa_kwargs.get("start_published_date"),
             end_published_date=exa_kwargs.get("end_published_date"),
             include_text=exa_kwargs.get("include_text"),
             exclude_text=exa_kwargs.get("exclude_text"),
-            use_autoprompt=exa_kwargs.get("use_autoprompt"),
             type=exa_kwargs.get("type"),
             category=exa_kwargs.get("category"),
             flags=exa_kwargs.get("flags"),
@@ -2512,6 +1904,7 @@ class AsyncExa(Exa):
         self,
         query: str,
         *,
+        contents: Optional[Union[Dict, bool]] = None,
         num_results: Optional[int] = None,
         include_domains: Optional[List[str]] = None,
         exclude_domains: Optional[List[str]] = None,
@@ -2521,17 +1914,20 @@ class AsyncExa(Exa):
         end_published_date: Optional[str] = None,
         include_text: Optional[List[str]] = None,
         exclude_text: Optional[List[str]] = None,
-        use_autoprompt: Optional[bool] = None,
         type: Optional[str] = None,
         category: Optional[str] = None,
         flags: Optional[List[str]] = None,
         moderation: Optional[bool] = None,
         user_location: Optional[str] = None,
-    ) -> SearchResponse[_Result]:
+    ) -> SearchResponse[Result]:
         """Perform a search with a prompt-engineered query to retrieve relevant results.
 
+        By default, returns text contents with 10,000 max characters. Use contents=False to opt-out.
+
         Args:
             query (str): The query string.
+            contents (dict | bool, optional): Options for retrieving page contents.
+                Defaults to {"text": {"maxCharacters": 10000}}. Use False to disable contents.
             num_results (int, optional): Number of search results to return (default 10).
             include_domains (List[str], optional): Domains to include in the search.
             exclude_domains (List[str], optional): Domains to exclude from the search.
@@ -2541,7 +1937,6 @@ class AsyncExa(Exa):
             end_published_date (str, optional): Only links published before this date.
             include_text (List[str], optional): Strings that must appear in the page text.
             exclude_text (List[str], optional): Strings that must not appear in the page text.
-            use_autoprompt (bool, optional): Convert query to Exa (default False).
             type (str, optional): 'keyword', 'neural', 'hybrid', 'fast', 'deep', or 'auto' (default 'auto').
             category (str, optional): e.g. 'company'
             flags (List[str], optional): Experimental flags for Exa usage.
@@ -2552,6 +1947,18 @@ class AsyncExa(Exa):
             SearchResponse: The response containing search results, etc.
         """
         options = {k: v for k, v in locals().items() if k != "self" and v is not None}
+
+        # Handle contents parameter with default behavior
+        if contents is False:
+            # Explicitly no contents - remove from options
+            options.pop("contents", None)
+        elif contents is None and "contents" not in options:
+            # No contents specified - add default text with 10,000 max characters
+            options["contents"] = {"text": {"max_characters": DEFAULT_MAX_CHARACTERS}}
+        elif contents is not None:
+            # User provided contents - use as-is
+            options["contents"] = contents
+
         validate_search_options(options, SEARCH_OPTIONS_TYPES)
         options = to_camel_case(options)
         data = await self.async_request("/search", options)
@@ -2572,32 +1979,37 @@ class AsyncExa(Exa):
                     subpages=snake_result.get("subpages"),
                     extras=snake_result.get("extras"),
                     text=snake_result.get("text"),
-                    highlights=snake_result.get("highlights"),
-                    highlight_scores=snake_result.get("highlight_scores"),
                     summary=snake_result.get("summary"),
                 )
             )
         return SearchResponse(
             results,
-            data["autopromptString"] if "autopromptString" in data else None,
-            data["resolvedSearchType"] if "resolvedSearchType" in data else None,
-            data["autoDate"] if "autoDate" in data else None,
+            data.get("resolvedSearchType"),
+            data.get("autoDate"),
             cost_dollars=cost_dollars,
         )
 
     async def search_and_contents(self, query: str, **kwargs):
+        """
+        DEPRECATED: Use search() instead. The search() method now returns text contents by default.
+
+        Migration:
+        - search_and_contents(query) → search(query)
+        - search_and_contents(query, text=True) → search(query, contents={"text": True})
+        - search_and_contents(query, summary=True) → search(query, contents={"summary": True})
+        """
+
         options = {"query": query}
         for k, v in kwargs.items():
             if v is not None:
                 options[k] = v
-        # If user didn't ask for any particular content, default to text
+        # If user didn't ask for any particular content, default to text with max characters
         if (
             "text" not in options
-            and "highlights" not in options
             and "summary" not in options
             and "extras" not in options
         ):
-            options["text"] = True
+            options["text"] = {"max_characters": DEFAULT_MAX_CHARACTERS}
 
         merged_options = {}
         merged_options.update(SEARCH_OPTIONS_TYPES)
@@ -2616,7 +2028,6 @@ class AsyncExa(Exa):
             options,
             [
                 "text",
-                "highlights",
                 "summary",
                 "context",
                 "subpages",
@@ -2646,21 +2057,25 @@ class AsyncExa(Exa):
                     subpages=snake_result.get("subpages"),
                     extras=snake_result.get("extras"),
                     text=snake_result.get("text"),
-                    highlights=snake_result.get("highlights"),
-                    highlight_scores=snake_result.get("highlight_scores"),
                     summary=snake_result.get("summary"),
                 )
             )
         return SearchResponse(
             results,
-            data["autopromptString"] if "autopromptString" in data else None,
-            data["resolvedSearchType"] if "resolvedSearchType" in data else None,
-            data["autoDate"] if "autoDate" in data else None,
+            data.get("resolvedSearchType"),
+            data.get("autoDate"),
             context=data.get("context"),
             cost_dollars=cost_dollars,
         )
 
     async def get_contents(self, urls: Union[str, List[str], List[_Result]], **kwargs):
+        # Normalize urls to always be a list
+        if isinstance(urls, str):
+            urls = [urls]
+        elif isinstance(urls, list) and len(urls) > 0 and isinstance(urls[0], _Result):
+            # Extract URLs from Result objects
+            urls = [r.url for r in urls]
+
         options = {"urls": urls}
         for k, v in kwargs.items():
             if k != "self" and v is not None:
@@ -2668,11 +2083,10 @@ class AsyncExa(Exa):
 
         if (
             "text" not in options
-            and "highlights" not in options
             and "summary" not in options
             and "extras" not in options
         ):
-            options["text"] = True
+            options["text"] = {"max_characters": DEFAULT_MAX_CHARACTERS}
 
         merged_options = {}
         merged_options.update(CONTENTS_OPTIONS_TYPES)
@@ -2713,14 +2127,11 @@ class AsyncExa(Exa):
                     subpages=snake_result.get("subpages"),
                     extras=snake_result.get("extras"),
                     text=snake_result.get("text"),
-                    highlights=snake_result.get("highlights"),
-                    highlight_scores=snake_result.get("highlight_scores"),
                     summary=snake_result.get("summary"),
                 )
             )
         return SearchResponse(
             results,
-            data.get("autopromptString"),
             data.get("resolvedSearchType"),
             data.get("autoDate"),
             context=data.get("context"),
@@ -2732,6 +2143,7 @@ class AsyncExa(Exa):
         self,
         url: str,
         *,
+        contents: Optional[Union[Dict, bool]] = None,
         num_results: Optional[int] = None,
         include_domains: Optional[List[str]] = None,
         exclude_domains: Optional[List[str]] = None,
@@ -2744,11 +2156,15 @@ class AsyncExa(Exa):
         exclude_source_domain: Optional[bool] = None,
         category: Optional[str] = None,
         flags: Optional[List[str]] = None,
-    ) -> SearchResponse[_Result]:
+    ) -> SearchResponse[Result]:
         """Finds similar pages to a given URL, potentially with domain filters and date filters.
 
+        By default, returns text contents with 10,000 max characters. Use contents=False to opt-out.
+
         Args:
             url (str): The URL to find similar pages for.
+            contents (dict | bool, optional): Options for retrieving page contents.
+                Defaults to {"text": {"maxCharacters": 10000}}. Use False to disable contents.
             num_results (int, optional): Number of results to return. Default is None (server default).
             include_domains (List[str], optional): Domains to include in the search.
             exclude_domains (List[str], optional): Domains to exclude from the search.
@@ -2763,9 +2179,21 @@ class AsyncExa(Exa):
             flags (List[str], optional): Experimental flags.
 
         Returns:
-            SearchResponse[_Result]
+            SearchResponse[Result]
         """
         options = {k: v for k, v in locals().items() if k != "self" and v is not None}
+
+        # Handle contents parameter with default behavior
+        if contents is False:
+            # Explicitly no contents - remove from options
+            options.pop("contents", None)
+        elif contents is None and "contents" not in options:
+            # No contents specified - add default text with 10,000 max characters
+            options["contents"] = {"text": {"max_characters": DEFAULT_MAX_CHARACTERS}}
+        elif contents is not None:
+            # User provided contents - use as-is
+            options["contents"] = contents
+
         validate_search_options(options, FIND_SIMILAR_OPTIONS_TYPES)
         options = to_camel_case(options)
         data = await self.async_request("/findSimilar", options)
@@ -2786,31 +2214,32 @@ class AsyncExa(Exa):
                     subpages=snake_result.get("subpages"),
                     extras=snake_result.get("extras"),
                     text=snake_result.get("text"),
-                    highlights=snake_result.get("highlights"),
-                    highlight_scores=snake_result.get("highlight_scores"),
                     summary=snake_result.get("summary"),
                 )
             )
         return SearchResponse(
             results,
-            data.get("autopromptString"),
             data.get("resolvedSearchType"),
             data.get("autoDate"),
             cost_dollars=cost_dollars,
         )
 
     async def find_similar_and_contents(self, url: str, **kwargs):
+        """
+        DEPRECATED: Use find_similar() instead. The find_similar() method now returns text contents by default.
+
+        Migration:
+        - find_similar_and_contents(url) → find_similar(url)
+        - find_similar_and_contents(url, text=True) → find_similar(url, contents={"text": True})
+        - find_similar_and_contents(url, summary=True) → find_similar(url, contents={"summary": True})
+        """
         options = {"url": url}
         for k, v in kwargs.items():
             if v is not None:
                 options[k] = v
-        # Default to text if none specified
-        if (
-            "text" not in options
-            and "highlights" not in options
-            and "summary" not in options
-        ):
-            options["text"] = True
+        # Default to text with max characters if none specified
+        if "text" not in options and "summary" not in options:
+            options["text"] = {"max_characters": DEFAULT_MAX_CHARACTERS}
 
         merged_options = {}
         merged_options.update(FIND_SIMILAR_OPTIONS_TYPES)
@@ -2829,7 +2258,6 @@ class AsyncExa(Exa):
             options,
             [
                 "text",
-                "highlights",
                 "summary",
                 "context",
                 "subpages",
@@ -2859,14 +2287,11 @@ class AsyncExa(Exa):
                     subpages=snake_result.get("subpages"),
                     extras=snake_result.get("extras"),
                     text=snake_result.get("text"),
-                    highlights=snake_result.get("highlights"),
-                    highlight_scores=snake_result.get("highlight_scores"),
                     summary=snake_result.get("summary"),
                 )
             )
         return SearchResponse(
             results,
-            data.get("autopromptString"),
             data.get("resolvedSearchType"),
             data.get("autoDate"),
             context=data.get("context"),