# \SearchApi

All URIs are relative to *https://registry.example.com*

Method | HTTP request | Description
------------- | ------------- | -------------
[**advanced_search**](SearchApi.md#advanced_search) | **GET** /api/v1/search/advanced | Advanced search
[**get_recent_artifacts**](SearchApi.md#get_recent_artifacts) | **GET** /api/v1/search/recent | Recently uploaded artifacts
[**get_trending_artifacts**](SearchApi.md#get_trending_artifacts) | **GET** /api/v1/search/trending | Trending artifacts
[**quick_search**](SearchApi.md#quick_search) | **GET** /api/v1/search/quick | Quick search
[**search_by_checksum**](SearchApi.md#search_by_checksum) | **GET** /api/v1/search/checksum | Search by checksum
[**search_suggestions**](SearchApi.md#search_suggestions) | **GET** /api/v1/search/suggest | Autocomplete suggestions



## advanced_search

> models::AdvancedSearch200Response advanced_search(q, format, repository, sort, order, page, per_page)
Advanced search

Performs a faceted search with filtering, sorting, and pagination support.

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**q** | **String** | Search query string. | [required] |
**format** | Option<**String**> | Filter by package format. |  |
**repository** | Option<**String**> | Filter by repository key. |  |
**sort** | Option<**String**> | Sort field. |  |[default to relevance]
**order** | Option<**String**> | Sort order. |  |[default to desc]
**page** | Option<**i32**> | Page number for pagination |  |[default to 1]
**per_page** | Option<**i32**> | Number of items per page |  |[default to 20]

### Return type

[**models::AdvancedSearch200Response**](advancedSearch_200_response.md)

### Authorization

[apiKeyAuth](../README.md#apiKeyAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## get_recent_artifacts

> Vec<models::Artifact> get_recent_artifacts(limit)
Recently uploaded artifacts

Returns the most recently uploaded artifacts across all accessible repositories.

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**limit** | Option<**i32**> | Maximum number of results to return. |  |[default to 10]

### Return type

[**Vec<models::Artifact>**](Artifact.md)

### Authorization

[apiKeyAuth](../README.md#apiKeyAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## get_trending_artifacts

> Vec<models::Artifact> get_trending_artifacts(days)
Trending artifacts

Returns the most downloaded artifacts over a given time window.

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**days** | Option<**i32**> | Number of days to look back for trending calculation. |  |[default to 7]

### Return type

[**Vec<models::Artifact>**](Artifact.md)

### Authorization

[apiKeyAuth](../README.md#apiKeyAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## quick_search

> models::QuickSearch200Response quick_search(q, limit)
Quick search

Performs a fast full-text search across all accessible artifacts. Suitable for search-as-you-type interfaces.

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**q** | **String** | Search query string. | [required] |
**limit** | Option<**i32**> | Maximum number of results to return. |  |[default to 10]

### Return type

[**models::QuickSearch200Response**](quickSearch_200_response.md)

### Authorization

[apiKeyAuth](../README.md#apiKeyAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## search_by_checksum

> Vec<models::Artifact> search_by_checksum(sha256, sha1, md5)
Search by checksum

Finds artifacts matching a given checksum. Provide at least one of sha256, sha1, or md5.

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**sha256** | Option<**String**> | SHA-256 hex digest |  |
**sha1** | Option<**String**> | SHA-1 hex digest |  |
**md5** | Option<**String**> | MD5 hex digest |  |

### Return type

[**Vec<models::Artifact>**](Artifact.md)

### Authorization

[apiKeyAuth](../README.md#apiKeyAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## search_suggestions

> models::SearchSuggestions200Response search_suggestions(prefix)
Autocomplete suggestions

Returns search term suggestions based on a prefix. Useful for typeahead/autocomplete in the UI.

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**prefix** | **String** | The prefix to generate suggestions for. | [required] |

### Return type

[**models::SearchSuggestions200Response**](searchSuggestions_200_response.md)

### Authorization

[apiKeyAuth](../README.md#apiKeyAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)

