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"
  ]
}

​
People also search for

The PeopleAlsoSearchForEntity extends the SearchEntity to provide specific fields for related search terms.

​
Definition

PeopleAlsoSearchForEntity

interface PeopleAlsoSearchForEntity extends SearchEntity {
  fields?: Array<
    | "text"
    | "link"
    | "position"
  >;
}
Below are the key definitions related to the PeopleAlsoSearchForEntity fields:
PropertyDescription
textThe related search term text.
linkThe URL link to the related search results (Google link).
positionThe position of the related search term in the results.

​
Example

Below is an example of a PeopleAlsoSearchForEntity request and response: 
{
  "query": "Evergreen Media",
  "countryCode": "at",
  "languageCode": "de"
}

​
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!