---
title: "Search Polymarket"
method: GET
path: "/v1/polymarket/search"
tags: ["Polymarket"]
---

# Search Polymarket

`GET /v1/polymarket/search`

## Request

- Base URL: `https://api.scrapeatlas.com`
- URL: `https://api.scrapeatlas.com/v1/polymarket/search`
- Auth: API key in header `x-api-key`

Search Polymarket events by keyword, with matching tags and trader profiles when you ask for them. Each event carries its markets with outcomes and prices. Page through results with page. Each successful request costs 1 account credit, including partial results. Failed requests cost 0 credits.

## Query parameters

- `query` string, required
- `page` string
- `limit` string
- `profiles` 'true' | 'false'
- `tags` 'true' | 'false'

## Response `200`

Inspect the response status and failure or coverage fields.

- union
  - object
    - `requestId` string, uuid, required
    - `accounting` object, required
      - `upstreamRequests` integer, required
      - `responseBytes` integer, required
      - `durationMs` number, required
    - `success` true, required
    - `status` 'success' | 'partial', required
    - `sourceUrl` string, uri, required
    - `fetchedAt` string, date-time, required
    - `coverage` object, required
      - `source` 'public_api', required
      - `complete` boolean, required
      - `warnings` string[], required
    - `events` object[], required
      - `id` string, required
      - `slug` string, required
      - `title` string, required
      - `image` string
      - `startDate` string
      - `endDate` string
      - `active` boolean
      - `closed` boolean
      - `archived` boolean
      - `ended` boolean
      - `negRisk` boolean
      - `markets` object[]
        - `question` string, required
        - `slug` string, required
        - `groupItemTitle` string
        - `outcomes` string[]
        - `outcomePrices` string[]
        - `active` boolean
        - `closed` boolean
        - `archived` boolean
        - `closedTime` string
        - `lastTradePrice` number
        - `bestBid` number
        - `bestAsk` number
        - `spread` number
    - `tags` object[], nullable, required
      - `id` string, required
      - `label` string, required
      - `slug` string, required
      - `event_count` integer
    - `profiles` object[], nullable, required
      - `name` string
      - `pseudonym` string
      - `displayUsernamePublic` boolean
      - `proxyWallet` string, required
      - `bio` string
      - `profileImage` string
    - `page` integer, required
    - `hasMore` boolean, required
  - object
    - `requestId` string, uuid, required
    - `accounting` object, required
      - `upstreamRequests` integer, required
      - `responseBytes` integer, required
      - `durationMs` number, required
    - `success` false, required
    - `status` 'failed' | 'challenged', required
    - `failure` object, required
      - `code` 'invalid_request' | 'unauthorized' | 'not_found' | 'upstream_challenged' | 'upstream_rate_limited' | 'upstream_error' | 'unsupported_page' | 'response_too_large' | 'unsafe_redirect' | 'request_limit' | 'timeout' | 'busy' | 'payload_too_complex', required
      - `message` string, required

## Other responses

- `400`: Request could not complete; inspect error or failure.code.
- `401`: Request could not complete; inspect error or failure.code.
- `402`: Request could not complete; inspect error or failure.code.
- `403`: Request could not complete; inspect error or failure.code.
- `404`: Request could not complete; inspect error or failure.code.
- `408`: Request could not complete; inspect error or failure.code.
- `413`: Request could not complete; inspect error or failure.code.
- `429`: Request could not complete; inspect error or failure.code.
- `500`: Request could not complete; inspect error or failure.code.
- `502`: Request could not complete; inspect error or failure.code.
- `503`: Request could not complete; inspect error or failure.code.
- `504`: Request could not complete; inspect error or failure.code.

---

[API](https://skmtc.dev/scrapeatlas/apis/scrapeatlas-api.md) · [All operations](https://skmtc.dev/scrapeatlas/apis/scrapeatlas-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeatlas/apis/scrapeatlas-api/revisions/9ba049316894?raw)