---
description: Get Wallpapers matching a given search term.
---

# search

{% hint style="info" %}
This method belongs to the class - [Alpha](../classes/alpha)
{% endhint %}

### Parameters

<table><thead><tr><th width="150" align="center">PARAMETER</th><th width="150" align="center">TYPE</th><th width="150" align="center">OPTIONAL</th><th width="243.15384615384616" align="center">DESCRIPTION</th></tr></thead><tbody><tr><td align="center"><strong>term</strong></td><td align="center"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">String</a></td><td align="center"></td><td align="center">The search term used for the matching. (MAX 128 Characters)</td></tr><tr><td align="center"><strong>options</strong></td><td align="center"><a href="../../types#bysortoptions">BySortOptions</a></td><td align="center"><span data-gb-custom-inline data-tag="emoji" data-code="1f44d">👍</span></td><td align="center">Optional parameters.</td></tr></tbody></table>

### Returns

[Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)<[Wallpaper](../../types#wallpaper)> | [null](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/null)>

### Example Code

```javascript
new Alpha(apiKey).search('video games').then(x => console.log(x));

// OR

new Alpha(apiKey).search('video games', {
    page: 10,
    operator: 'min',
    type: 'phone',
    ratio: [0.75, 1]
}).then(x => console.log(x));
```
