crawlora 1.5.0.dev2__tar.gz → 1.6.0.dev1__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crawlora
-Version: 1.5.0.dev2
+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`
@@ -38,7 +38,7 @@ type stubs for editor and type-checker support.
 ## Install
 
 Published on [PyPI](https://pypi.org/project/crawlora/). The current release is a
-prerelease (`1.5.0.dev1`), so install it with `--pre`:
+prerelease (`1.5.0.dev3`), so install it with `--pre`:
 
 ```sh
 pip install --pre crawlora
@@ -207,6 +207,6 @@ The import name is `crawlora`:
 from crawlora import CrawloraClient
 ```
 
-The future PyPI package target is also `crawlora`, but registry publication is
-not enabled yet. Until then, install from an explicit Git beta tag or the
-moving `latest` tag as shown above.
+The package is published on [PyPI](https://pypi.org/project/crawlora/) as
+`crawlora` (a prerelease — `pip install --pre crawlora`). Git beta tags and the
+moving `latest` tag also work, as shown above.

{crawlora-1.5.0.dev2 → 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`
@@ -12,7 +12,7 @@ type stubs for editor and type-checker support.
 ## Install
 
 Published on [PyPI](https://pypi.org/project/crawlora/). The current release is a
-prerelease (`1.5.0.dev1`), so install it with `--pre`:
+prerelease (`1.5.0.dev3`), so install it with `--pre`:
 
 ```sh
 pip install --pre crawlora
@@ -181,6 +181,6 @@ The import name is `crawlora`:
 from crawlora import CrawloraClient
 ```
 
-The future PyPI package target is also `crawlora`, but registry publication is
-not enabled yet. Until then, install from an explicit Git beta tag or the
-moving `latest` tag as shown above.
+The package is published on [PyPI](https://pypi.org/project/crawlora/) as
+`crawlora` (a prerelease — `pip install --pre crawlora`). Git beta tags and the
+moving `latest` tag also work, as shown above.

{crawlora-1.5.0.dev2 → 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.2"
+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.dev2 → 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.dev2 → 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.dev2 → crawlora-1.6.0.dev1/crawlora.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crawlora
-Version: 1.5.0.dev2
+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`
@@ -38,7 +38,7 @@ type stubs for editor and type-checker support.
 ## Install
 
 Published on [PyPI](https://pypi.org/project/crawlora/). The current release is a
-prerelease (`1.5.0.dev1`), so install it with `--pre`:
+prerelease (`1.5.0.dev3`), so install it with `--pre`:
 
 ```sh
 pip install --pre crawlora
@@ -207,6 +207,6 @@ The import name is `crawlora`:
 from crawlora import CrawloraClient
 ```
 
-The future PyPI package target is also `crawlora`, but registry publication is
-not enabled yet. Until then, install from an explicit Git beta tag or the
-moving `latest` tag as shown above.
+The package is published on [PyPI](https://pypi.org/project/crawlora/) as
+`crawlora` (a prerelease — `pip install --pre crawlora`). Git beta tags and the
+moving `latest` tag also work, as shown above.

{crawlora-1.5.0.dev2 → 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.dev2 → 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.dev2 → crawlora-1.6.0.dev1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "crawlora"
-version = "1.5.0.dev2"
+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.dev2 → 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`",