---
title: "Run a screener query"
url: "https://developer.argaam.com/apis/search-discovery-layer-api-sandbox-v1/versions/7b9c43fb-96d0-4164-9da6-4249bbd8ed0b/operations/getScreenerRunByQuery"
---

> Full API specification: https://developer.argaam.com/apis/search-discovery-layer-api-sandbox-v1/versions/7b9c43fb-96d0-4164-9da6-4249bbd8ed0b.md

# Run a screener query

`GET` `/api/v1.1/screener/run/{query}`

Operation ID: `getScreenerRunByQuery`

Executes the URL-encoded screener query built from the structure endpoint and returns the matching companies with the requested columns. Compute-heavy: this endpoint carries its own tighter rate limit, independent of the rest of the layer.

## Path parameters

- `query` (string, required) - URL-encoded screener query string produced by the screener structure endpoint.

## Responses

- `200` - Success

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Search & Discovery Layer API
  version: v1.1
servers:
  - url: https://api-sandbox.argaam.com
    description: Argaam API Gateway (Sandbox)
paths:
  /api/v1.1/screener/run/{query}:
    get:
      tags:
        - Screener
      parameters:
        - name: query
          in: path
          required: true
          schema:
            type: string
          description: URL-encoded screener query string produced by the screener
            structure endpoint.
      responses:
        "200":
          description: Success
      summary: Run a screener query
      description: "Executes the URL-encoded screener query built from the structure
        endpoint and returns the matching companies with the requested columns.
        Compute-heavy: this endpoint carries its own tighter rate limit,
        independent of the rest of the layer."
      operationId: getScreenerRunByQuery
security:
  - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: apikey
```