desearch-py 1.0.9

A Python SDK for interacting with the Desearch API service.

Desearch

Desearch API in Python

https://console.desearch.ai/

Installation

pip install desearch-py

Usage

Import the package and initialize the Desearch client with your API key:

    from desearch_py import Desearch

    desearch = Desearch(api_key="your-api-key")

Common requests

    
    # Desearch AI Search
    result = desearch.ai_search(
        prompt="Bittensor",
        tools=[
            "web",
            "hackernews",
            "reddit",
            "wikipedia",
            "youtube",
            "twitter",
            "arxiv"
        ],
        date_filter="PAST_24_HOURS",
        streaming=False,
        result_type="LINKS_WITH_SUMMARIES",
        system_message="",
        count=10,
    )

    #Desearch Twitter post search
    result = desearch.twitter_links_search(
        prompt="Bittensor", 
        count=10,
    )

    #Desearch Web links search
    result = desearch.web_links_search(
        prompt="Bittensor",
        tools=[
            "web",
            "hackernews",
            "reddit",
            "wikipedia",
            "youtube",
            "arxiv"
        ],
        count=10,
    )

    #Basic Twitter search
    result = desearch.basic_twitter_search(
        query="Whats going on with Bittensor",
        sort="Top",
        user="elonmusk",
        start_date="2024-12-01",
        end_date="2025-02-25",
        lang="en",
        verified=True,
        blue_verified=True,
        is_quote=True,
        is_video=True,
        is_image=True,
        min_retweets=1,
        min_replies=1,
        min_likes=1,
        count=10
    )

    #Basic Web search
    result = desearch.basic_web_search(
        query="latest news on AI",
        num=10,
        start=0
    )

    #Web crawl
    result = desearch.web_crawl(
        "https://docs.desearch.ai/docs/desearch-api"
    )

    #Fetch Tweets by URLs
    result = desearch.twitter_by_urls(
        urls=["https://twitter.com/elonmusk/status/1613000000000000000"]
    )

    #Fetch Tweets by ID
    result = desearch.twitter_by_id(id="123456789")

    #Fetch Tweets by User
    result = desearch.tweets_by_user(
        user="elonmusk",
        query="Bittensor",
        count=10
    )

    #Fetch Latest Tweets
    result = desearch.latest_tweets(
        user="elonmusk",
        count=10
    )

    #Fetch Tweets and Replies by User
    result = desearch.tweets_and_replies_by_user(
        user="elonmusk",
        query="Bittensor",
        count=10
    )

    #Fetch Replies by Post
    result = desearch.twitter_replies_post(
        post_id="123456789",
        count=10
        query="Bittensor"
    )

    #Fetch Retweets by Post
    result = desearch.twitter_retweets_post(
        post_id="123456789",
        count=10,
        query="Bittensor"
    )

    #Fetch Tweeter User
    result = desearch.tweeter_user(
        user="elonmusk")