stremio-addons/docs/api/meta/meta.search.md

Stremio Add-on Server / Client

## Meta Search

Perform a text search. Arguments are exactly the same as usual [``Meta Request``](meta.request.md), except ``query`` is a string. Returns an array of [``Meta Elements``](meta.element.md) matches.

This is used for the Search functionality.

Does not support pagination.

```javascript
var addon = new Stremio.Server({
	"meta.search": function(args, callback, user) {
		// expects one meta element (requested by ID)
	}
});
```

### Request

_otherwise known as `args` in the above code_

```javascript
{
  query: 'baseball season', // search query
  limit: 10                 // limit length of the response array to "10"
}
```

See [Meta Request](meta.request.md) for Parameters.

### Response

```javascript
{
  query: 'baseball season', // return the query from the response
  results: [ // Array of Metadata objects
    {
      id: 'basic_id:opa2135',                                       // unique ID for the media, will be returned as "basic_id" in the request object later
      name: 'basic title',                                          // title of media
      poster: 'http://thetvdb.com/banners/posters/78804-52.jpg',    // image link
      posterShape: 'regular',                                       // can also be 'landscape' or 'square'
      banner: 'http://thetvdb.com/banners/graphical/78804-g44.jpg', // image link
      genre: ['Entertainment'],
      isFree: 1,                                                    // some aren't
      popularity: 3831,                                             // the larger, the more popular this item is
      popularities: { basic: 3831 },                                // same as 'popularity'; use this if you want to provide different sort orders in your manifest
      type: 'movie'                                                 // can also be "tv", "series", "channel"
    },
	...
  ],
}
```

See [Meta Element](meta.element.md) for Parameters.

See [Content Types](content.types.md) for the `type` parameter.