import type { ApiResponse, SearchResponse, ProductResponse, ReviewsResponse } from '../types/api.js';
/**
 * API Client for Optima Scout Backend
 */
export declare class ApiClient {
    private baseUrl;
    constructor(baseUrl?: string);
    /**
     * 获取认证 headers
     */
    private getAuthHeaders;
    /**
     * fetch 包装：统一加请求超时（AbortSignal.timeout）。原来所有 fetch 无超时，跨境/上游
     * 慢就无限挂 → agent 卡死。超时由 getHttpTimeoutMs() 控制（默认 30s，--timeout 可调）。
     * 若调用方已带 signal，则与超时信号合并（任一触发即中止）。超时抛明确错误供 LLM 感知。
     */
    private doFetch;
    /**
     * 处理 API 错误响应，提取有意义的错误信息
     */
    private handleErrorResponse;
    /**
     * Search for products
     */
    search(query: string, domain?: string): Promise<ApiResponse<SearchResponse>>;
    /**
     * Get product details by ASIN
     */
    getProduct(asin: string, domain?: string): Promise<ApiResponse<ProductResponse>>;
    /**
     * Get product reviews with pagination
     */
    getReviews(asin: string, params?: {
        domain?: string;
        pages?: number;
        sort?: string;
        star?: string;
        allStars?: boolean;
        verified?: boolean;
    }): Promise<ApiResponse<ReviewsResponse>>;
    /**
     * Search for 1688 suppliers by keyword
     */
    searchSuppliers(keyword: string, limit?: number): Promise<any>;
    /**
     * Search for 1688 suppliers by image
     */
    searchSuppliersByImage(params: {
        imageUrl?: string;
        imageData?: string;
        contentType?: string;
        limit?: number;
    }): Promise<any>;
    /**
     * Search TikTok Shop products
     */
    searchTikTokShop(keyword: string, limit?: number, region?: string): Promise<any>;
    /**
     * Get TikTok Shop product details
     */
    getTikTokProduct(productId: string): Promise<any>;
    /**
     * Get TikTok Shop product reviews (review text, rating, buyer photos)
     */
    getTikTokShopReviews(productId: string, params?: {
        region?: string;
    }): Promise<any>;
    /**
     * Get popular TikTok creators
     */
    getTikTokCreators(params: {
        country?: string;
        followerCount?: string;
        audienceCountry?: string;
        sort?: string;
        limit?: number;
    }): Promise<any>;
    /**
     * Get products from creator videos
     */
    getTikTokCreatorProducts(username: string, params: {
        sort?: string;
        limit?: number;
    }): Promise<any>;
    /**
     * Search TikTok videos by keyword
     */
    searchTikTokVideos(keyword: string, params: {
        limit?: number;
        region?: string;
        hasProductLink?: boolean;
    }): Promise<any>;
    /**
     * Get trending TikTok videos
     */
    getTikTokTrending(params: {
        region?: string;
        timePeriod?: string;
        hasProductLink?: boolean;
        limit?: number;
    }): Promise<any>;
    /**
     * Get video insights (details + transcript + comments)
     */
    getTikTokVideoInsights(url: string, params: {
        includeTranscript?: boolean;
        includeComments?: boolean;
    }): Promise<any>;
    /**
     * Get popular hashtags
     */
    getTikTokHashtags(params: {
        region?: string;
        limit?: number;
    }): Promise<any>;
    /**
     * Search Instagram Reels
     */
    searchInstagramReels(keyword: string, params: {
        limit?: number;
        minPlays?: number;
    }): Promise<any>;
    /**
     * Get creator Reels
     */
    getInstagramCreatorReels(username: string, params: {
        limit?: number;
    }): Promise<any>;
    /**
     * Get Reel insights (details + transcript + comments)
     */
    getInstagramReelInsights(url: string, params: {
        includeTranscript?: boolean;
        includeComments?: boolean;
    }): Promise<any>;
    /**
     * Get Instagram profile
     */
    getInstagramProfile(username: string): Promise<any>;
    /**
     * Search Shein products
     */
    searchShein(keyword: string, params: {
        limit?: number;
        country?: string;
        currency?: string;
        language?: string;
    }): Promise<any>;
    /**
     * Search Temu products
     */
    searchTemu(keyword: string, params: {
        limit?: number;
        currency?: string;
    }): Promise<any>;
    searchDouyinVideos(keyword: string, params?: {
        cursor?: number;
        sortType?: string;
        publishTime?: string;
        filterDuration?: string;
    }): Promise<any>;
    getDouyinVideoDetail(awemeId: string): Promise<any>;
    getDouyinVideoByUrl(shareUrl: string): Promise<any>;
    getDouyinVideoDownloadUrl(awemeId: string): Promise<any>;
    getDouyinVideoComments(awemeId: string, count?: number): Promise<any>;
    getDouyinVideoInsights(awemeId: string, params?: {
        includeComments?: boolean;
    }): Promise<any>;
    searchDouyinUsers(keyword: string, cursor?: number): Promise<any>;
    getDouyinUserProfile(secUserId: string): Promise<any>;
    getDouyinUserVideos(secUserId: string, params?: {
        count?: number;
        maxCursor?: number;
    }): Promise<any>;
    getDouyinHotSearch(): Promise<any>;
    getDouyinChallenges(params?: {
        page?: number;
        pageSize?: number;
    }): Promise<any>;
    getDouyinBillboard(params?: {
        page?: number;
        pageSize?: number;
        type?: string;
        snapshotTime?: string;
        startDate?: string;
        endDate?: string;
    }): Promise<any>;
    searchDouyinChallenges(keyword: string, cursor?: number): Promise<any>;
    getDouyinProductReviews(productId: string, shopId: string, count?: number, sortType?: number): Promise<any>;
    getDouyinProduct(productId: string, shopId: string, authorId?: string): Promise<any>;
    searchXhsNotes(keyword: string, params?: {
        page?: number;
        sortType?: string;
        noteType?: string;
    }): Promise<any>;
    getXhsNoteDetail(noteId: string): Promise<any>;
    getXhsUserProfile(userId: string): Promise<any>;
    getXhsUserNotes(userId: string, params?: {
        cursor?: string;
    }): Promise<any>;
    searchRedditPosts(query: string, params?: {
        sort?: string;
        timeframe?: string;
    }): Promise<any>;
    getRedditSubreddit(subreddit: string, params?: {
        sort?: string;
        timeframe?: string;
    }): Promise<any>;
    getRedditSubredditInfo(subreddit: string): Promise<any>;
    getRedditPostComments(postUrl: string): Promise<any>;
    searchRedditAds(query: string, params?: {
        industries?: string;
    }): Promise<any>;
    discoverRedditTrends(query: string, params?: {
        subreddits?: string;
        timeframe?: string;
    }): Promise<any>;
    searchTwitter(keyword: string, params?: {
        searchType?: string;
    }): Promise<any>;
    getTwitterTrending(): Promise<any>;
    getTwitterProfile(screenName: string): Promise<any>;
    getTwitterTweet(tweetId: string): Promise<any>;
    getTwitterComments(tweetId: string): Promise<any>;
    getTwitterFollowers(screenName: string): Promise<any>;
    getTwitterTopTweets(screenName: string): Promise<any>;
    getTwitterTranscript(tweetUrl: string): Promise<any>;
    getTwitterCommunity(communityUrl: string): Promise<any>;
    getTwitterCommunityTweets(communityUrl: string): Promise<any>;
    discoverTwitterTrends(keyword?: string): Promise<any>;
    searchTaobao(keyword: string, params?: {
        page?: number;
        sort?: string;
        tmall?: boolean;
        startPrice?: number;
        endPrice?: number;
    }): Promise<any>;
    getTaobaoDetail(itemId: string): Promise<any>;
    getTaobaoComments(itemId: string, params?: {
        page?: number;
    }): Promise<any>;
    getTaobaoInsights(itemId: string): Promise<any>;
    getKeepaProduct(asin: string, params?: {
        domain?: string;
        stats?: number;
        days?: number;
        buybox?: boolean;
        rating?: boolean;
        offers?: number;
    }): Promise<any>;
    keepaSearch(selection: Record<string, unknown>, params?: {
        domain?: string;
        page?: number;
        perPage?: number;
    }): Promise<any>;
    getKeepaBestsellers(category: number, params?: {
        domain?: string;
        range?: number;
    }): Promise<any>;
    getKeepaSeller(sellerId: string, params?: {
        domain?: string;
        storefront?: boolean;
    }): Promise<any>;
    getKeepaDeals(selection: Record<string, unknown>, params?: {
        domain?: string;
    }): Promise<any>;
    getKeepaCategory(category: number, params?: {
        domain?: string;
        parents?: boolean;
    }): Promise<any>;
    searchKeepaCategories(term: string, params?: {
        domain?: string;
    }): Promise<any>;
    getKeepaGraph(asin: string, params?: {
        domain?: string;
        width?: number;
        height?: number;
    }): Promise<Buffer>;
    getKeepaTokens(): Promise<any>;
    getKeepaHistory(asin: string, type: string, params?: {
        domain?: string;
        days?: number;
    }): Promise<any>;
    /** Generic GET helper for simple /api/* routes */
    private get;
    getSpKeywords(asin: string, marketplace?: string): Promise<any>;
    getSpKeywordsMine(keyword: string, marketplace?: string): Promise<any>;
    getSpKeywordsOrder(asin: string, marketplace?: string, reverseType?: string, date?: string): Promise<any>;
    getSpKeywordsResearch(keyword: string, marketplace?: string): Promise<any>;
    getSpKeywordsTrends(keyword: string, marketplace?: string): Promise<any>;
    getSpTrafficStats(asin: string, marketplace?: string): Promise<any>;
    getSpTrafficSource(asin: string, marketplace?: string): Promise<any>;
    getSpTrafficListing(asin: string, marketplace?: string): Promise<any>;
    getSpTrafficRelated(asin: string, marketplace?: string): Promise<any>;
    getSpTrafficExtend(asin: string, marketplace?: string): Promise<any>;
    getSpPredict(asin: string, marketplace?: string): Promise<any>;
    getSpCompetitors(asin: string, marketplace?: string): Promise<any>;
    getSpCoupon(asin: string, marketplace?: string): Promise<any>;
    getSpCategory(keyword: string, marketplace?: string): Promise<any>;
    getSpMarket(nodeIdPath: string, marketplace?: string, month?: string, topN?: number): Promise<any>;
    private getSpMarketRoute;
    getSpMarketStats(nodeIdPath: string, marketplace?: string, month?: string, topN?: number): Promise<any>;
    getSpBrands(nodeIdPath: string, marketplace?: string, month?: string, topN?: number): Promise<any>;
    getSpSellers(nodeIdPath: string, marketplace?: string, month?: string, topN?: number): Promise<any>;
    getSpDemand(nodeIdPath: string, marketplace?: string, month?: string, topN?: number): Promise<any>;
    getSpPrices(nodeIdPath: string, marketplace?: string, month?: string, topN?: number): Promise<any>;
    getSpRatings(nodeIdPath: string, marketplace?: string, month?: string, topN?: number): Promise<any>;
    getSpRatingValues(nodeIdPath: string, marketplace?: string, month?: string, topN?: number): Promise<any>;
    getSpListingDates(nodeIdPath: string, marketplace?: string, month?: string, topN?: number): Promise<any>;
    getSpListingTrends(nodeIdPath: string, marketplace?: string, month?: string, topN?: number): Promise<any>;
    getSpSellerCountries(nodeIdPath: string, marketplace?: string, month?: string, topN?: number): Promise<any>;
    getSpSellerTypes(nodeIdPath: string, marketplace?: string, month?: string, topN?: number): Promise<any>;
    getSpEbc(nodeIdPath: string, marketplace?: string, month?: string, topN?: number): Promise<any>;
    getSpProductConcentration(nodeIdPath: string, marketplace?: string, month?: string, topN?: number): Promise<any>;
    getSpGoogleTrend(keyword: string, marketplace?: string): Promise<any>;
    getSpAbaWeekly(keyword: string, marketplace?: string): Promise<any>;
    getSpAbaMonthly(keyword: string, marketplace?: string): Promise<any>;
    getSpAbaTrend(keyword: string, marketplace?: string): Promise<any>;
    /**
     * IP infringement pre-screen via Zhihuiya patent image search
     */
    ipCheck(params: {
        imageUrl?: string;
        imageData?: string;
        contentType?: string;
        productUrl?: string;
        country: string;
        platform: string;
        limit?: number;
    }): Promise<any>;
    /**
     * Health check
     */
    health(): Promise<{
        status: string;
        timestamp: string;
        environment: string;
    }>;
    /**
     * 拿可播放视频 + metadata (完整 pipeline)
     */
    fetchWechatChannelsVideo(opts: {
        url?: string;
        exportId?: string;
    }): Promise<any>;
    /**
     * 只拿 metadata, 不下载/解密视频 (省 S3 流量)
     */
    fetchWechatChannelsMetadata(opts: {
        url?: string;
        exportId?: string;
    }): Promise<any>;
}
export declare const api: ApiClient;
//# sourceMappingURL=api.d.ts.map