QuickSerp API Documentation

Welcome to the QuickSerp API documentation. Our API provides access to search engine results, URL scraping, and YouTube transcript services.

API Base URL

https://quickserp.com/api

Authentication

All API requests require authentication using a Bearer token. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Google Search API

Retrieve Google search results with rich metadata.

GET /google

Query Parameters

• q (required): Search query
• country: Target country (default: "United States")
• lang: Language code (default: "en")
• num: Number of results (default: 10)

curl -X GET "https://quickserp.com/api/google?q=search+term" \
-H "Authorization: Bearer YOUR_API_KEY"

curl -X GET "https://quickserp.com/api/google?q=search+term" \
-H "Authorization: Bearer YOUR_API_KEY"

URL Scraping API

Extract content from any webpage in markdown format.

GET /scrape-url

Query Parameters

• url (required): The URL to scrape

YouTube Transcript API

Extract transcripts from YouTube videos.

GET /youtube-transcript

Query Parameters

• videoId (required): YouTube video ID

Response Formats

Google Search Response

{
  "organicResults": [
    {
      "position": 1,
      "title": "Result title",
      "link": "https://example.com",
      "snippet": "Result description",
      "displayedLink": "example.com"
    }
  ],
  "peopleAlsoAskedFor": ["Related question 1", "Related question 2"],
  "relatedSearches": ["Related search 1", "Related search 2"]
}

URL Scraping Response

{
  "url": "https://example.com",
  "pageTitle": "Page Title",
  "markdown": "Extracted content in markdown format"
}

YouTube Transcript Response

{
  "message": "Video details fetched successfully",
  "transcripts": "Full transcript text",
  "video_title": "Video title"
}

Error Handling

All endpoints return standard HTTP status codes. Common error responses:

{
  "error": "Error message"
}

// Common Status Codes:
// 400 - Bad Request
// 401 - Unauthorized (Invalid API key)
// 404 - Not Found
// 500 - Internal Server Error

Rate Limiting

Our API implements caching with a 1-hour cache duration and a 24-hour stale-while-revalidate period for optimal performance.