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

# Search Polymarket events

`GET /polymarket/search`

## Request

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

Searches Polymarket and returns event results. The `status` enum accepts `open`, `closed`, and `all`; the `sort` enum accepts `relevance`, `volume24hr`, `volume`, `liquidity`, and `endDate`.

## Query parameters

- `q` string, required
- `limit` integer
- `status` 'open' | 'closed' | 'all'
- `sort` 'relevance' | 'volume24hr' | 'volume' | 'liquidity' | 'endDate'
- `ascending` boolean
- `include_tags` boolean
- `include_profiles` boolean

## Headers

- `x-api-key` string, required

## Response `200`

OK

- PolymarketSearchResponseDoc
  - `code` integer
  - `data` PolymarketSearchResponse
    - `ascending` boolean: `true` when results are sorted in ascending order.
    - `events` PolymarketEventSummary[]: Events matching the search query, one item per event.
      - `active` boolean: `true` when the event is active.
      - `closed` boolean: `true` when the event is closed.
      - `comment_count` integer: Number of comments on the event.
      - `description` string: Event description as shown on Polymarket.
      - `end_date` string: Date and time the event is scheduled to end (ISO 8601).
      - `featured` boolean: `true` when Polymarket features the event.
      - `icon_url` string: URL of the event's icon image.
      - `id` string: Polymarket event id.
      - `image_url` string: URL of the event's main image.
      - `liquidity` number: Liquidity Polymarket reports for the event.
      - `markets` PolymarketMarketSummary[]: Markets inside the event, one item per market.
        - `active` boolean: `true` when the market is active.
        - `best_ask` number: Lowest ask price currently offered on the market.
        - `best_bid` number: Highest bid price currently offered on the market.
        - `closed` boolean: `true` when the market is closed.
        - `condition_id` string: Condition id that identifies the market on Polymarket.
        - `end_date` string: Date and time the market is scheduled to end (ISO 8601).
        - `id` string: Polymarket market id.
        - `last_trade_price` number: Price of the most recent trade on the market.
        - `liquidity` number: Liquidity Polymarket reports for the market.
        - `outcomes` PolymarketOutcomePricePoint[]: Outcomes of the market with their current prices, one item per outcome.
          - `best_ask` number: Lowest ask price currently offered for the outcome.
          - `best_bid` number: Highest bid price currently offered for the outcome.
          - `last_trade_price` number: Price of the most recent trade on the outcome.
          - `liquidity` number: Liquidity Polymarket reports for the outcome.
          - `market_id` string: Polymarket id of the market the outcome belongs to.
          - `market_slug` string: URL slug of the market the outcome belongs to.
          - `outcome` string: Name of the outcome, for example `Yes`.
          - `price` number: Current price of the outcome.
          - `question` string: Question of the market the outcome belongs to.
          - `volume` number: Trading volume Polymarket reports for the outcome.
        - `question` string: Question the market asks, for example `Will Spain win the 2026 FIFA World Cup?`.
        - `slug` string: URL slug of the market.
        - `token_ids` string[]: Token ids of the market outcomes, in the same order as `outcomes`.
        - `url` string: Link to the market on polymarket.com.
        - `volume` number: Total trading volume of the market.
        - `volume_24h` number: Trading volume of the market over the last 24 hours.
      - `markets_count` integer: Number of markets inside the event.
      - `open_interest` number: Open interest Polymarket reports for the event.
      - `restricted` boolean: `true` when Polymarket marks the event as restricted.
      - `slug` string: URL slug of the event.
      - `start_date` string: Date and time the event starts (ISO 8601).
      - `tags` PolymarketTagSummary[]: Tags attached to the event, one item per tag.
        - `id` string: Polymarket tag id.
        - `label` string: Display name of the tag, for example `Crypto`.
        - `slug` string: URL slug of the tag, for example `crypto`.
      - `title` string: Event title as shown on Polymarket.
      - `updated_at` string: Time Polymarket last updated the event (ISO 8601).
      - `url` string: Link to the event on polymarket.com.
      - `volume` number: Total trading volume of the event.
      - `volume_24h` number: Trading volume of the event over the last 24 hours.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `has_more` boolean: `true` when more matching results exist beyond this page.
    - `limit` integer: Maximum number of events requested.
    - `profiles` PolymarketProfileMatch[]: Polymarket profiles matching the query, one item per profile.
      - `id` string: Polymarket profile id.
      - `name` string: Display name of the profile.
      - `username` string: Username of the profile.
    - `query` string: Search text that was run.
    - `sort` string: Sort order applied to the results, for example `relevance`.
    - `source_url` string: URL the data was read from.
    - `status` string: Event status filter applied: `open`, `closed` or `all`.
    - `tags` PolymarketTagSummary[]: Tags matching the query, one item per tag.
      - `id` string: Polymarket tag id.
      - `label` string: Display name of the tag, for example `Crypto`.
      - `slug` string: URL slug of the tag, for example `crypto`.
    - `total_results` integer: Total number of events matching the query.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

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