Skip to main content
We’ve built a high-performance Rust module that retrieves results from over 96 billion public data points, including Web, Images, Shopping, Videos, News, and more. Tedi is now more powerful than any AI agent or chat system when it comes to accessing real-time public data.

Definition

Below are the key definitions related to the SearchEntity:
SearchEntity
interface SearchEntity {
  query: string;
  maxResults: number;
  countryCode?: string;
  languageCode?: string;
  fields?: SubEntityFields;
}
PropertyDescription
queryThe search query string used to perform the search.
maxResultsThe maximum number of search results to return.
countryCodeThe ISO 3166-1 alpha-2 country code to tailor search results to a specific country.
languageCodeThe ISO 639-1 language code to specify the language of the search results.
fieldsAn array specifying which fields to include in the search results.
The WebSearchEntity extends the SearchEntity to provide specific fields for web search results.

Definition

WebSearchEntity
interface WebSearchEntity extends SearchEntity {
  fields?: Array<
    | "title" 
    | "url" 
    | "description" 
    | "position"
  >;
}
Below are the key definitions related to the WebSearchEntity fields:
PropertyDescription
titleThe title of the web page.
urlThe URL of the web page.
descriptionA brief description of the web page.
positionThe position of the web page in the search results.

Example

Below is an example of a WebSearchEntity request and response:
{
  "query": "Evergreen Media AR GmbH",
  "maxResults": 5
}
The ImageSearchEntity extends the SearchEntity to provide specific fields for image search results.

Definition

ImageSearchEntityFields
interface ImageSearchEntity extends SearchEntity {
  fields?: Array<
    | "title"
    | "source_link"
    | "source_name"
    | "image_link"
    | "image_alt"
    | "position"
  >;
}
Below are the key definitions related to the ImageSearchEntity fields:
PropertyDescription
titleThe title of the search.
source_linkThe URL of the page where the image is found.
source_nameThe name of the source website.
image_linkThe direct URL to the image.
image_altThe alt text of the image.
positionThe position of the image in the search results.

Example

Below is an example of an ImageSearchEntity request and response:
{
  "query": "Evergreen Media AR GmbH",
  "maxResults": 5,
  "countryCode": "at",
  "languageCode": "de"
}
The VideoSearchEntity extends the SearchEntity to provide specific fields for video search results.

Definition

VideoSearchEntity
interface VideoSearchEntity extends SearchEntity {
  fields?: Array<
    | "title"
    | "description"
    | "link"
    | "image"
    | "duration"
    | "duration_seconds"
    | "position"
  >;
}
Below are the key definitions related to the VideoSearchEntity fields:
PropertyDescription
titleThe title of the video.
descriptionA brief description of the video.
linkThe URL link to the video.
imageThe thumbnail image URL of the video.
durationThe duration of the video in a human-readable format (e.g., “5:30”).
duration_secondsThe duration of the video in total seconds (e.g., 330).
positionThe position of the video in the search results.

Example

Below is an example of a VideoSearchEntity request and response:
{
  "query": "Evergreen Media AR GmbH",
  "maxResults": 5,
  "countryCode": "at",
  "languageCode": "de"
}
The ShoppingSearchEntity extends the SearchEntity to provide specific fields for shopping search results.

Definition

ShoppingSearchEntity
interface ShoppingSearchEntity extends SearchEntity {
  fields?: Array<
    | "title"
    | "link"
    | "price"
    | "oldPrice"
    | "shop"
    | "distance"
    | "totalReviews"
    | "position"
  >;
}
Below are the key definitions related to the ShoppingSearchEntity fields:
PropertyDescription
titleThe title of the product.
linkThe URL link to the product page.
priceThe current price of the product.
oldPriceThe old price of the product (if available).
shopThe name of the shop or seller.
distanceThe distance to the shop (if applicable).
totalReviewsThe total number of reviews for the product.
positionThe position of the product in the search results.

Example

Below is an example of a ShoppingSearchEntity request and response:
{
  "query": "iphone 17 kaufen in Innsbruck",
  "countryCode": "at",
  "languageCode": "de",
  "maxResults": 5
}
The NewsSearchEntity extends the SearchEntity to provide specific fields for news search results.

Definition

NewsSearchEntity

interface NewsSearchEntity extends SearchEntity {
  fields?: Array<
    | "title"
    | "description"
    | "link"
    | "date"
    | "image"
    | "position"
  >;
}
Below are the key definitions related to the NewsSearchEntity fields:
PropertyDescription
titleThe title of the news article.
descriptionA brief description of the news article.
linkThe URL link to the news article.
dateThe publication date of the news article.
imageThe thumbnail image URL of the news article.
positionThe position of the news article in the search results.

Example

Below is an example of a NewsSearchEntity request and response:
{
  "query": "Österreich",
  "countryCode": "at",
  "languageCode": "de",
  "maxResults": 10,
  "fields": [
    "title",
    "link",
    "date"
  ]
}

Future Roadmap

In upcoming updates, our new SearchEntity module will target popular social media platforms and e-commerce sites to provide comprehensive search capabilities across the web. Our SearchEntity module can bypass and solve anti-bot protections on most major platforms, delivering reliable and accurate search results programmatically. We’re currently training Tedi to autonomously create accounts, complete entire sign-up processes, verify email/phone numbers, and perform searches and actions to access data from all major social media platforms.
Expected Release: Late November or early December 2025
If successful, Tedi will access data from platforms like Facebook, Twitter, Instagram, LinkedIn, Amazon, eBay, and more—providing unparalleled search capabilities. This will enhance content retrieval and data extraction across a wide range of online services, expanding our reach to over 200+ billion public data points. This unprecedented access will enable advanced analytics, market research, and content generation at a scale never seen before for our Evergreen Media customers. Stay tuned for more updates as we continue to push the boundaries of what’s possible with Tedi and our SearchEntity module! Usecase Example: E-Commerce Product Search Target amazon.com to search for products, retrieve prices, reviews, and availability data programmatically. Usecase Example: Social Media Content Search Target facebook.com, search all users in Innsbruck, pull all users’ public posts, comments, likes, and other relevant data for analysis and insights. Tedi is able to pull up to 1 million+ records in a single search session within just 3 to 5 minutes.

Conclusion

The SearchEntity module represents a significant advancement in automated search capabilities, allowing users to access a vast array of public data points quickly and efficiently. With its ability to bypass anti-bot protections and deliver structured data across various search types, it sets a new standard for real-time information retrieval. As we continue to expand its capabilities to include social media and e-commerce platforms, the potential applications for businesses and developers are immense. Stay tuned for more updates as we push the boundaries of what’s possible with Tedi and our SearchEntity module!