SwiftSearch API
Real-time web search with automatic content extraction, contact discovery, and social profile detection. Get structured results from the latest web content.
Quick Example
Search with automatic content extraction
curl -X POST https://www.searchhive.dev/api/v1/swiftsearch \
-H "Authorization": "Bearer: sk_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"query": "Bitcoin price 2025",
"max_results": 10,
"auto_scrape_top": 3,
"include_contacts": true,
"include_social": false
}'API Endpoint
https://www.searchhive.dev/api/v1/swiftsearchExecute a real-time web search with optional content extraction and data enrichment
Base URL
https://www.searchhive.dev/apiParameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Required | The search query to execute. Use natural language or specific keywords. Example: |
max_results | integer | Optional | Maximum number of search results to return. Must be between 1 and 50. Default: 10 Example: |
auto_scrape_top | integer | Optional | Automatically scrape content from the top N results. Costs 3 credits per scraped page. Example: |
include_contacts | boolean | Optional | Extract contact information from scraped content. Requires Starter plan or higher. Costs +5 credits. Default: false Example: |
include_social | boolean | Optional | Discover social media profiles mentioned in results. Requires Builder plan or higher. Costs +5 credits. Default: false Example: |
Feature Access by Plan
Credit Calculation
SwiftSearch uses a flexible credit system based on the features you use. Here's how credits are calculated:
Basic search (10 results)
{"query": "AI news", "max_results": 10}Search + auto-scrape 3 pages
{"query": "AI news", "auto_scrape_top": 3}Search + scraping + contacts
{"query": "AI news", "auto_scrape_top": 3, "include_contacts": true}Full featured search
{"query": "AI news", "auto_scrape_top": 3, "include_contacts": true, "include_social": true}Credit optimization
auto_scrape_top, include_contacts, and include_social when you actually need the additional data to minimize credit usage.Response Format
Response Fields
| Field | Type | Description |
|---|---|---|
query | string | The original search query that was executed |
search_results | array | Array of search results with title, URL, snippet, position, and date |
scraped_content | array | Content from automatically scraped pages (if auto_scrape_top was used) |
contacts | array | Extracted contact information (if include_contacts was true) |
social_profiles | array | Discovered social media profiles (if include_social was true) |
credits_used | integer | Total credits consumed by this request |
remaining_credits | integer | Your remaining credit balance after this request |
results_count | integer | Number of search results returned |
scraped_count | integer | Number of pages that were automatically scraped |
Example Success Response
SwiftSearch API response
{
"query": "Bitcoin price 2025",
"search_results": [
{
"title": "Bitcoin Price Prediction: Will BTC Hit $150K by 2025?",
"link": "https://example.com/bitcoin-prediction",
"snippet": "Experts predict Bitcoin could reach $150,000 by end of 2025 driven by institutional adoption...",
"position": 1,
"date": "2025-07-20"
},
{
"title": "Crypto Market Analysis: BTC Long-term Outlook",
"link": "https://example.com/crypto-analysis",
"snippet": "Technical analysis suggests Bitcoin is entering a new bull cycle...",
"position": 2,
"date": "2025-07-19"
}
],
"scraped_content": [
{
"url": "https://example.com/bitcoin-prediction",
"title": "Bitcoin Price Prediction: Will BTC Hit $150K by 2025?",
"text": "The cryptocurrency market has been experiencing unprecedented growth...",
"error": null
}
],
"contacts": [
{
"email": "analyst@cryptoinsights.com",
"name": "John Smith",
"company": "Crypto Insights",
"source_url": "https://example.com/bitcoin-prediction"
}
],
"credits_used": 9,
"remaining_credits": 4991,
"results_count": 2,
"scraped_count": 1
}Response Codes
Rate Limits
| Plan | Requests/Hour | Requests/Minute | Concurrent |
|---|---|---|---|
| Free | 10 | 1 | 1 |
| Starter | 1,000 | 50 | 5 |
| Builder | 5,000 | 100 | 10 |
| Unicorn | 20,000 | 500 | 25 |
Rate limit headers
X-RateLimit-Remaining and X-RateLimit-Reset to help you track your usage.