Search
The Search API allows you to discover and filter microIP-enriched assets based on various criteria. This guide covers search functionality and filtering options.
Search Assets
Search for assets with microIP licenses using various filters and criteria.
curl -X GET https://api.ipto.ai/search \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"query": "machine learning",
"category": "code",
"quality": "premium",
"min_price": 0.1,
"max_price": 1.0,
"tags": ["python", "tensorflow"],
"page": 1,
"limit": 10
}'Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | String | Yes | Search query string |
| category | String | No | Asset category filter |
| quality | String | No | Quality level filter |
| min_price | Number | No | Minimum price in SOL |
| max_price | Number | No | Maximum price in SOL |
| tags | Array | No | Array of tags to filter by |
| page | Integer | No | Page number (default: 1) |
| limit | Integer | No | Items per page (default: 10) |
Response
[
{
"name": "Machine Learning Model",
"description": "Advanced ML model for image recognition",
"file_url": "https://storage.ipto.ai/assets/123",
"metadata": {
"file_name": "model.py",
"file_size": 1024000,
"file_type": "py",
"mime_type": "text/x-python",
"created_at": "2024-03-21T10:00:00Z",
"last_modified": "2024-03-21T10:00:00Z"
},
"created_at": "2024-03-21T10:00:00Z",
"owner_id": "user_123",
"is_public": true,
"micro_ip": {
"name": "Machine Learning Model",
"description": "Advanced ML model for image recognition",
"long_summary": "A state-of-the-art machine learning model...",
"tags": ["python", "tensorflow", "machine-learning"],
"category": "code",
"questions": [
"What problem does this solve?",
"How is it implemented?",
"What are the key features?"
],
"quality": "premium",
"on_chain_id": "0x123...",
"created_at": "2024-03-21T10:00:00Z",
"updated_at": "2024-03-21T10:00:00Z",
"price": 0.5,
"license_type": "standard"
},
"total_earnings": 10.5,
"total_views": 100,
"total_downloads": 21,
"is_verified": true
}
// ... more results
]Asset Categories
Available categories for filtering:
| Category | Description |
|---|---|
| code | Software code and scripts |
| design | Design files and assets |
| document | Text documents and PDFs |
| audio | Audio files and music |
| video | Video content |
| image | Images and graphics |
| dataset | Data sets and collections |
| other | Other types of assets |
Quality Levels
Available quality levels for filtering:
| Level | Description |
|---|---|
| premium | High-quality, well-documented assets |
| standard | Good quality with basic documentation |
| basic | Basic quality with minimal documentation |
Search Tips
- Use specific keywords in your query
- Combine multiple filters for better results
- Use tags to find related assets
- Set price ranges to find affordable assets
- Filter by quality for better reliability
Error Responses
Invalid Category
{
"detail": "Invalid category specified"
}Invalid Quality Level
{
"detail": "Invalid quality level specified"
}Invalid Price Range
{
"detail": "Invalid price range specified"
}Best Practices
- Start with broad searches and narrow down
- Use relevant tags for better results
- Check asset quality before purchasing
- Review asset documentation
- Consider price vs. value