Santech API Hub Documentation

website·Indexed 29 days ago

https://santech.gitbook.io/docs

A comprehensive platform providing a wide range of RESTful APIs, including specialized tools for Ecommerce, Music, Currency conversion, Quotes, Dictionary, Anime, Books, Weather, and a Jarvis AI assistant powered by Gemini Flash. The hub offers documentation on API keys, authentication, and implementation for various data services including News, Sports Players, Stocks, and University listings.

Tokens
11.6K
Snippets
115
Records
117
Agent score
50%

What's inside Santech API Hub

  1. Search for anime and series details

    Use the /animedetails/search/{:q} endpoint to retrieve structured information about anime shows and series. The response includes details such as titles, plot summaries, genres, episode counts, images, and related works. This endpoint requires a GET request and a keyword parameter in the URL path.
    # Example request to search for 'naruto'
    GET https://santechapi.vercel.app/animedetails/search/naruto
  2. Search for books by name

    Use the /books/search/{q} endpoint to retrieve a structured collection of information about books, including titles, authors, publication details, summaries, and ratings. The request requires a keyword search term passed as a path parameter.
    # Example request
    GET https://santechapi.vercel.app/books/search/Wings%20of%20fire
  3. Understand the Giphy & Stickers API response structure

    The Giphy & Stickers API returns a JSON response containing an array of media objects, a meta object for request status, and a pagination object for result set navigation. Each media object includes detailed information about the GIF/sticker, the creating user's profile, and analytics tracking URLs for onload, onclick, and onsent events.
    {
      "data": [
        {
          "user": {
            "username": "aahsocute",
            "display_name": "aahsocute",
            "profile_url": "https://giphy.com/aahsocute/",
            "is_verified": true
          },
          "analytics": {
            "onload": { "url": "..." },
            "onclick": { "url": "..." },
            "onsent": { "url": "..." }
          },
          "alt_text": "Sticker gif. Colorful stack of books..."
        }
      ],
      "meta": {
        "status": 200,
        "msg": "OK",
        "response_id": "u8iadrar2ztes1pe6cldoqxdyyz4uefsofjf8b7c"
      },
      "pagination": {
        "total_count": 500,
        "count": 50,
        "offset": 0
      }
    }
  4. Fetch movie details by title

    Retrieve detailed information about a movie, including ratings, cast, and plot, by providing a search query in the URL path.

    • Base URL: https://santechapi.vercel.app
    • Endpoint: /movieandseries/movie/{q}
    • Method: GET
    • Parameter: {q} is the movie title or search text.
    # Example request for the movie 'John Q'
    curl -H "token: YOUR_API_KEY" https://santechapi.vercel.app/movieandseries/movie/John%20Q
  5. Fetch series details by title

    Retrieve detailed information about a TV series, including ratings, cast, and plot, by providing a search query in the URL path.

    • Base URL: https://santechapi.vercel.app
    • Endpoint: /movieandseries/series/{q}
    • Method: GET
    • Parameter: {q} is the series title or search text.
    # Example request for 'Harry Potter'
    curl -H "token: YOUR_API_KEY" https://santechapi.vercel.app/movieandseries/series/Harry%20Potter
  6. Retrieve sports player details using Sports Player API

    The Sports Player API allows you to fetch specific details about sports players. The endpoint follows the pattern /sports/player/{playerName}.
    # Example: Fetch details for Dhoni
    curl https://santechapi.vercel.app/sports/player/dhoni
  7. Connect to the Santhosh Technologies REST API

    The Santhosh Technologies API is a RESTful service. All requests must be sent to the base URL https://santechapi.vercel.app/. To authenticate, you must include your API key in the request header using the key token.
    GET / HTTP/1.1
    Host: santechapi.vercel.app
    token: {YOUR_API_KEY}
  8. Generate and use SanTech API keys for authentication

    To access SanTech APIs, you must sign up for an account, select a pricing plan, and generate API keys via the API Hub. You can generate up to three API keys per account. These keys act as authentication tokens and must be passed in the headers of every API request to authorize access to the subscribed endpoints.
  9. Understand the News API search response structure

    The GET /news/search/{q} endpoint returns a list of news articles. Each article object contains metadata including the source of the news, author, title, a brief description, the original URL, an image URL, the publication timestamp, and a snippet of the article content.
    [
      {
        "source": {
          "id": "the-times-of-india",
          "name": "The Times of India"
        },
        "author": "PTI",
        "title": "Example Article Title",
        "description": "A brief summary of the news article...",
        "url": "https://example.com/article",
        "urlToImage": "https://example.com/image.jpg",
        "publishedAt": "2024-09-26T04:16:50Z",
        "content": "Full text snippet of the article... [+4114 chars]"
      }
    ]
  10. Search for recipes using the Recipe API

    The Recipe API allows you to fetch recipes and nutritional data (calories and macronutrients) based on a search query. To perform a search, send a GET request to the recipe/search/{:q} endpoint, where {:q} is the search term provided by the user.
    # Example request to search for 'upma'
    GET https://santechapi.vercel.app/recipe/search/upma
  11. Fetch city location details using the Maps API

    The Maps API allows you to retrieve real-world location data, such as coordinates and city information. To fetch details for a specific city, use the maps/city/:q endpoint where :q is the city name.
    # Example request
    GET https://santechapi.vercel.app/maps/city/chennai