Name: Random Quote API: Get Inspiring Quotes with Author
Brand: skycraft
SKU: api-skycraft-retrieve-random-quote
Availability: InStock
Author: API Market

Pulkit


# retrieve-random-quote

## Overview

The `retrieve-random-quote` API provides access to a collection of curated quotes from famous figures, delivering a random quote in English upon request. This API is designed to be simple and straightforward, ideal for enriching applications with insightful and thought-provoking content. You can optionally specify a minimum and maximum length for the quote.

## Features

*   **Random Quote Generation:** Retrieves a random quote from a diverse collection.
*   **Quote Length Filtering:** Allows specifying minimum and maximum length constraints for the quote.
*   **Simple JSON Response:** Returns the quote and its author in a clean and easy-to-parse JSON format.

## Use Cases

*   **Education Platforms:** Integrate quotes into educational applications to stimulate thought and discussion. For instance, adding a relevant quote to the end of a lesson or chapter.
*   **Content Enrichment:** Enhance blog posts, articles, or social media content with a relevant quote to add depth and perspective.
*   **Motivational Apps:** Provide users with daily motivational quotes to inspire and encourage them.
*   **Chatbots:** Use the API to generate interesting responses in chatbots, adding a touch of wisdom and personality.
*   **Creative Writing Prompts:** Generate random quotes to spark creativity and overcome writer's block.

## API Documentation

### Base URL

All API requests should be made to: `https://prod.api.market/api/v1/magicapi/retrieve-random-quote`

### Authentication

Authentication is handled via API key. Include your API key in the request header:

```
x-api-market-key: YOUR_API_MARKET_KEY
```

### Endpoints

#### GET /retrieve-random-quote

This endpoint retrieves a random quote.

**Parameters:**

*   `min-length` (optional, integer): The minimum length of the quote in letters (1-10000). Example: `120`
*   `max-length` (optional, integer): The maximum length of the quote in letters (1-10000). Example: `300`
*   `x-api-market-key` (required, header): API.market API Key

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/magicapi/retrieve-random-quote/retrieve-random-quote?min-length=120&max-length=300" -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (Success - 200 OK):**

```json
{
  "author": "Francis Bacon",
  "quote": "A little philosophy inclineth man's mind to atheism, but depth in philosophy bringeth men's minds about to religion."
}
```

**Example Response (Success - 200 OK) - empty author:**

```json
{
  "author": null,
  "quote": "This is a quote."
}
```

### Status Codes

*   **200 OK:** Request successful. The quote is returned in the response body.
*   **401 Unauthorized:** Missing or invalid API key. Ensure the `x-api-market-key` header is present and contains a valid API key.
*   **402 Payment Required:** Payment is required to use this API.
*   **403 Forbidden:** Valid API key but insufficient permissions to access the resource.
*   **404 Not Found:** The requested resource was not found (likely a typo in the URL).
*   **406 Not Acceptable:** The server cannot produce a response matching the request's `Accept` headers.
*   **429 Too Many Requests:** Rate limit exceeded. See the Rate Limits section for more information.

## Rate Limits

Rate limits are applied to prevent abuse and ensure fair usage of the API. If you exceed the rate limit, you will receive a `429 Too Many Requests` error. Please contact us if you require a higher rate limit.

## Error Handling

The API returns errors in JSON format. The error response includes a `code` and a `message` to help you understand the problem.

**Example Error Response:**

```json
{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key",
    "status": 401
  }
}
```

Common errors and how to resolve them:

*   **unauthorized:** Invalid API key. Double-check your API key and ensure it is included in the `x-api-market-key` header.
*   **too_many_requests:** Rate limit exceeded. Wait a few seconds and try again, or contact us to request a higher rate limit.
*   **bad_request:** Invalid input parameters. Check if the query parameters are correct

## Implementation Guide

### Example Code

Since the API is synchronous, polling is not necessary. The following examples demonstrate basic usage.

```javascript
// JavaScript example
const apiKey = "YOUR_API_MARKET_KEY";
const baseUrl = "https://prod.api.market/api/v1/magicapi/retrieve-random-quote";

async function getRandomQuote(minLength, maxLength) {
  try {
    let url = `${baseUrl}/retrieve-random-quote`;
    if (minLength || maxLength) {
        url += "?"
        if (minLength) {
            url += `min-length=${minLength}`
        }
        if (minLength && maxLength) {
            url += "&"
        }
        if (maxLength) {
            url += `max-length=${maxLength}`
        }
    }

    const response = await fetch(url, {
      method: "GET",
      headers: {
        "x-api-market-key": apiKey
      },
    });

    if (!response.ok) {
      throw new Error(`API error: ${response.status} ${response.statusText}`);
    }

    const data = await response.json();
    return data;
  } catch (error) {
    console.error("Error:", error);
    throw error;
  }
}

// Example usage:
getRandomQuote(100, 200)
  .then(quote => console.log(quote))
  .catch(error => console.error("Failed to get quote:", error));
```

```python
# Python example
import requests

API_KEY = "YOUR_API_MARKET_KEY"
BASE_URL = "https://prod.api.market/api/v1/magicapi/retrieve-random-quote"

def get_random_quote(min_length=None, max_length=None):
    headers = {
        "x-api-market-key": API_KEY
    }
    params = {}
    if min_length:
        params["min-length"] = min_length
    if max_length:
        params["max-length"] = max_length
    
    response = requests.get(f"{BASE_URL}/retrieve-random-quote", headers=headers, params=params)
    
    if response.status_code != 200:
        raise Exception(f"API error: {response.status_code} {response.text}")
    
    return response.json()

# Example usage:
try:
    quote = get_random_quote(min_length=100, max_length=200)
    print(quote)
except Exception as e:
    print(f"Failed to get quote: {e}")
```

```bash
# cURL example
curl -X GET "https://prod.api.market/api/v1/magicapi/retrieve-random-quote/retrieve-random-quote?min-length=120&max-length=300" -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

### Performance Optimization

*   Cache the results if you are making frequent requests with the same parameters.
*   Specify `min-length` and `max-length` only when necessary, as they may slightly increase response time.

## FAQ

**Q: What kind of quotes does the API provide?**

A: The API provides quotes from a variety of famous figures, covering a wide range of topics and historical periods. The quotes are all in English.

**Q: How often is the quote collection updated?**

A: The quote collection is updated periodically with new quotes.

**Q: Can I request quotes from a specific author or category?**

A: Currently, the API only supports retrieving random quotes with length filtering. Support for specific authors or categories may be added in the future.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@api.market.
```

Get random quotes from famous people with author attribution using our API. Filter quotes by length. Free to use!

Random Quote API: Get Inspiring Quotes with Author

FREE