crawlora 1.5.0.dev3__tar.gz → 1.6.0.dev1__tar.gz

{crawlora-1.5.0.dev3/crawlora.egg-info → crawlora-1.6.0.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crawlora
-Version: 1.5.0.dev3
+Version: 1.6.0.dev1
 Summary: Official Python SDK for the Crawlora web-scraping API: typed grouped and dynamic operation calls for every public endpoint, with retries, pagination, hooks, and an async client.
 Author: Crawlora
 License-Expression: MIT
@@ -27,8 +27,8 @@ Dynamic: license-file
 # Crawlora Python SDK
 
 Python client for the public Crawlora API. Use it to call Crawlora scraping,
-search, marketplace, media, maps, finance, and usage endpoints with generated
-type stubs for editor and type-checker support.
+search, social, marketplace, media, maps, finance, brand, and usage endpoints
+with generated type stubs for editor and type-checker support.
 
 - Runtime: Python 3.10+
 - Auth: `x-api-key`

{crawlora-1.5.0.dev3 → crawlora-1.6.0.dev1}/README.md

@@ -1,8 +1,8 @@
 # Crawlora Python SDK
 
 Python client for the public Crawlora API. Use it to call Crawlora scraping,
-search, marketplace, media, maps, finance, and usage endpoints with generated
-type stubs for editor and type-checker support.
+search, social, marketplace, media, maps, finance, brand, and usage endpoints
+with generated type stubs for editor and type-checker support.
 
 - Runtime: Python 3.10+
 - Auth: `x-api-key`

{crawlora-1.5.0.dev3 → crawlora-1.6.0.dev1}/crawlora/client.py

@@ -20,7 +20,7 @@ from ._transport_sync import KeepAliveTransport
 from .operations import GROUPS, OPERATIONS
 
 DEFAULT_BASE_URL = "https://api.crawlora.net/api/v1"
-VERSION = "1.5.0-sdk.3"
+VERSION = "1.6.0-sdk.1"
 DEFAULT_USER_AGENT = f"crawlora-python-sdk/{VERSION}"
 DEFAULT_MAX_RETRY_DELAY = 30.0
 DEFAULT_RETRY_STATUSES = (408, 409, 425, 429)

{crawlora-1.5.0.dev3 → crawlora-1.6.0.dev1}/crawlora/client.pyi

@@ -968,6 +968,100 @@ ModelBingVideosResponseDoc = TypedDict('ModelBingVideosResponseDoc', {
     'msg': NotRequired[str],
 }, total=False)
 
+ModelBrandAddress = TypedDict('ModelBrandAddress', {
+    'city': NotRequired[str],
+    'country': NotRequired[str],
+    'country_code': NotRequired[str],
+    'postal_code': NotRequired[str],
+    'state_code': NotRequired[str],
+    'state_province': NotRequired[str],
+    'street': NotRequired[str],
+}, total=False)
+
+ModelBrandBackdrop = TypedDict('ModelBrandBackdrop', {
+    'colors': NotRequired[list[ModelBrandColor]],
+    'resolution': NotRequired[ModelBrandResolution],
+    'url': NotRequired[str],
+}, total=False)
+
+ModelBrandBrandResponse = TypedDict('ModelBrandBrandResponse', {
+    'address': NotRequired[ModelBrandAddress],
+    'backdrops': NotRequired[list[ModelBrandBackdrop]],
+    'colors': NotRequired[list[ModelBrandColor]],
+    'description': NotRequired[str],
+    'domain': NotRequired[str],
+    'email': NotRequired[str],
+    'industries': NotRequired[ModelBrandIndustries],
+    'is_nsfw': NotRequired[bool],
+    'links': NotRequired[ModelBrandLinks],
+    'logos': NotRequired[list[ModelBrandLogo]],
+    'phone': NotRequired[str],
+    'primary_language': NotRequired[str],
+    'slogan': NotRequired[str],
+    'socials': NotRequired[list[ModelBrandSocial]],
+    'source': NotRequired[ModelBrandSourceDetail],
+    'stock': NotRequired[ModelBrandStock],
+    'title': NotRequired[str],
+}, total=False)
+
+ModelBrandColor = TypedDict('ModelBrandColor', {
+    'hex': NotRequired[str],
+    'name': NotRequired[str],
+}, total=False)
+
+ModelBrandEic = TypedDict('ModelBrandEic', {
+    'industry': NotRequired[str],
+    'subindustry': NotRequired[str],
+}, total=False)
+
+ModelBrandIndustries = TypedDict('ModelBrandIndustries', {
+    'eic': NotRequired[list[ModelBrandEic]],
+}, total=False)
+
+ModelBrandLinks = TypedDict('ModelBrandLinks', {
+    'blog': NotRequired[str],
+    'careers': NotRequired[str],
+    'contact': NotRequired[str],
+    'pricing': NotRequired[str],
+    'privacy': NotRequired[str],
+    'terms': NotRequired[str],
+}, total=False)
+
+ModelBrandLogo = TypedDict('ModelBrandLogo', {
+    'colors': NotRequired[list[ModelBrandColor]],
+    'mode': NotRequired[str],
+    'resolution': NotRequired[ModelBrandResolution],
+    'type': NotRequired[str],
+    'url': NotRequired[str],
+}, total=False)
+
+ModelBrandResolution = TypedDict('ModelBrandResolution', {
+    'aspect_ratio': NotRequired[float],
+    'height': NotRequired[int],
+    'width': NotRequired[int],
+}, total=False)
+
+ModelBrandSocial = TypedDict('ModelBrandSocial', {
+    'type': NotRequired[str],
+    'url': NotRequired[str],
+}, total=False)
+
+ModelBrandSourceDetail = TypedDict('ModelBrandSourceDetail', {
+    'type': NotRequired[str],
+    'url': NotRequired[str],
+}, total=False)
+
+ModelBrandStock = TypedDict('ModelBrandStock', {
+    'exchange': NotRequired[str],
+    'ticker': NotRequired[str],
+}, total=False)
+
+ModelBrandRetrieveResponseDoc = TypedDict('ModelBrandRetrieveResponseDoc', {
+    'code': NotRequired[int],
+    'data': NotRequired[ModelBrandBrandResponse],
+    'msg': NotRequired[str],
+}, total=False)
+
 ModelBraveDiscussion = TypedDict('ModelBraveDiscussion', {
     'age': NotRequired[str],
     'comment_count': NotRequired[int],
@@ -4811,6 +4905,114 @@ ModelProducthuntSearchTopicDoc = TypedDict('ModelProducthuntSearchTopicDoc', {
     'topic': NotRequired[dict[str, Any]],
 }, total=False)
 
+ModelRedditAuthor = TypedDict('ModelRedditAuthor', {
+    'name': NotRequired[str],
+    'profile_url': NotRequired[str],
+}, total=False)
+
+ModelRedditComment = TypedDict('ModelRedditComment', {
+    'author': NotRequired[ModelRedditAuthor],
+    'body': NotRequired[str],
+    'created': NotRequired[str],
+    'created_utc': NotRequired[int],
+    'depth': NotRequired[int],
+    'id': NotRequired[str],
+    'name': NotRequired[str],
+    'parent_id': NotRequired[str],
+    'permalink': NotRequired[str],
+    'replies': NotRequired[list[ModelRedditComment]],
+    'score': NotRequired[int],
+}, total=False)
+
+ModelRedditCommentsResponse = TypedDict('ModelRedditCommentsResponse', {
+    'comments': NotRequired[list[ModelRedditComment]],
+    'post': NotRequired[ModelRedditPost],
+    'source': NotRequired[ModelRedditSourceDetail],
+}, total=False)
+
+ModelRedditPagination = TypedDict('ModelRedditPagination', {
+    'after': NotRequired[str],
+    'limit': NotRequired[int],
+}, total=False)
+
+ModelRedditPost = TypedDict('ModelRedditPost', {
+    'author': NotRequired[ModelRedditAuthor],
+    'comment_count': NotRequired[int],
+    'created': NotRequired[str],
+    'created_utc': NotRequired[int],
+    'domain': NotRequired[str],
+    'flair': NotRequired[str],
+    'id': NotRequired[str],
+    'is_self': NotRequired[bool],
+    'is_video': NotRequired[bool],
+    'locked': NotRequired[bool],
+    'name': NotRequired[str],
+    'over_18': NotRequired[bool],
+    'permalink': NotRequired[str],
+    'score': NotRequired[int],
+    'selftext': NotRequired[str],
+    'source_feed_url': NotRequired[str],
+    'stickied': NotRequired[bool],
+    'subreddit': NotRequired[str],
+    'thumbnail': NotRequired[str],
+    'title': NotRequired[str],
+    'upvote_ratio': NotRequired[float],
+    'url': NotRequired[str],
+}, total=False)
+
+ModelRedditPostResponse = TypedDict('ModelRedditPostResponse', {
+    'post': NotRequired[ModelRedditPost],
+    'source': NotRequired[ModelRedditSourceDetail],
+}, total=False)
+
+ModelRedditSearchResponse = TypedDict('ModelRedditSearchResponse', {
+    'pagination': NotRequired[ModelRedditPagination],
+    'posts': NotRequired[list[ModelRedditPost]],
+    'query': NotRequired[str],
+    'sort': NotRequired[str],
+    'source': NotRequired[ModelRedditSourceDetail],
+    'subreddit': NotRequired[str],
+    'time': NotRequired[str],
+}, total=False)
+
+ModelRedditSourceDetail = TypedDict('ModelRedditSourceDetail', {
+    'type': NotRequired[str],
+    'url': NotRequired[str],
+}, total=False)
+
+ModelRedditSubredditPostsResponse = TypedDict('ModelRedditSubredditPostsResponse', {
+    'pagination': NotRequired[ModelRedditPagination],
+    'posts': NotRequired[list[ModelRedditPost]],
+    'sort': NotRequired[str],
+    'source': NotRequired[ModelRedditSourceDetail],
+    'subreddit': NotRequired[str],
+    'time': NotRequired[str],
+}, total=False)
+
+ModelRedditCommentsResponseDoc = TypedDict('ModelRedditCommentsResponseDoc', {
+    'code': NotRequired[int],
+    'data': NotRequired[ModelRedditCommentsResponse],
+    'msg': NotRequired[str],
+}, total=False)
+
+ModelRedditPostResponseDoc = TypedDict('ModelRedditPostResponseDoc', {
+    'code': NotRequired[int],
+    'data': NotRequired[ModelRedditPostResponse],
+    'msg': NotRequired[str],
+}, total=False)
+
+ModelRedditSearchResponseDoc = TypedDict('ModelRedditSearchResponseDoc', {
+    'code': NotRequired[int],
+    'data': NotRequired[ModelRedditSearchResponse],
+    'msg': NotRequired[str],
+}, total=False)
+
+ModelRedditSubredditPostsResponseDoc = TypedDict('ModelRedditSubredditPostsResponseDoc', {
+    'code': NotRequired[int],
+    'data': NotRequired[ModelRedditSubredditPostsResponse],
+    'msg': NotRequired[str],
+}, total=False)
+
 ModelReferralsReferralAttributionDoc = TypedDict('ModelReferralsReferralAttributionDoc', {
     'campaign': NotRequired[str],
     'code': NotRequired[str],
@@ -7780,6 +7982,15 @@ ModelYahoofinanceInfoResponse = TypedDict('ModelYahoofinanceInfoResponse', {
     'symbol': NotRequired[str],
 }, total=False)
 
+ModelYahoofinanceLookupResponse = TypedDict('ModelYahoofinanceLookupResponse', {
+    'count': NotRequired[int],
+    'documents': NotRequired[list[dict[str, Any]]],
+    'query': NotRequired[str],
+    'start': NotRequired[int],
+    'total': NotRequired[int],
+    'type': NotRequired[str],
+}, total=False)
+
 ModelYahoofinanceMarketStatusResponse = TypedDict('ModelYahoofinanceMarketStatusResponse', {
     'market': NotRequired[str],
     'status': NotRequired[dict[str, Any]],
@@ -7964,6 +8175,12 @@ ModelYahoofinanceIsinResponseDoc = TypedDict('ModelYahoofinanceIsinResponseDoc',
     'msg': NotRequired[str],
 }, total=False)
 
+ModelYahoofinanceLookupResponseDoc = TypedDict('ModelYahoofinanceLookupResponseDoc', {
+    'code': NotRequired[int],
+    'data': NotRequired[ModelYahoofinanceLookupResponse],
+    'msg': NotRequired[str],
+}, total=False)
+
 ModelYahoofinanceMarketStatusResponseDoc = TypedDict('ModelYahoofinanceMarketStatusResponseDoc', {
     'code': NotRequired[int],
     'data': NotRequired[ModelYahoofinanceMarketStatusResponse],
@@ -8952,6 +9169,18 @@ BingVideosParams = TypedDict('BingVideosParams', {
     'lang': NotRequired[str],
 }, total=False)
 
+BrandRetrieveResponse = ModelBrandRetrieveResponseDoc
+BrandRetrieveParams = TypedDict('BrandRetrieveParams', {
+    '_response_type': NotRequired[ResponseType],
+    '_timeout': NotRequired[float],
+    '_headers': NotRequired[Mapping[str, str]],
+    'domain': Required[str],
+    'force_language': NotRequired[str],
+    'maxSpeed': NotRequired[bool],
+    'maxAgeMs': NotRequired[int],
+    'timeoutMS': NotRequired[int],
+}, total=False)
+
 BraveImagesResponse = ModelBraveImagesResponseDoc
 BraveImagesParams = TypedDict('BraveImagesParams', {
     '_response_type': NotRequired[ResponseType],
@@ -10216,6 +10445,50 @@ MetaReadyParams = TypedDict('MetaReadyParams', {
     '_headers': NotRequired[Mapping[str, str]],
 }, total=False)
 
+RedditCommentsResponse = ModelRedditCommentsResponseDoc
+RedditCommentsParams = TypedDict('RedditCommentsParams', {
+    '_response_type': NotRequired[ResponseType],
+    '_timeout': NotRequired[float],
+    '_headers': NotRequired[Mapping[str, str]],
+    'id': Required[str],
+    'sort': NotRequired[Literal['confidence', 'top', 'new', 'controversial', 'old', 'qa']],
+    'limit': NotRequired[int],
+    'depth': NotRequired[int],
+}, total=False)
+
+RedditPostResponse = ModelRedditPostResponseDoc
+RedditPostParams = TypedDict('RedditPostParams', {
+    '_response_type': NotRequired[ResponseType],
+    '_timeout': NotRequired[float],
+    '_headers': NotRequired[Mapping[str, str]],
+    'id': Required[str],
+}, total=False)
+
+RedditSearchResponse = ModelRedditSearchResponseDoc
+RedditSearchParams = TypedDict('RedditSearchParams', {
+    '_response_type': NotRequired[ResponseType],
+    '_timeout': NotRequired[float],
+    '_headers': NotRequired[Mapping[str, str]],
+    'q': Required[str],
+    'subreddit': NotRequired[str],
+    'sort': NotRequired[Literal['relevance', 'hot', 'new', 'top', 'comments']],
+    'time': NotRequired[Literal['hour', 'day', 'week', 'month', 'year', 'all']],
+    'limit': NotRequired[int],
+    'after': NotRequired[str],
+}, total=False)
+
+RedditSubredditPostsResponse = ModelRedditSubredditPostsResponseDoc
+RedditSubredditPostsParams = TypedDict('RedditSubredditPostsParams', {
+    '_response_type': NotRequired[ResponseType],
+    '_timeout': NotRequired[float],
+    '_headers': NotRequired[Mapping[str, str]],
+    'subreddit': Required[str],
+    'sort': NotRequired[Literal['hot', 'new', 'top', 'rising']],
+    'time': NotRequired[Literal['hour', 'day', 'week', 'month', 'year', 'all']],
+    'limit': NotRequired[int],
+    'after': NotRequired[str],
+}, total=False)
+
 ReferralsClickBody = ModelReferralsReferralClickRequestDoc
 ReferralsClickResponse = ModelReferralsReferralClickResponseDoc
 ReferralsClickParams = TypedDict('ReferralsClickParams', {
@@ -11458,6 +11731,17 @@ YahooFinanceIndustryParams = TypedDict('YahooFinanceIndustryParams', {
     'key': Required[str],
 }, total=False)
 
+YahooFinanceLookupResponse = ModelYahoofinanceLookupResponseDoc
+YahooFinanceLookupParams = TypedDict('YahooFinanceLookupParams', {
+    '_response_type': NotRequired[ResponseType],
+    '_timeout': NotRequired[float],
+    '_headers': NotRequired[Mapping[str, str]],
+    'query': Required[str],
+    'type': NotRequired[Literal['all', 'equity', 'etf', 'mutualfund', 'index', 'future', 'currency', 'cryptocurrency']],
+    'count': NotRequired[int],
+    'start': NotRequired[int],
+}, total=False)
+
 YahooFinanceMarketStatusResponse = ModelYahoofinanceMarketStatusResponseDoc
 YahooFinanceMarketStatusParams = TypedDict('YahooFinanceMarketStatusParams', {
     '_response_type': NotRequired[ResponseType],
@@ -11956,6 +12240,9 @@ class BingGroup:
     def suggest(self, **params: Unpack[BingSuggestParams]) -> BingSuggestResponse: ...
     def videos(self, **params: Unpack[BingVideosParams]) -> BingVideosResponse: ...
 
+class BrandGroup:
+    def retrieve(self, **params: Unpack[BrandRetrieveParams]) -> BrandRetrieveResponse: ...
+
 class BraveGroup:
     def images(self, **params: Unpack[BraveImagesParams]) -> BraveImagesResponse: ...
     def news(self, **params: Unpack[BraveNewsParams]) -> BraveNewsResponse: ...
@@ -12106,6 +12393,12 @@ class ProductHuntGroup:
     def reviews(self, **params: Unpack[ProductHuntReviewsParams]) -> ProductHuntReviewsResponse: ...
     def search(self, **params: Unpack[ProductHuntSearchParams]) -> ProductHuntSearchResponse: ...
 
+class RedditGroup:
+    def comments(self, **params: Unpack[RedditCommentsParams]) -> RedditCommentsResponse: ...
+    def post(self, **params: Unpack[RedditPostParams]) -> RedditPostResponse: ...
+    def search(self, **params: Unpack[RedditSearchParams]) -> RedditSearchResponse: ...
+    def subreddit_posts(self, **params: Unpack[RedditSubredditPostsParams]) -> RedditSubredditPostsResponse: ...
+
 class ReferralsGroup:
     def click(self, **params: Unpack[ReferralsClickParams]) -> ReferralsClickResponse: ...
     def me(self, **params: Unpack[ReferralsMeParams]) -> ReferralsMeResponse: ...
@@ -12249,6 +12542,7 @@ class YahooFinanceGroup:
     def download(self, **params: Unpack[YahooFinanceDownloadParams]) -> YahooFinanceDownloadResponse: ...
     def industries(self, **params: Unpack[YahooFinanceIndustriesParams]) -> YahooFinanceIndustriesResponse: ...
     def industry(self, **params: Unpack[YahooFinanceIndustryParams]) -> YahooFinanceIndustryResponse: ...
+    def lookup(self, **params: Unpack[YahooFinanceLookupParams]) -> YahooFinanceLookupResponse: ...
     def market_status(self, **params: Unpack[YahooFinanceMarketStatusParams]) -> YahooFinanceMarketStatusResponse: ...
     def market_summary(self, **params: Unpack[YahooFinanceMarketSummaryParams]) -> YahooFinanceMarketSummaryResponse: ...
     def screener_custom(self, **params: Unpack[YahooFinanceScreenerCustomParams]) -> YahooFinanceScreenerCustomResponse: ...
@@ -12339,6 +12633,7 @@ OperationId = Literal[
     'bing-search',
     'bing-suggest',
     'bing-videos',
+    'brand-retrieve',
     'brave-images',
     'brave-news',
     'brave-search',
@@ -12465,6 +12760,10 @@ OperationId = Literal[
     'producthunt-reviews',
     'producthunt-search',
     'ready',
+    'reddit-comments',
+    'reddit-post',
+    'reddit-search',
+    'reddit-subreddit-posts',
     'referrals-click',
     'referrals-me',
     'referrals-me-events',
@@ -12585,6 +12884,7 @@ OperationId = Literal[
     'yahoo-finance-download',
     'yahoo-finance-industries',
     'yahoo-finance-industry',
+    'yahoo-finance-lookup',
     'yahoo-finance-market-status',
     'yahoo-finance-market-summary',
     'yahoo-finance-screener-custom',
@@ -12643,6 +12943,7 @@ class CrawloraClient:
     app_store: AppStoreGroup
     billing: BillingGroup
     bing: BingGroup
+    brand: BrandGroup
     brave: BraveGroup
     coin_gecko: CoinGeckoGroup
     datasets: DatasetsGroup
@@ -12655,6 +12956,7 @@ class CrawloraClient:
     linked_in: LinkedInGroup
     meta: MetaGroup
     product_hunt: ProductHuntGroup
+    reddit: RedditGroup
     referrals: ReferralsGroup
     shop_app: ShopAppGroup
     shopify: ShopifyGroup
@@ -13170,6 +13472,18 @@ class CrawloraClient:
         retry_predicate: Callable[[int, BaseException | None], bool] | None = ...,
     ) -> BingVideosResponse: ...
     @overload
+    def operation(
+        self,
+        operation_id: Literal['brand-retrieve'],
+        params: BrandRetrieveParams,
+        *,
+        response_type: ResponseType = ...,
+        timeout: float | None = ...,
+        headers: Mapping[str, str] | None = ...,
+        retries: int | None = ...,
+        retry_predicate: Callable[[int, BaseException | None], bool] | None = ...,
+    ) -> BrandRetrieveResponse: ...
+    @overload
     def operation(
         self,
         operation_id: Literal['brave-images'],
@@ -14682,6 +14996,54 @@ class CrawloraClient:
         retry_predicate: Callable[[int, BaseException | None], bool] | None = ...,
     ) -> MetaReadyResponse: ...
     @overload
+    def operation(
+        self,
+        operation_id: Literal['reddit-comments'],
+        params: RedditCommentsParams,
+        *,
+        response_type: ResponseType = ...,
+        timeout: float | None = ...,
+        headers: Mapping[str, str] | None = ...,
+        retries: int | None = ...,
+        retry_predicate: Callable[[int, BaseException | None], bool] | None = ...,
+    ) -> RedditCommentsResponse: ...
+    @overload
+    def operation(
+        self,
+        operation_id: Literal['reddit-post'],
+        params: RedditPostParams,
+        *,
+        response_type: ResponseType = ...,
+        timeout: float | None = ...,
+        headers: Mapping[str, str] | None = ...,
+        retries: int | None = ...,
+        retry_predicate: Callable[[int, BaseException | None], bool] | None = ...,
+    ) -> RedditPostResponse: ...
+    @overload
+    def operation(
+        self,
+        operation_id: Literal['reddit-search'],
+        params: RedditSearchParams,
+        *,
+        response_type: ResponseType = ...,
+        timeout: float | None = ...,
+        headers: Mapping[str, str] | None = ...,
+        retries: int | None = ...,
+        retry_predicate: Callable[[int, BaseException | None], bool] | None = ...,
+    ) -> RedditSearchResponse: ...
+    @overload
+    def operation(
+        self,
+        operation_id: Literal['reddit-subreddit-posts'],
+        params: RedditSubredditPostsParams,
+        *,
+        response_type: ResponseType = ...,
+        timeout: float | None = ...,
+        headers: Mapping[str, str] | None = ...,
+        retries: int | None = ...,
+        retry_predicate: Callable[[int, BaseException | None], bool] | None = ...,
+    ) -> RedditSubredditPostsResponse: ...
+    @overload
     def operation(
         self,
         operation_id: Literal['referrals-click'],
@@ -16122,6 +16484,18 @@ class CrawloraClient:
         retry_predicate: Callable[[int, BaseException | None], bool] | None = ...,
     ) -> YahooFinanceIndustryResponse: ...
     @overload
+    def operation(
+        self,
+        operation_id: Literal['yahoo-finance-lookup'],
+        params: YahooFinanceLookupParams,
+        *,
+        response_type: ResponseType = ...,
+        timeout: float | None = ...,
+        headers: Mapping[str, str] | None = ...,
+        retries: int | None = ...,
+        retry_predicate: Callable[[int, BaseException | None], bool] | None = ...,
+    ) -> YahooFinanceLookupResponse: ...
+    @overload
     def operation(
         self,
         operation_id: Literal['yahoo-finance-market-status'],
@@ -17142,6 +17516,18 @@ class CrawloraClient:
         retry_predicate: Callable[[int, BaseException | None], bool] | None = ...,
     ) -> BingVideosResponse: ...
     @overload
+    def request(
+        self,
+        operation_id: Literal['brand-retrieve'],
+        params: BrandRetrieveParams,
+        *,
+        response_type: ResponseType = ...,
+        timeout: float | None = ...,
+        headers: Mapping[str, str] | None = ...,
+        retries: int | None = ...,
+        retry_predicate: Callable[[int, BaseException | None], bool] | None = ...,
+    ) -> BrandRetrieveResponse: ...
+    @overload
     def request(
         self,
         operation_id: Literal['brave-images'],
@@ -18654,6 +19040,54 @@ class CrawloraClient:
         retry_predicate: Callable[[int, BaseException | None], bool] | None = ...,
     ) -> MetaReadyResponse: ...
     @overload
+    def request(
+        self,
+        operation_id: Literal['reddit-comments'],
+        params: RedditCommentsParams,
+        *,
+        response_type: ResponseType = ...,
+        timeout: float | None = ...,
+        headers: Mapping[str, str] | None = ...,
+        retries: int | None = ...,
+        retry_predicate: Callable[[int, BaseException | None], bool] | None = ...,
+    ) -> RedditCommentsResponse: ...
+    @overload
+    def request(
+        self,
+        operation_id: Literal['reddit-post'],
+        params: RedditPostParams,
+        *,
+        response_type: ResponseType = ...,
+        timeout: float | None = ...,
+        headers: Mapping[str, str] | None = ...,
+        retries: int | None = ...,
+        retry_predicate: Callable[[int, BaseException | None], bool] | None = ...,
+    ) -> RedditPostResponse: ...
+    @overload
+    def request(
+        self,
+        operation_id: Literal['reddit-search'],
+        params: RedditSearchParams,
+        *,
+        response_type: ResponseType = ...,
+        timeout: float | None = ...,
+        headers: Mapping[str, str] | None = ...,
+        retries: int | None = ...,
+        retry_predicate: Callable[[int, BaseException | None], bool] | None = ...,
+    ) -> RedditSearchResponse: ...
+    @overload
+    def request(
+        self,
+        operation_id: Literal['reddit-subreddit-posts'],
+        params: RedditSubredditPostsParams,
+        *,
+        response_type: ResponseType = ...,
+        timeout: float | None = ...,
+        headers: Mapping[str, str] | None = ...,
+        retries: int | None = ...,
+        retry_predicate: Callable[[int, BaseException | None], bool] | None = ...,
+    ) -> RedditSubredditPostsResponse: ...
+    @overload
     def request(
         self,
         operation_id: Literal['referrals-click'],
@@ -20094,6 +20528,18 @@ class CrawloraClient:
         retry_predicate: Callable[[int, BaseException | None], bool] | None = ...,
     ) -> YahooFinanceIndustryResponse: ...
     @overload
+    def request(
+        self,
+        operation_id: Literal['yahoo-finance-lookup'],
+        params: YahooFinanceLookupParams,
+        *,
+        response_type: ResponseType = ...,
+        timeout: float | None = ...,
+        headers: Mapping[str, str] | None = ...,
+        retries: int | None = ...,
+        retry_predicate: Callable[[int, BaseException | None], bool] | None = ...,
+    ) -> YahooFinanceLookupResponse: ...
+    @overload
     def request(
         self,
         operation_id: Literal['yahoo-finance-market-status'],

{crawlora-1.5.0.dev3 → crawlora-1.6.0.dev1}/crawlora/operations.py

@@ -482,6 +482,21 @@ OPERATIONS = {'airbnb-room': {'bodyParam': None,
                                  {'in': 'query', 'name': 'country', 'type': 'string'},
                                  {'in': 'query', 'name': 'lang', 'type': 'string'}],
                  'security': ['ApiKeyAuth']},
+ 'brand-retrieve': {'bodyParam': None,
+                    'bodyRequired': False,
+                    'consumes': ['application/json'],
+                    'formParams': [],
+                    'id': 'brand-retrieve',
+                    'method': 'GET',
+                    'path': '/brand/retrieve',
+                    'pathParams': [],
+                    'produces': ['application/json'],
+                    'queryParams': [{'in': 'query', 'name': 'domain', 'required': True, 'type': 'string'},
+                                    {'in': 'query', 'name': 'force_language', 'type': 'string'},
+                                    {'in': 'query', 'name': 'maxSpeed', 'type': 'boolean'},
+                                    {'in': 'query', 'name': 'maxAgeMs', 'type': 'integer'},
+                                    {'in': 'query', 'name': 'timeoutMS', 'type': 'integer'}],
+                    'security': ['ApiKeyAuth']},
  'brave-images': {'bodyParam': None,
                   'bodyRequired': False,
                   'consumes': ['application/json'],
@@ -3767,6 +3782,75 @@ OPERATIONS = {'airbnb-room': {'bodyParam': None,
            'produces': ['application/json'],
            'queryParams': [],
            'security': []},
+ 'reddit-comments': {'bodyParam': None,
+                     'bodyRequired': False,
+                     'consumes': ['application/json'],
+                     'formParams': [],
+                     'id': 'reddit-comments',
+                     'method': 'GET',
+                     'path': '/reddit/comments/{id}',
+                     'pathParams': ['id'],
+                     'produces': ['application/json'],
+                     'queryParams': [{'enum': ['confidence', 'top', 'new', 'controversial', 'old', 'qa'],
+                                      'in': 'query',
+                                      'name': 'sort',
+                                      'type': 'string'},
+                                     {'in': 'query', 'name': 'limit', 'type': 'integer'},
+                                     {'in': 'query', 'name': 'depth', 'type': 'integer'}],
+                     'security': ['ApiKeyAuth']},
+ 'reddit-post': {'bodyParam': None,
+                 'bodyRequired': False,
+                 'consumes': ['application/json'],
+                 'formParams': [],
+                 'id': 'reddit-post',
+                 'method': 'GET',
+                 'path': '/reddit/post/{id}',
+                 'pathParams': ['id'],
+                 'produces': ['application/json'],
+                 'queryParams': [],
+                 'security': ['ApiKeyAuth']},
+ 'reddit-search': {'bodyParam': None,
+                   'bodyRequired': False,
+                   'consumes': ['application/json'],
+                   'formParams': [],
+                   'id': 'reddit-search',
+                   'method': 'GET',
+                   'path': '/reddit/search',
+                   'pathParams': [],
+                   'produces': ['application/json'],
+                   'queryParams': [{'in': 'query', 'name': 'q', 'required': True, 'type': 'string'},
+                                   {'in': 'query', 'name': 'subreddit', 'type': 'string'},
+                                   {'enum': ['relevance', 'hot', 'new', 'top', 'comments'],
+                                    'in': 'query',
+                                    'name': 'sort',
+                                    'type': 'string'},
+                                   {'enum': ['hour', 'day', 'week', 'month', 'year', 'all'],
+                                    'in': 'query',
+                                    'name': 'time',
+                                    'type': 'string'},
+                                   {'in': 'query', 'name': 'limit', 'type': 'integer'},
+                                   {'in': 'query', 'name': 'after', 'type': 'string'}],
+                   'security': ['ApiKeyAuth']},
+ 'reddit-subreddit-posts': {'bodyParam': None,
+                            'bodyRequired': False,
+                            'consumes': ['application/json'],
+                            'formParams': [],
+                            'id': 'reddit-subreddit-posts',
+                            'method': 'GET',
+                            'path': '/reddit/subreddit/{subreddit}/posts',
+                            'pathParams': ['subreddit'],
+                            'produces': ['application/json'],
+                            'queryParams': [{'enum': ['hot', 'new', 'top', 'rising'],
+                                             'in': 'query',
+                                             'name': 'sort',
+                                             'type': 'string'},
+                                            {'enum': ['hour', 'day', 'week', 'month', 'year', 'all'],
+                                             'in': 'query',
+                                             'name': 'time',
+                                             'type': 'string'},
+                                            {'in': 'query', 'name': 'limit', 'type': 'integer'},
+                                            {'in': 'query', 'name': 'after', 'type': 'string'}],
+                            'security': ['ApiKeyAuth']},
  'referrals-click': {'bodyParam': 'request',
                      'bodyRequired': True,
                      'consumes': ['application/json'],
@@ -5366,7 +5450,7 @@ OPERATIONS = {'airbnb-room': {'bodyParam': None,
                                         {'in': 'query', 'name': 'limit', 'type': 'integer'},
                                         {'in': 'query', 'name': 'from', 'type': 'string'},
                                         {'in': 'query', 'name': 'to', 'type': 'string'}],
-                        'security': ['JWTAuth']},
+                        'security': ['ApiKeyAuth']},
  'usage-me-overview': {'bodyParam': None,
                        'bodyRequired': False,
                        'consumes': ['application/json'],
@@ -5382,7 +5466,7 @@ OPERATIONS = {'airbnb-room': {'bodyParam': None,
                                         'type': 'string'},
                                        {'in': 'query', 'name': 'from', 'type': 'string'},
                                        {'in': 'query', 'name': 'to', 'type': 'string'}],
-                       'security': ['JWTAuth']},
+                       'security': ['ApiKeyAuth']},
  'usage-me-recent-ips': {'bodyParam': None,
                          'bodyRequired': False,
                          'consumes': ['application/json'],
@@ -5399,7 +5483,7 @@ OPERATIONS = {'airbnb-room': {'bodyParam': None,
                                          {'in': 'query', 'name': 'limit', 'type': 'integer'},
                                          {'in': 'query', 'name': 'from', 'type': 'string'},
                                          {'in': 'query', 'name': 'to', 'type': 'string'}],
-                         'security': ['JWTAuth']},
+                         'security': ['ApiKeyAuth']},
  'usage-me-timeseries': {'bodyParam': None,
                          'bodyRequired': False,
                          'consumes': ['application/json'],
@@ -5417,7 +5501,7 @@ OPERATIONS = {'airbnb-room': {'bodyParam': None,
                                          {'in': 'query', 'name': 'endpoint', 'type': 'string'},
                                          {'in': 'query', 'name': 'from', 'type': 'string'},
                                          {'in': 'query', 'name': 'to', 'type': 'string'}],
-                         'security': ['JWTAuth']},
+                         'security': ['ApiKeyAuth']},
  'user-me': {'bodyParam': None,
              'bodyRequired': False,
              'consumes': ['application/json'],
@@ -5524,6 +5608,32 @@ OPERATIONS = {'airbnb-room': {'bodyParam': None,
                             'produces': ['application/json'],
                             'queryParams': [],
                             'security': ['ApiKeyAuth']},
+ 'yahoo-finance-lookup': {'bodyParam': None,
+                          'bodyRequired': False,
+                          'consumes': ['application/json'],
+                          'cursorParams': ['start'],
+                          'formParams': [],
+                          'id': 'yahoo-finance-lookup',
+                          'method': 'GET',
+                          'paginatable': True,
+                          'path': '/yahoo-finance/lookup',
+                          'pathParams': [],
+                          'produces': ['application/json'],
+                          'queryParams': [{'in': 'query', 'name': 'query', 'required': True, 'type': 'string'},
+                                          {'enum': ['all',
+                                                    'equity',
+                                                    'etf',
+                                                    'mutualfund',
+                                                    'index',
+                                                    'future',
+                                                    'currency',
+                                                    'cryptocurrency'],
+                                           'in': 'query',
+                                           'name': 'type',
+                                           'type': 'string'},
+                                          {'in': 'query', 'name': 'count', 'type': 'integer'},
+                                          {'in': 'query', 'name': 'start', 'type': 'integer'}],
+                          'security': ['ApiKeyAuth']},
  'yahoo-finance-market-status': {'bodyParam': None,
                                  'bodyRequired': False,
                                  'consumes': ['application/json'],
@@ -6163,6 +6273,7 @@ GROUPS = {'airbnb': {'room': 'airbnb-room',
           'search': 'bing-search',
           'suggest': 'bing-suggest',
           'videos': 'bing-videos'},
+ 'brand': {'retrieve': 'brand-retrieve'},
  'brave': {'images': 'brave-images',
            'news': 'brave-news',
            'search': 'brave-search',
@@ -6284,6 +6395,10 @@ GROUPS = {'airbnb': {'room': 'airbnb-room',
                   'product': 'producthunt-product',
                   'reviews': 'producthunt-reviews',
                   'search': 'producthunt-search'},
+ 'reddit': {'comments': 'reddit-comments',
+            'post': 'reddit-post',
+            'search': 'reddit-search',
+            'subreddit_posts': 'reddit-subreddit-posts'},
  'referrals': {'click': 'referrals-click', 'me': 'referrals-me', 'me_events': 'referrals-me-events'},
  'shop_app': {'analysis': 'shop-app-analysis',
               'categories': 'shop-app-categories',
@@ -6401,6 +6516,7 @@ GROUPS = {'airbnb': {'room': 'airbnb-room',
                    'download': 'yahoo-finance-download',
                    'industries': 'yahoo-finance-industries',
                    'industry': 'yahoo-finance-industry',
+                   'lookup': 'yahoo-finance-lookup',
                    'market_status': 'yahoo-finance-market-status',
                    'market_summary': 'yahoo-finance-market-summary',
                    'screener': 'yahoo-finance-screener',
@@ -6449,7 +6565,7 @@ GROUPS = {'airbnb': {'room': 'airbnb-room',
              'video': 'youtube-video'},
  'zillow': {'autocomplete': 'zillow-autocomplete', 'property': 'zillow-property', 'search': 'zillow-search'}}
 
-OPERATION_COUNT = 330
+OPERATION_COUNT = 336
 
 class OperationId:
     AIRBNB_ROOM = 'airbnb-room'
@@ -6487,6 +6603,7 @@ class OperationId:
     BING_SEARCH = 'bing-search'
     BING_SUGGEST = 'bing-suggest'
     BING_VIDEOS = 'bing-videos'
+    BRAND_RETRIEVE = 'brand-retrieve'
     BRAVE_IMAGES = 'brave-images'
     BRAVE_NEWS = 'brave-news'
     BRAVE_SEARCH = 'brave-search'
@@ -6613,6 +6730,10 @@ class OperationId:
     PRODUCT_HUNT_PRODUCT = 'producthunt-product'
     PRODUCT_HUNT_REVIEWS = 'producthunt-reviews'
     PRODUCT_HUNT_SEARCH = 'producthunt-search'
+    REDDIT_COMMENTS = 'reddit-comments'
+    REDDIT_POST = 'reddit-post'
+    REDDIT_SEARCH = 'reddit-search'
+    REDDIT_SUBREDDIT_POSTS = 'reddit-subreddit-posts'
     REFERRALS_CLICK = 'referrals-click'
     REFERRALS_ME = 'referrals-me'
     REFERRALS_ME_EVENTS = 'referrals-me-events'
@@ -6733,6 +6854,7 @@ class OperationId:
     YAHOO_FINANCE_DOWNLOAD = 'yahoo-finance-download'
     YAHOO_FINANCE_INDUSTRIES = 'yahoo-finance-industries'
     YAHOO_FINANCE_INDUSTRY = 'yahoo-finance-industry'
+    YAHOO_FINANCE_LOOKUP = 'yahoo-finance-lookup'
     YAHOO_FINANCE_MARKET_STATUS = 'yahoo-finance-market-status'
     YAHOO_FINANCE_MARKET_SUMMARY = 'yahoo-finance-market-summary'
     YAHOO_FINANCE_SCREENER = 'yahoo-finance-screener'

{crawlora-1.5.0.dev3 → crawlora-1.6.0.dev1/crawlora.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crawlora
-Version: 1.5.0.dev3
+Version: 1.6.0.dev1
 Summary: Official Python SDK for the Crawlora web-scraping API: typed grouped and dynamic operation calls for every public endpoint, with retries, pagination, hooks, and an async client.
 Author: Crawlora
 License-Expression: MIT
@@ -27,8 +27,8 @@ Dynamic: license-file
 # Crawlora Python SDK
 
 Python client for the public Crawlora API. Use it to call Crawlora scraping,
-search, marketplace, media, maps, finance, and usage endpoints with generated
-type stubs for editor and type-checker support.
+search, social, marketplace, media, maps, finance, brand, and usage endpoints
+with generated type stubs for editor and type-checker support.
 
 - Runtime: Python 3.10+
 - Auth: `x-api-key`

{crawlora-1.5.0.dev3 → crawlora-1.6.0.dev1}/docs/operations.md

@@ -2,7 +2,7 @@
 
 Generated from `openapi/public.json`. Deprecated, admin, and internal operations are excluded from this SDK contract.
 
-Total operations: `330`
+Total operations: `336`
 
 | Group | SDK method | Operation ID | HTTP | Params | Auth | Response | Notes |
 | --- | --- | --- | --- | --- | --- | --- | --- |
@@ -41,6 +41,7 @@ Total operations: `330`
 | bing | `bing.search` | `bing-search` | `GET /bing/search` | `q` (query str required)<br>`page` (query int)<br>`count` (query int)<br>`country` (query str)<br>`lang` (query str) | `ApiKeyAuth` | `BingSearchResponse` |  |
 | bing | `bing.suggest` | `bing-suggest` | `GET /bing/suggest` | `q` (query str required)<br>`count` (query int)<br>`country` (query str)<br>`lang` (query str) | `ApiKeyAuth` | `BingSuggestResponse` |  |
 | bing | `bing.videos` | `bing-videos` | `GET /bing/videos` | `q` (query str required)<br>`page` (query int)<br>`count` (query int)<br>`country` (query str)<br>`lang` (query str) | `ApiKeyAuth` | `BingVideosResponse` |  |
+| brand | `brand.retrieve` | `brand-retrieve` | `GET /brand/retrieve` | `domain` (query str required)<br>`force_language` (query str)<br>`maxSpeed` (query bool)<br>`maxAgeMs` (query int)<br>`timeoutMS` (query int) | `ApiKeyAuth` | `BrandRetrieveResponse` |  |
 | brave | `brave.images` | `brave-images` | `GET /brave/images` | `q` (query str required)<br>`offset` (query int)<br>`count` (query int)<br>`country` (query Literal['all', 'ar', 'at', 'au', 'be', 'br', 'ca', 'ch', 'cl', 'cn', 'de', 'dk', 'es', 'fi', 'fr', 'gb', 'gr', 'hk', 'id', 'in', 'it', 'jp', 'kr', 'mx', 'my', 'nl', 'no', 'nz', 'ph', 'pl', 'pt', 'ru', 'sa', 'se', 'sg', 'tr', 'tw', 'us', 'za'])<br>`lang` (query Literal['de-de', 'en-ca', 'en-gb', 'en-in', 'en-us', 'fi-fi', 'fr-ca', 'fr-fr', 'ja-jp', 'pt-br', 'sq-al', 'sw-ke', 'zh-tw']) | `ApiKeyAuth` | `BraveImagesResponse` |  |
 | brave | `brave.news` | `brave-news` | `GET /brave/news` | `q` (query str required)<br>`offset` (query int)<br>`count` (query int)<br>`country` (query Literal['all', 'ar', 'at', 'au', 'be', 'br', 'ca', 'ch', 'cl', 'cn', 'de', 'dk', 'es', 'fi', 'fr', 'gb', 'gr', 'hk', 'id', 'in', 'it', 'jp', 'kr', 'mx', 'my', 'nl', 'no', 'nz', 'ph', 'pl', 'pt', 'ru', 'sa', 'se', 'sg', 'tr', 'tw', 'us', 'za'])<br>`lang` (query Literal['de-de', 'en-ca', 'en-gb', 'en-in', 'en-us', 'fi-fi', 'fr-ca', 'fr-fr', 'ja-jp', 'pt-br', 'sq-al', 'sw-ke', 'zh-tw'])<br>`time_range` (query Literal['any', 'day', 'week', 'month', 'year', 'custom'])<br>`date_from` (query str)<br>`date_to` (query str) | `ApiKeyAuth` | `BraveNewsResponse` |  |
 | brave | `brave.search` | `brave-search` | `GET /brave/search` | `q` (query str required)<br>`offset` (query int)<br>`country` (query Literal['all', 'ar', 'at', 'au', 'be', 'br', 'ca', 'ch', 'cl', 'cn', 'de', 'dk', 'es', 'fi', 'fr', 'gb', 'gr', 'hk', 'id', 'in', 'it', 'jp', 'kr', 'mx', 'my', 'nl', 'no', 'nz', 'ph', 'pl', 'pt', 'ru', 'sa', 'se', 'sg', 'tr', 'tw', 'us', 'za'])<br>`lang` (query Literal['de-de', 'en-ca', 'en-gb', 'en-in', 'en-us', 'fi-fi', 'fr-ca', 'fr-fr', 'ja-jp', 'pt-br', 'sq-al', 'sw-ke', 'zh-tw'])<br>`time_range` (query Literal['any', 'day', 'week', 'month', 'year', 'custom'])<br>`date_from` (query str)<br>`date_to` (query str) | `ApiKeyAuth` | `BraveSearchResponse` |  |
@@ -167,6 +168,10 @@ Total operations: `330`
 | product_hunt | `product_hunt.makers` | `producthunt-makers` | `GET /producthunt/product/{id}/makers` | `id` (path str required)<br>`cursor` (query str) | `ApiKeyAuth` | `ProductHuntMakersResponse` |  |
 | product_hunt | `product_hunt.reviews` | `producthunt-reviews` | `GET /producthunt/product/{id}/reviews` | `id` (path str required) | `ApiKeyAuth` | `ProductHuntReviewsResponse` |  |
 | product_hunt | `product_hunt.search` | `producthunt-search` | `GET /producthunt/search` | `query` (query str required)<br>`type` (query Literal['product', 'user', 'launch'])<br>`page` (query int)<br>`featured` (query bool)<br>`topics` (query str) | `ApiKeyAuth` | `ProductHuntSearchResponse` |  |
+| reddit | `reddit.comments` | `reddit-comments` | `GET /reddit/comments/{id}` | `id` (path str required)<br>`sort` (query Literal['confidence', 'top', 'new', 'controversial', 'old', 'qa'])<br>`limit` (query int)<br>`depth` (query int) | `ApiKeyAuth` | `RedditCommentsResponse` |  |
+| reddit | `reddit.post` | `reddit-post` | `GET /reddit/post/{id}` | `id` (path str required) | `ApiKeyAuth` | `RedditPostResponse` |  |
+| reddit | `reddit.search` | `reddit-search` | `GET /reddit/search` | `q` (query str required)<br>`subreddit` (query str)<br>`sort` (query Literal['relevance', 'hot', 'new', 'top', 'comments'])<br>`time` (query Literal['hour', 'day', 'week', 'month', 'year', 'all'])<br>`limit` (query int)<br>`after` (query str) | `ApiKeyAuth` | `RedditSearchResponse` |  |
+| reddit | `reddit.subreddit_posts` | `reddit-subreddit-posts` | `GET /reddit/subreddit/{subreddit}/posts` | `subreddit` (path str required)<br>`sort` (query Literal['hot', 'new', 'top', 'rising'])<br>`time` (query Literal['hour', 'day', 'week', 'month', 'year', 'all'])<br>`limit` (query int)<br>`after` (query str) | `ApiKeyAuth` | `RedditSubredditPostsResponse` |  |
 | referrals | `referrals.click` | `referrals-click` | `POST /referrals/click` | `request` (body str required) | none | `ReferralsClickResponse` |  |
 | referrals | `referrals.me` | `referrals-me` | `GET /referrals/me` | none | `JWTAuth` | `ReferralsMeResponse` |  |
 | referrals | `referrals.me_events` | `referrals-me-events` | `GET /referrals/me/events` | `limit` (query int) | `JWTAuth` | `ReferralsMeEventsResponse` |  |
@@ -274,10 +279,10 @@ Total operations: `330`
 | trustpilot | `trustpilot.categories` | `trustpilot-categories` | `GET /trustpilot/categories` | none | `ApiKeyAuth` | `TrustpilotCategoriesResponse` |  |
 | trustpilot | `trustpilot.category_search` | `trustpilot-category-search` | `GET /trustpilot/categories/search` | `q` (query str required)<br>`country` (query str)<br>`locale` (query str)<br>`size` (query int) | `ApiKeyAuth` | `TrustpilotCategorySearchResponse` |  |
 | trustpilot | `trustpilot.category` | `trustpilot-category` | `GET /trustpilot/category/{slug}` | `slug` (path str required)<br>`page` (query int) | `ApiKeyAuth` | `TrustpilotCategoryResponse` |  |
-| usage | `usage.me_endpoints` | `usage-me-endpoints` | `GET /usage/me/endpoints` | `range` (query Literal['period', 'day', 'week', 'month', 'custom'])<br>`limit` (query int)<br>`from` (query str)<br>`to` (query str) | `JWTAuth` | `UsageMeEndpointsResponse` |  |
-| usage | `usage.me_overview` | `usage-me-overview` | `GET /usage/me/overview` | `range` (query Literal['period', 'day', 'week', 'month', 'custom'])<br>`from` (query str)<br>`to` (query str) | `JWTAuth` | `UsageMeOverviewResponse` |  |
-| usage | `usage.me_recent_ips` | `usage-me-recent-ips` | `GET /usage/me/recent-ips` | `range` (query Literal['period', 'day', 'week', 'month', 'custom'])<br>`limit` (query int)<br>`from` (query str)<br>`to` (query str) | `JWTAuth` | `UsageMeRecentIpsResponse` |  |
-| usage | `usage.me_timeseries` | `usage-me-timeseries` | `GET /usage/me/timeseries` | `range` (query Literal['period', 'day', 'week', 'month', 'custom'])<br>`bucket` (query Literal['hour', 'day'])<br>`endpoint` (query str)<br>`from` (query str)<br>`to` (query str) | `JWTAuth` | `UsageMeTimeseriesResponse` |  |
+| usage | `usage.me_endpoints` | `usage-me-endpoints` | `GET /usage/me/endpoints` | `range` (query Literal['period', 'day', 'week', 'month', 'custom'])<br>`limit` (query int)<br>`from` (query str)<br>`to` (query str) | `ApiKeyAuth` | `UsageMeEndpointsResponse` |  |
+| usage | `usage.me_overview` | `usage-me-overview` | `GET /usage/me/overview` | `range` (query Literal['period', 'day', 'week', 'month', 'custom'])<br>`from` (query str)<br>`to` (query str) | `ApiKeyAuth` | `UsageMeOverviewResponse` |  |
+| usage | `usage.me_recent_ips` | `usage-me-recent-ips` | `GET /usage/me/recent-ips` | `range` (query Literal['period', 'day', 'week', 'month', 'custom'])<br>`limit` (query int)<br>`from` (query str)<br>`to` (query str) | `ApiKeyAuth` | `UsageMeRecentIpsResponse` |  |
+| usage | `usage.me_timeseries` | `usage-me-timeseries` | `GET /usage/me/timeseries` | `range` (query Literal['period', 'day', 'week', 'month', 'custom'])<br>`bucket` (query Literal['hour', 'day'])<br>`endpoint` (query str)<br>`from` (query str)<br>`to` (query str) | `ApiKeyAuth` | `UsageMeTimeseriesResponse` |  |
 | user | `user.me` | `user-me` | `GET /user/me` | none | `JWTAuth` | `UserMeResponse` |  |
 | user | `user.me_api_keys` | `user-me-api-keys` | `GET /user/me/api-keys` | none | `JWTAuth` | `UserMeApiKeysResponse` |  |
 | user | `user.me_api_keys_rotate` | `user-me-api-keys-rotate` | `POST /user/me/api-keys/rotate` | none | `JWTAuth` | `UserMeApiKeysRotateResponse` |  |
@@ -287,6 +292,7 @@ Total operations: `330`
 | yahoo_finance | `yahoo_finance.download` | `yahoo-finance-download` | `POST /yahoo-finance/download` | `request` (body str required) | `ApiKeyAuth` | `YahooFinanceDownloadResponse` |  |
 | yahoo_finance | `yahoo_finance.industries` | `yahoo-finance-industries` | `GET /yahoo-finance/industries` | none | `ApiKeyAuth` | `YahooFinanceIndustriesResponse` |  |
 | yahoo_finance | `yahoo_finance.industry` | `yahoo-finance-industry` | `GET /yahoo-finance/industries/{key}` | `key` (path str required) | `ApiKeyAuth` | `YahooFinanceIndustryResponse` |  |
+| yahoo_finance | `yahoo_finance.lookup` | `yahoo-finance-lookup` | `GET /yahoo-finance/lookup` | `query` (query str required)<br>`type` (query Literal['all', 'equity', 'etf', 'mutualfund', 'index', 'future', 'currency', 'cryptocurrency'])<br>`count` (query int)<br>`start` (query int) | `ApiKeyAuth` | `YahooFinanceLookupResponse` |  |
 | yahoo_finance | `yahoo_finance.market_status` | `yahoo-finance-market-status` | `GET /yahoo-finance/market/{market}/status` | `market` (path str required) | `ApiKeyAuth` | `YahooFinanceMarketStatusResponse` |  |
 | yahoo_finance | `yahoo_finance.market_summary` | `yahoo-finance-market-summary` | `GET /yahoo-finance/market/{market}/summary` | `market` (path str required) | `ApiKeyAuth` | `YahooFinanceMarketSummaryResponse` |  |
 | yahoo_finance | `yahoo_finance.screener_custom` | `yahoo-finance-screener-custom` | `POST /yahoo-finance/screener` | `request` (body str required) | `ApiKeyAuth` | `YahooFinanceScreenerCustomResponse` |  |

{crawlora-1.5.0.dev3 → crawlora-1.6.0.dev1}/docs/recipes.md

@@ -30,6 +30,15 @@ Literal operation ids infer response aliases in type checkers. Use grouped
 endpoint methods for ordinary app code and dynamic operation calls when your app
 stores operation ids in configuration, queues, or jobs.
 
+## Reddit And Brand
+
+Newer platforms are grouped like every other endpoint:
+
+```python
+posts = crawlora.reddit.search(q="python", subreddit="programming")
+brand = crawlora.brand.retrieve(domain="stripe.com")
+```
+
 ## Retries, Timeouts, And Headers
 
 ```python

{crawlora-1.5.0.dev3 → crawlora-1.6.0.dev1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "crawlora"
-version = "1.5.0.dev3"
+version = "1.6.0.dev1"
 description = "Official Python SDK for the Crawlora web-scraping API: typed grouped and dynamic operation calls for every public endpoint, with retries, pagination, hooks, and an async client."
 readme = "README.md"
 requires-python = ">=3.10"

{crawlora-1.5.0.dev3 → crawlora-1.6.0.dev1}/tests/test_client.py

@@ -267,7 +267,7 @@ class CrawloraClientTest(unittest.TestCase):
         self.assertIs(raised.exception.__cause__, cause)
 
     def test_operation_metadata_count(self):
-        self.assertEqual(OPERATION_COUNT, 330)
+        self.assertEqual(OPERATION_COUNT, 336)
 
     def test_deprecated_endpoints_are_not_generated(self):
         self.assertFalse(hasattr(CrawloraClient(api_key="api_test", base_url=self.base_url).google, "lens"))
@@ -296,7 +296,7 @@ class CrawloraClientTest(unittest.TestCase):
         recipes_doc = root.joinpath("docs", "recipes.md").read_text()
 
         for expected in [
-            "Total operations: `330`",
+            "Total operations: `336`",
             "`bing-search`",
             "`GET /bing/search`",
             "`bing.search`",