# Universe API

[`Roboflow Universe`](https://universe.roboflow.com/) provides the following endpoints:

* [Search public datasets](#search-universe-datasets)

### Search Universe datasets

## GET /universe/search

> Search publicly available datasets on Roboflow Universe. Supports inline filter syntax in the query string (e.g. \`images>100\`, \`dog+stars>=5\`, \`class:cat\`, \`model:yolov8\`, \`object detection\`).

```json
{"openapi":"3.0.3","info":{"title":"Roboflow Universe API","version":"1.0.0"},"servers":[{"url":"https://api.roboflow.com"}],"security":[{"ApiKeyQuery":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"ApiKeyQuery":{"type":"apiKey","in":"query","name":"api_key"},"BearerAuth":{"type":"http","scheme":"bearer"}}},"paths":{"/universe/search":{"get":{"description":"Search publicly available datasets on Roboflow Universe. Supports inline filter syntax in the query string (e.g. `images>100`, `dog+stars>=5`, `class:cat`, `model:yolov8`, `object detection`).","parameters":[{"schema":{"type":"string"},"name":"q","in":"query","required":true},{"schema":{"type":"integer"},"name":"page","in":"query"}],"responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"429":{"description":"Too Many Requests"},"502":{"description":"Bad Gateway"}}}}}}
```

#### Thumbnail fields

Each result in the response includes two thumbnail fields:

| Field                 | Type             | Description                                                                                   |
| --------------------- | ---------------- | --------------------------------------------------------------------------------------------- |
| `thumbnail`           | `string \| null` | URL to the project's thumbnail image. `null` when the project has no icon set.                |
| `annotationThumbnail` | `string \| null` | URL to a sample annotated image from the project. `null` when annotation data is unavailable. |

Example result snippet:

```json
{
  "name": "Cars",
  "url": "https://universe.roboflow.com/growth-plan/cars-8q9vz",
  "thumbnail": "https://source.roboflow.com/.../thumb.jpg",
  "annotationThumbnail": "https://source.roboflow.com/.../annotation-cars.png"
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.roboflow.com/developer/rest-api/universe-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.