# Polymarket Research API (https://www.socialcrawl.dev/platforms/polymarket/research)

> Server-side fan-out over the Gamma API: expands the topic into up to 6 search queries (core subject + individual informative words), issues all calls in parallel, dedupes events by id, filters out unrelated matches via informative-word overlap with the topic, and ranks the remainder by topic↔title similarity. Costs 5 credits because each call hits upstream multiple times. Use this when you want a curated, on-topic feed; use /v1/polymarket/search for raw single-query lookups.

TL;DR: `GET /v1/polymarket/research` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | The research topic — free-text natural language (e.g. 'last 30 days bitcoin halving', 'kanye west tour'). Framing prefixes like 'last N days' and 'what are people saying about' are stripped automatically before expansion. |
| `limit` | no | Max results per result type on each fan-out call (events / markets / profiles). Bounds the response size. Defaults to 10. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/polymarket/research?query=trump%202028%20election" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What does the Polymarket research endpoint do?

Send a GET request to /v1/polymarket/research with a topic in the query parameter. SocialCrawl fans out several keyword searches for that topic and returns an aggregated, multi-market view — markets, outcomes, odds, and volume — instead of one query's matches.

### How is research different from the search endpoint?

Search runs a single keyword query and returns matching markets. Research runs several searches for one topic and aggregates them, so you get broader event-probability coverage in a single call. Use search for lookups, research for topic-level analysis.

### Who is the prediction market research endpoint for?

Traders, quant researchers, journalists, and anyone building sentiment or event-probability pipelines. It is the fastest way to pull a topic's full prediction-market picture — every related market's odds and volume — without writing your own fan-out logic.

### What data fields come back from research?

The aggregated view includes each market's question, outcomes with current odds and prices, total volume, end date, and resolution status. Everything is normalised into the SocialCrawl schema, so the same parser handles research, search, and other platforms.

### How much does the prediction market API research call cost?

Each research call costs 5 credits on the advanced tier because it fans out several searches per request. New accounts get 100 free credits with no credit card, enough to run 20 multi-market research calls before paying anything.

See the full Polymarket API: https://www.socialcrawl.dev/platforms/polymarket

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to research prediction markets across Polymarket with an API
- What does the SocialCrawl prediction market research endpoint return?