---
title: "Subito API: Search | Perceptlayer"
description: "Search from Subito as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/subito/search
---

[APIs](https://perceptlayer.com/apis) / [Subito](https://perceptlayer.com/apis/subito) / Search

# Subito: Search

Search from Subito as JSON. 1 credit per successful call.

GET `/v1/subito/search`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `q` | string | Optional | Up to 200 characters |
| `c` | integer | Optional | Any |
| `t` | string | Optional | s, k, u, g, h |
| `r` | integer | Optional | Any |
| `ci` | integer | Optional | Any |
| `to` | string | Optional | Any |
| `ps` | integer | Optional | Any |
| `pe` | integer | Optional | Any |
| `rs` | integer | Optional | Any |
| `re` | integer | Optional | Any |
| `szs` | integer | Optional | Any |
| `sze` | integer | Optional | Any |
| `advt` | string | Optional | 0, 1, 0, 1 |
| `sort` | string | Optional | datedesc, priceasc, pricedesc |
| `lim` | integer | Optional | Any |
| `start` | integer | Optional | Any |

## Example request

cURL shell 

```
curl "https://api.perceptlayer.com/v1/subito/search" \
  -H "X-API-Key: $API_KEY"
```

[Run this endpoint in the playground](https://perceptlayer.com/apis/subito?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.