API Overview
Simple, RESTful APIs to enhance your applications
Free
No API keys required
Fast
Sub-100ms response times
Simple
JSON responses
Search Suggestions API
Get search suggestions for tool discovery
Endpoint
GET https://30tools.com/api/suggestions?q={query}
Parameters
| Parameter | Type | Description |
|---|---|---|
| q | string | Search query (required) |
Example Request
curl https://30tools.com/api/suggestions?q=image
Example Response
[
"image",
[
"image compressor",
"image optimizer",
"image converter",
"image minimizer"
]
]
Rate Limits & Usage
Fair usage policies and limits
Rate Limits
- 1000 requests per hour per IP address
- 10 requests per second per IP address
- No authentication required for basic usage
Response Headers
| Header | Description |
|---|---|
| X-RateLimit-Limit | Requests per hour limit |
| X-RateLimit-Remaining | Remaining requests this hour |
| X-RateLimit-Reset | Time when limit resets |
Code Examples
Integration examples in popular languages
JavaScript (Fetch)
async function getSearchSuggestions(query) {
const response = await fetch(
`https://30tools.com/api/suggestions?q=${encodeURIComponent(query)}`
);
const [originalQuery, suggestions] = await response.json();
return suggestions;
}
// Usage
const suggestions = await getSearchSuggestions('image');
console.log(suggestions); // ['image compressor', 'image optimizer', ...]
Python (requests)
import requests
def get_search_suggestions(query):
url = f"https://30tools.com/api/suggestions"
params = {"q": query}
response = requests.get(url, params=params)
original_query, suggestions = response.json()
return suggestions
# Usage
suggestions = get_search_suggestions("image")
print(suggestions) # ['image compressor', 'image optimizer', ...]
PHP (cURL)
function getSearchSuggestions($query) {
$url = 'https://30tools.com/api/suggestions?q=' . urlencode($query);
$response = file_get_contents($url);
$data = json_decode($response, true);
return $data[1]; // Return suggestions array
}
// Usage
$suggestions = getSearchSuggestions('image');
print_r($suggestions); // Array of suggestions