Search Code Examples
curl --request POST \
--url https://api.wistx.ai/v1/code-examples/search \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"code_types": [
"<string>"
],
"cloud_provider": "<string>",
"services": [
"<string>"
],
"min_quality_score": 123,
"compliance_standard": "<string>",
"limit": 123
}
'import requests
url = "https://api.wistx.ai/v1/code-examples/search"
payload = {
"query": "<string>",
"code_types": ["<string>"],
"cloud_provider": "<string>",
"services": ["<string>"],
"min_quality_score": 123,
"compliance_standard": "<string>",
"limit": 123
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
query: '<string>',
code_types: ['<string>'],
cloud_provider: '<string>',
services: ['<string>'],
min_quality_score: 123,
compliance_standard: '<string>',
limit: 123
})
};
fetch('https://api.wistx.ai/v1/code-examples/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.wistx.ai/v1/code-examples/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'query' => '<string>',
'code_types' => [
'<string>'
],
'cloud_provider' => '<string>',
'services' => [
'<string>'
],
'min_quality_score' => 123,
'compliance_standard' => '<string>',
'limit' => 123
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.wistx.ai/v1/code-examples/search"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"code_types\": [\n \"<string>\"\n ],\n \"cloud_provider\": \"<string>\",\n \"services\": [\n \"<string>\"\n ],\n \"min_quality_score\": 123,\n \"compliance_standard\": \"<string>\",\n \"limit\": 123\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.wistx.ai/v1/code-examples/search")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"code_types\": [\n \"<string>\"\n ],\n \"cloud_provider\": \"<string>\",\n \"services\": [\n \"<string>\"\n ],\n \"min_quality_score\": 123,\n \"compliance_standard\": \"<string>\",\n \"limit\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.wistx.ai/v1/code-examples/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"<string>\",\n \"code_types\": [\n \"<string>\"\n ],\n \"cloud_provider\": \"<string>\",\n \"services\": [\n \"<string>\"\n ],\n \"min_quality_score\": 123,\n \"compliance_standard\": \"<string>\",\n \"limit\": 123\n}"
response = http.request(request)
puts response.read_body{
"data": {
"examples": [
{
"example_id": "ex_abc123",
"title": "Encrypted RDS Instance with Backup",
"description": "Terraform configuration for an encrypted RDS PostgreSQL instance with automated backups",
"contextual_description": "This Terraform code creates a production-ready RDS PostgreSQL database with encryption at rest, automated backups, and multi-AZ deployment. It demonstrates best practices for database security and compliance with PCI-DSS requirements.",
"code_type": "terraform",
"cloud_provider": "aws",
"services": ["rds"],
"resources": ["aws_db_instance", "aws_db_subnet_group", "aws_db_parameter_group"],
"code": "resource \"aws_db_instance\" \"main\" {\n identifier = \"prod-postgres\"\n engine = \"postgres\"\n engine_version = \"15.4\"\n instance_class = \"db.t3.medium\"\n allocated_storage = 100\n storage_encrypted = true\n kms_key_id = aws_kms_key.rds.arn\n db_name = \"mydb\"\n username = \"admin\"\n password = var.db_password\n vpc_security_group_ids = [aws_security_group.rds.id]\n db_subnet_group_name = aws_db_subnet_group.main.name\n backup_retention_period = 7\n backup_window = \"03:00-04:00\"\n maintenance_window = \"mon:04:00-mon:05:00\"\n multi_az = true\n deletion_protection = true\n enabled_cloudwatch_logs_exports = [\"postgresql\", \"upgrade\"]\n performance_insights_enabled = true\n tags = {\n Environment = \"production\"\n Compliance = \"PCI-DSS\"\n }\n}",
"github_url": "https://github.com/terraform-aws-modules/terraform-aws-rds",
"file_path": "examples/postgres/main.tf",
"stars": 1250,
"quality_score": 85,
"best_practices": [
"Encryption at rest enabled",
"Automated backups configured",
"Multi-AZ deployment",
"CloudWatch logging enabled",
"Performance Insights enabled"
],
"hybrid_score": 0.92,
"vector_score": 0.89,
"bm25_score": 0.95,
"compliance_analysis": {
"applicable_standards": ["PCI-DSS", "HIPAA", "SOC2"],
"compliance_score": {
"PCI-DSS": 0.95,
"HIPAA": 0.88,
"SOC2": 0.90
}
},
"cost_analysis": {
"estimated_monthly": 125.50,
"estimated_annual": 1506.00
}
}
],
"total": 1,
"query": "RDS database with encryption"
},
"metadata": {
"request_id": "req_123",
"timestamp": 1234567890.123,
"query_time_ms": 245
}
}
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request parameters",
"details": "query must be at least 3 characters"
},
"metadata": {
"request_id": "req_123",
"timestamp": 1234567890.123
}
}
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or expired token"
},
"metadata": {
"request_id": "req_123",
"timestamp": 1234567890.123
}
}
{
"error": {
"code": "QUOTA_EXCEEDED",
"message": "Query quota exceeded",
"details": {
"limit_type": "queries_per_month",
"current": 1000,
"limit": 1000
}
},
"metadata": {
"request_id": "req_123",
"timestamp": 1234567890.123
}
}
{
"error": {
"code": "INTERNAL_ERROR",
"message": "Failed to search code examples"
},
"metadata": {
"request_id": "req_123",
"timestamp": 1234567890.123
}
}
{
"error": {
"code": "DATABASE_ERROR",
"message": "Database connection failed"
},
"metadata": {
"request_id": "req_123",
"timestamp": 1234567890.123
}
}
Search
Search Code Examples
Search infrastructure code examples from curated repositories
POST
/
v1
/
code-examples
/
search
Search Code Examples
curl --request POST \
--url https://api.wistx.ai/v1/code-examples/search \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"code_types": [
"<string>"
],
"cloud_provider": "<string>",
"services": [
"<string>"
],
"min_quality_score": 123,
"compliance_standard": "<string>",
"limit": 123
}
'import requests
url = "https://api.wistx.ai/v1/code-examples/search"
payload = {
"query": "<string>",
"code_types": ["<string>"],
"cloud_provider": "<string>",
"services": ["<string>"],
"min_quality_score": 123,
"compliance_standard": "<string>",
"limit": 123
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
query: '<string>',
code_types: ['<string>'],
cloud_provider: '<string>',
services: ['<string>'],
min_quality_score: 123,
compliance_standard: '<string>',
limit: 123
})
};
fetch('https://api.wistx.ai/v1/code-examples/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.wistx.ai/v1/code-examples/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'query' => '<string>',
'code_types' => [
'<string>'
],
'cloud_provider' => '<string>',
'services' => [
'<string>'
],
'min_quality_score' => 123,
'compliance_standard' => '<string>',
'limit' => 123
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.wistx.ai/v1/code-examples/search"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"code_types\": [\n \"<string>\"\n ],\n \"cloud_provider\": \"<string>\",\n \"services\": [\n \"<string>\"\n ],\n \"min_quality_score\": 123,\n \"compliance_standard\": \"<string>\",\n \"limit\": 123\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.wistx.ai/v1/code-examples/search")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"code_types\": [\n \"<string>\"\n ],\n \"cloud_provider\": \"<string>\",\n \"services\": [\n \"<string>\"\n ],\n \"min_quality_score\": 123,\n \"compliance_standard\": \"<string>\",\n \"limit\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.wistx.ai/v1/code-examples/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"<string>\",\n \"code_types\": [\n \"<string>\"\n ],\n \"cloud_provider\": \"<string>\",\n \"services\": [\n \"<string>\"\n ],\n \"min_quality_score\": 123,\n \"compliance_standard\": \"<string>\",\n \"limit\": 123\n}"
response = http.request(request)
puts response.read_body{
"data": {
"examples": [
{
"example_id": "ex_abc123",
"title": "Encrypted RDS Instance with Backup",
"description": "Terraform configuration for an encrypted RDS PostgreSQL instance with automated backups",
"contextual_description": "This Terraform code creates a production-ready RDS PostgreSQL database with encryption at rest, automated backups, and multi-AZ deployment. It demonstrates best practices for database security and compliance with PCI-DSS requirements.",
"code_type": "terraform",
"cloud_provider": "aws",
"services": ["rds"],
"resources": ["aws_db_instance", "aws_db_subnet_group", "aws_db_parameter_group"],
"code": "resource \"aws_db_instance\" \"main\" {\n identifier = \"prod-postgres\"\n engine = \"postgres\"\n engine_version = \"15.4\"\n instance_class = \"db.t3.medium\"\n allocated_storage = 100\n storage_encrypted = true\n kms_key_id = aws_kms_key.rds.arn\n db_name = \"mydb\"\n username = \"admin\"\n password = var.db_password\n vpc_security_group_ids = [aws_security_group.rds.id]\n db_subnet_group_name = aws_db_subnet_group.main.name\n backup_retention_period = 7\n backup_window = \"03:00-04:00\"\n maintenance_window = \"mon:04:00-mon:05:00\"\n multi_az = true\n deletion_protection = true\n enabled_cloudwatch_logs_exports = [\"postgresql\", \"upgrade\"]\n performance_insights_enabled = true\n tags = {\n Environment = \"production\"\n Compliance = \"PCI-DSS\"\n }\n}",
"github_url": "https://github.com/terraform-aws-modules/terraform-aws-rds",
"file_path": "examples/postgres/main.tf",
"stars": 1250,
"quality_score": 85,
"best_practices": [
"Encryption at rest enabled",
"Automated backups configured",
"Multi-AZ deployment",
"CloudWatch logging enabled",
"Performance Insights enabled"
],
"hybrid_score": 0.92,
"vector_score": 0.89,
"bm25_score": 0.95,
"compliance_analysis": {
"applicable_standards": ["PCI-DSS", "HIPAA", "SOC2"],
"compliance_score": {
"PCI-DSS": 0.95,
"HIPAA": 0.88,
"SOC2": 0.90
}
},
"cost_analysis": {
"estimated_monthly": 125.50,
"estimated_annual": 1506.00
}
}
],
"total": 1,
"query": "RDS database with encryption"
},
"metadata": {
"request_id": "req_123",
"timestamp": 1234567890.123,
"query_time_ms": 245
}
}
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request parameters",
"details": "query must be at least 3 characters"
},
"metadata": {
"request_id": "req_123",
"timestamp": 1234567890.123
}
}
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or expired token"
},
"metadata": {
"request_id": "req_123",
"timestamp": 1234567890.123
}
}
{
"error": {
"code": "QUOTA_EXCEEDED",
"message": "Query quota exceeded",
"details": {
"limit_type": "queries_per_month",
"current": 1000,
"limit": 1000
}
},
"metadata": {
"request_id": "req_123",
"timestamp": 1234567890.123
}
}
{
"error": {
"code": "INTERNAL_ERROR",
"message": "Failed to search code examples"
},
"metadata": {
"request_id": "req_123",
"timestamp": 1234567890.123
}
}
{
"error": {
"code": "DATABASE_ERROR",
"message": "Database connection failed"
},
"metadata": {
"request_id": "req_123",
"timestamp": 1234567890.123
}
}
Search infrastructure code examples from curated repositories. Supports filtering by code type, cloud provider, services, quality score, and compliance standards.
Endpoint
curl --request POST \
--url https://api.wistx.ai/v1/code-examples/search \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"query": "RDS database with encryption",
"code_types": ["terraform", "kubernetes"],
"cloud_provider": "aws",
"services": ["rds"],
"min_quality_score": 70,
"compliance_standard": "PCI-DSS",
"limit": 10
}'
import requests
api_key = "YOUR_API_KEY"
url = "https://api.wistx.ai/v1/code-examples/search"
response = requests.post(
url,
headers={
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
},
json={
"query": "RDS database with encryption",
"code_types": ["terraform", "kubernetes"],
"cloud_provider": "aws",
"services": ["rds"],
"min_quality_score": 70,
"compliance_standard": "PCI-DSS",
"limit": 10
}
)
data = response.json()
print(data)
const apiKey = "YOUR_API_KEY";
const url = "https://api.wistx.ai/v1/code-examples/search";
const response = await fetch(url, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
query: "RDS database with encryption",
code_types: ["terraform", "kubernetes"],
cloud_provider: "aws",
services: ["rds"],
min_quality_score: 70,
compliance_standard: "PCI-DSS",
limit: 10
})
});
const data = await response.json();
console.log(data);
package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
func main() {
apiKey := "YOUR_API_KEY"
url := "https://api.wistx.ai/v1/code-examples/search"
payload := map[string]interface{}{
"query": "RDS database with encryption",
"code_types": []string{"terraform", "kubernetes"},
"cloud_provider": "aws",
"services": []string{"rds"},
"min_quality_score": 70,
"compliance_standard": "PCI-DSS",
"limit": 10,
}
jsonData, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
req.Header.Set("Authorization", fmt.Sprintf("Bearer %s", apiKey))
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
}
require 'net/http'
require 'json'
uri = URI('https://api.wistx.ai/v1/code-examples/search')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri.path)
request['Authorization'] = 'Bearer YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = {
query: "RDS database with encryption",
code_types: ["terraform", "kubernetes"],
cloud_provider: "aws",
services: ["rds"],
min_quality_score: 70,
compliance_standard: "PCI-DSS",
limit: 10
}.to_json
response = http.request(request)
puts response.body
<?php
$url = "https://api.wistx.ai/v1/code-examples/search";
$data = [
"query" => "RDS database with encryption",
"code_types" => ["terraform", "kubernetes"],
"cloud_provider" => "aws",
"services" => ["rds"],
"min_quality_score" => 70,
"compliance_standard" => "PCI-DSS",
"limit" => 10
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer YOUR_API_KEY",
"Content-Type: application/json"
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import java.nio.charset.StandardCharsets;
HttpClient client = HttpClient.newHttpClient();
String json = "{\"query\":\"RDS database with encryption\",\"code_types\":[\"terraform\",\"kubernetes\"],\"cloud_provider\":\"aws\",\"services\":[\"rds\"],\"min_quality_score\":70,\"compliance_standard\":\"PCI-DSS\",\"limit\":10}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.wistx.ai/v1/code-examples/search"))
.header("Authorization", "Bearer YOUR_API_KEY")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(json))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
Request Parameters
string
required
Search query in natural language (3-1,000 characters). Examples:
- “RDS database with encryption”
- “Kubernetes deployment with autoscaling”
- “Terraform module for VPC”
- “Docker compose with health checks”
string[]
Filter by code types. Supported types:Infrastructure as Code:
terraform,opentofu,pulumi,ansible,cloudformation,bicep,arm,cdk,cdk8s
kubernetes,docker,helm
github_actions,gitlab_ci,jenkins,circleci,argo_workflows,tekton
argocd,flux,spinnaker
prometheus,grafana,datadog,opentelemetry
crossplane,karpenter,backstage
sam,serverless
bash,powershell
string
Filter by cloud provider:
aws, gcp, azure, oracle, alibabastring[]
Filter by cloud services (e.g.,
["rds", "s3", "ec2"]). Examples:- AWS:
rds,s3,ec2,lambda,eks,vpc,iam - GCP:
gce,gke,cloudsql,cloudstorage,cloudfunctions - Azure:
aks,sql,storage,functions,vnet
integer
Minimum quality score (0-100). Filters examples by quality metrics including:
- Code completeness
- Best practices adherence
- Documentation quality
- Repository popularity (stars)
string
Filter by compliance standard. Returns only examples that implement controls for the specified standard:
PCI-DSS- Payment Card Industry Data Security StandardHIPAA- Health Insurance Portability and Accountability ActSOC2- System and Organization Controls 2CIS- Center for Internet Security BenchmarksNIST-800-53- NIST Cybersecurity FrameworkISO-27001- ISO Information Security Management
integer
default:"10"
Maximum number of results (1-100)
Response Example
{
"data": {
"examples": [
{
"example_id": "ex_abc123",
"title": "Encrypted RDS Instance with Backup",
"description": "Terraform configuration for an encrypted RDS PostgreSQL instance with automated backups",
"contextual_description": "This Terraform code creates a production-ready RDS PostgreSQL database with encryption at rest, automated backups, and multi-AZ deployment. It demonstrates best practices for database security and compliance with PCI-DSS requirements.",
"code_type": "terraform",
"cloud_provider": "aws",
"services": ["rds"],
"resources": ["aws_db_instance", "aws_db_subnet_group", "aws_db_parameter_group"],
"code": "resource \"aws_db_instance\" \"main\" {\n identifier = \"prod-postgres\"\n engine = \"postgres\"\n engine_version = \"15.4\"\n instance_class = \"db.t3.medium\"\n allocated_storage = 100\n storage_encrypted = true\n kms_key_id = aws_kms_key.rds.arn\n db_name = \"mydb\"\n username = \"admin\"\n password = var.db_password\n vpc_security_group_ids = [aws_security_group.rds.id]\n db_subnet_group_name = aws_db_subnet_group.main.name\n backup_retention_period = 7\n backup_window = \"03:00-04:00\"\n maintenance_window = \"mon:04:00-mon:05:00\"\n multi_az = true\n deletion_protection = true\n enabled_cloudwatch_logs_exports = [\"postgresql\", \"upgrade\"]\n performance_insights_enabled = true\n tags = {\n Environment = \"production\"\n Compliance = \"PCI-DSS\"\n }\n}",
"github_url": "https://github.com/terraform-aws-modules/terraform-aws-rds",
"file_path": "examples/postgres/main.tf",
"stars": 1250,
"quality_score": 85,
"best_practices": [
"Encryption at rest enabled",
"Automated backups configured",
"Multi-AZ deployment",
"CloudWatch logging enabled",
"Performance Insights enabled"
],
"hybrid_score": 0.92,
"vector_score": 0.89,
"bm25_score": 0.95,
"compliance_analysis": {
"applicable_standards": ["PCI-DSS", "HIPAA", "SOC2"],
"compliance_score": {
"PCI-DSS": 0.95,
"HIPAA": 0.88,
"SOC2": 0.90
}
},
"cost_analysis": {
"estimated_monthly": 125.50,
"estimated_annual": 1506.00
}
}
],
"total": 1,
"query": "RDS database with encryption"
},
"metadata": {
"request_id": "req_123",
"timestamp": 1234567890.123,
"query_time_ms": 245
}
}
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request parameters",
"details": "query must be at least 3 characters"
},
"metadata": {
"request_id": "req_123",
"timestamp": 1234567890.123
}
}
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or expired token"
},
"metadata": {
"request_id": "req_123",
"timestamp": 1234567890.123
}
}
{
"error": {
"code": "QUOTA_EXCEEDED",
"message": "Query quota exceeded",
"details": {
"limit_type": "queries_per_month",
"current": 1000,
"limit": 1000
}
},
"metadata": {
"request_id": "req_123",
"timestamp": 1234567890.123
}
}
{
"error": {
"code": "INTERNAL_ERROR",
"message": "Failed to search code examples"
},
"metadata": {
"request_id": "req_123",
"timestamp": 1234567890.123
}
}
{
"error": {
"code": "DATABASE_ERROR",
"message": "Database connection failed"
},
"metadata": {
"request_id": "req_123",
"timestamp": 1234567890.123
}
}
Response Fields
Code Example Object
Use Cases
Find Production-Ready Examples
Search for code examples that demonstrate production-ready patterns:{
"query": "Kubernetes deployment with autoscaling and health checks",
"min_quality_score": 80,
"limit": 5
}
Compliance-Focused Search
Find code examples that implement specific compliance requirements:{
"query": "encrypted database with audit logging",
"compliance_standard": "HIPAA",
"code_types": ["terraform"],
"cloud_provider": "aws"
}
Multi-Tool Examples
Search across multiple infrastructure tools:{
"query": "CI/CD pipeline with infrastructure deployment",
"code_types": ["github_actions", "terraform", "kubernetes"],
"limit": 10
}
Cost-Optimized Examples
Find examples that demonstrate cost optimization:{
"query": "serverless architecture with cost optimization",
"code_types": ["terraform", "sam", "serverless"],
"cloud_provider": "aws"
}
Search Features
Hybrid Search
The endpoint uses a hybrid search approach combining:- Vector Search: Semantic understanding of your query using embeddings
- BM25 Search: Keyword-based matching for precise term matching
- Reranking: Optional reranking for improved relevance
Quality Filtering
Examples are scored based on:- Code completeness and correctness
- Best practices adherence
- Documentation quality
- Repository popularity (GitHub stars)
- Production readiness indicators
Compliance Mapping
When filtering bycompliance_standard, the search:
- Identifies examples that implement relevant compliance controls
- Returns only examples with verified compliance mappings
- Includes compliance scores for applicable standards
Rate Limits
- Professional: 2,000 queries/month
- Team: 10,000 queries/month
- Enterprise: Unlimited queries/month
Data Sources
Code examples are collected from:- Curated GitHub Repositories: High-quality repositories with 200+ stars
- Official Documentation: Examples from official cloud provider documentation
- Community Best Practices: Production-tested patterns from the community
- ✅ Production-ready and tested
- ✅ Enriched with compliance analysis
- ✅ Analyzed for cost implications
- ✅ Tagged with best practices
- ✅ Contextually described for better search
Related Endpoints
- Search Codebase - Search your own indexed repositories
- Compliance Requirements - Get compliance requirements for resources
- Pricing Calculation - Calculate infrastructure costs