Polymarket Research API
Scrape Polymarket Research data with one API call. 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.
Last updated October 2026Maintained by the SocialCrawl team
Returns Polymarket prediction markets about a topic, ranked by how well they match: event title, market questions, outcome prices, volume, and end date.
Use it to get a focused feed of markets on a subject. It runs several searches for you and drops results that are not about the topic.
Searching 68 platforms in parallel
What can you do with the Research API?
The Research endpoint gives you structured Polymarket data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/polymarket/research?query=trump+2028+election"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/polymarket/research",
params={
'query': 'trump 2028 election',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/polymarket/research?query=trump+2028+election",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();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. |
What does the Polymarket Research API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "polymarket",
"endpoint": "/v1/polymarket/research",
"data": {
"items": [
{
"id": "773641",
"ticker": "who-will-trump-endorse-first-in-the-2028-us-presidential-election-20260727202224755",
"slug": "who-will-trump-endorse-first-in-the-2028-us-presidential-election-20260727202224755",
"title": "Who will Trump endorse first in the 2028 US presidential election?",
"description": "This market will resolve according to the first individual that Donald Trump endorses for President of the United States in the 2028 United States Presidential Election. \n\nAn endorsement is defined as a statement by Donald Trump that i) is made publicly (e.g., through a press release, an on-the-record interview, a speech, a campaign event, a post from a verified account on social media); ii) explicitly and unambiguously expresses unique support for an individual as a candidate for President of the United States in the 2028 United States Presidential election; and iii) is characterized by a consensus of credible reporting as an official endorsement by Donald Trump of the individual for President in the 2028 United States presidential election.\n\nAn endorsement of an individual for the Republican Party’s nomination to the 2028 United States Presidential election will qualify. Endorsements of a candidate for the Democratic Party's nomination without also endorsing that candidate for President in the general election will not qualify.\n\nThe following will not be considered endorsements: positive or favorable comments about a candidate without a clear public statement of direct support; conditional statements giving support only if certain conditions are met; statements equally expressing support for multiple candidates (e.g., “I support Marco and J.D.”); statements expressing opposition to a candidate without endorsing any candidate; private or non-public statements; and statements that are clearly sarcastic, made in jest, or immediately clarified as not reflecting genuine support.\n\nAn endorsement of a ticket comprising a presidential candidate and a vice-presidential candidate constitutes a qualifying endorsement only of the individual endorsed for President. If the endorsement is of a ticket with undefined presidential and vice-presidential roles, or the roles on an endorsed ticket cannot be determined by the statement itself or a consensus of credible reporting, no qualifying endorsement will be deemed to have occurred.\n\nIf Donald Trump issues multiple concurrent statements meeting this standard, directed at different individuals, this will not constitute a qualifying endorsement and this market will remain open and resolve based on the first standalone qualifying endorsement issued. Endorsements will be considered to be issued concurrently only if they are issued in the same written statement (e.g., a public social media post), or in a singular public speaking event (e.g., a press conference, a speech).\n\nEndorsements via social media count only from verified accounts controlled by Donald Trump. Likes, reposts, or shares alone do not constitute a qualifying endorsement.\n\nIf Donald Trump officially files his candidacy for the 2028 United States Presidential election before issuing a qualifying endorsement, this market will resolve to “Donald Trump.” Statements alone will not be sufficient to resolve this market to “Donald Trump.”\n\nOnce a qualifying endorsement has occurred, subsequent retractions, rescissions, or endorsements of other individuals will not affect the determination of the first individual endorsed. If Donald Trump does not issue any qualifying endorsements, or file his own candidacy, by November 6, 2028, 11:59 PM ET, this market will resolve to “Other”.\n\nThe resolution sources for this market will be official statements from Donald Trump and a consensus of credible reporting.",
"resolutionSource": "",
"startDate": "2026-07-30T18:59:06.390891Z",
"creationDate": "2026-07-30T19:06:17.869026Z",
"endDate": "2028-11-07T04:59:00Z",
"image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/who-will-donald-trump-endorse-in-the-2028-united-states-presidential-election-20-HJxldsGlrWYS.jpg",
"icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/who-will-donald-trump-endorse-in-the-2028-united-states-presidential-election-20-HJxldsGlrWYS.jpg",
"active": true,
"closed": false,
"archived": false,
"new": false,
"featured": false,
"restricted": true,
"liquidity": 14827.14514,
"volume": 20330.640767,
"openInterest": 1995.6835909999995,
"sortBy": "price",
"createdAt": "2026-07-30T18:55:03.557455Z",
"updatedAt": "2026-10-02T12:53:34.177351Z",
"competitive": 0.9999750006249843,
"enableOrderBook": true,
"liquidityClob": 14827.14514,
"negRisk": true,
"negRiskMarketID": "0x07ea23b85d3910c021e30649613fa2c3722fdfd640acbfcc411d7ecbda1b6000",
"commentCount": 1,
"markets": [
{
"id": "3229166",
"question": "Sample comment text (redacted).",
"conditionId": "0x1f47ec472a4c625225b3331d9b568df885fc4e2de882716bc895231831046b37",
"slug": "will-donald-trump-endorse-donald-trump-in-the-2028-us-presidential-election-20260727201017696",
"resolutionSource": "",
"endDate": "2028-11-07T04:59:00Z",
"liquidity": "803.21249",
"startDate": "2026-07-30T18:59:06.390891Z",
"image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/will-donald-trump-win-the-2028-us-presidential-election-4gVusUQRi_GG.png",
"icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/will-donald-trump-win-the-2028-us-presidential-election-4gVusUQRi_GG.png",
"description": "This market will resolve according to the first individual that Donald Trump endorses for President of the United States in the 2028 United States Presidential Election. \n\nAn endorsement is defined as a statement by Donald Trump that i) is made publicly (e.g., through a press release, an on-the-record interview, a speech, a campaign event, a post from a verified account on social media); ii) explicitly and unambiguously expresses unique support for an individual as a candidate for President of the United States in the 2028 United States Presidential election; and iii) is characterized by a consensus of credible reporting as an official endorsement by Donald Trump of the individual for President in the 2028 United States presidential election.\n\nAn endorsement of an individual for the Republican Party’s nomination to the 2028 United States Presidential election will qualify. Endorsements of a candidate for the Democratic Party's nomination without also endorsing that candidate for President in the general election will not qualify.\n\nThe following will not be considered endorsements: positive or favorable comments about a candidate without a clear public statement of direct support; conditional statements giving support only if certain conditions are met; statements equally expressing support for multiple candidates (e.g., “I support Marco and J.D.”); statements expressing opposition to a candidate without endorsing any candidate; private or non-public statements; and statements that are clearly sarcastic, made in jest, or immediately clarified as not reflecting genuine support.\n\nAn endorsement of a ticket comprising a presidential candidate and a vice-presidential candidate constitutes a qualifying endorsement only of the individual endorsed for President. If the endorsement is of a ticket with undefined presidential and vice-presidential roles, or the roles on an endorsed ticket cannot be determined by the statement itself or a consensus of credible reporting, no qualifying endorsement will be deemed to have occurred.\n\nIf Donald Trump issues multiple concurrent statements meeting this standard, directed at different individuals, this will not constitute a qualifying endorsement and this market will remain open and resolve based on the first standalone qualifying endorsement issued. Endorsements will be considered to be issued concurrently only if they are issued in the same written statement (e.g., a public social media post), or in a singular public speaking event (e.g., a press conference, a speech).\n\nEndorsements via social media count only from verified accounts controlled by Donald Trump. Likes, reposts, or shares alone do not constitute a qualifying endorsement.\n\nIf Donald Trump officially files his candidacy for the 2028 United States Presidential election before issuing a qualifying endorsement, this market will resolve to “Donald Trump.” Statements alone will not be sufficient to resolve this market to “Donald Trump.”\n\nOnce a qualifying endorsement has occurred, subsequent retractions, rescissions, or endorsements of other individuals will not affect the determination of the first individual endorsed. If Donald Trump does not issue any qualifying endorsements, or file his own candidacy, by November 6, 2028, 11:59 PM ET, this market will resolve to “Other”.\n\nThe resolution sources for this market will be official statements from Donald Trump and a consensus of credible reporting.",
"outcomes": "[\"Yes\", \"No\"]",
"outcomePrices": "[\"0.0215\", \"0.9785\"]",
"volume": "1519.6938059999998",
"active": true,
"closed": false,
"marketMakerAddress": "",
"createdAt": "2026-07-30T18:55:04.109442Z",
"updatedAt": "2026-10-02T12:53:26.408222Z",
"new": false,
"featured": false,
"submitted_by": "0xF43d55F3A8B7484Ed4B6931f93CB6F9eF5Dd369D",
"archived": false,
"resolvedBy": "0x69c47De9D4D3Dad79590d61b9e05918E03775f24",
"restricted": true,
"groupItemTitle": "Donald Trump",
"groupItemThreshold": "0",
"questionID": "Sample comment text (redacted).",
"enableOrderBook": true,
"orderPriceMinTickSize": 0.001,
"orderMinSize": 5,
"volumeNum": 1519.6938059999998,
"liquidityNum": 803.21249,
"endDateIso": "2028-11-07",
"startDateIso": "2026-07-30",
"hasReviewedDates": true,
"clobTokenIds": "[\"74288739467333444940073223398441508133465696601345412147162566885004122913083\", \"13496782538562394046629289310351969655092189393193014968458210306239116323550\"]",
"comboStatus": "disabled",
"umaBond": "500",
"umaReward": "3.5",
"volumeClob": 1519.6938059999998,
"liquidityClob": 803.21249,
"makerBaseFee": 1000,
"takerBaseFee": 1000,
"customLiveness": 0,
"acceptingOrders": true,
"negRisk": true,
"negRiskMarketID": "0x07ea23b85d3910c021e30649613fa2c3722fdfd640acbfcc411d7ecbda1b6000",
"negRiskRequestID": "0x8fd759cc8b0bbd917db50eee4756d86595bfb5b1e11aa0a9a54b80c03e8410e8",
"ready": false,
"funded": false,
"acceptingOrdersTimestamp": "2026-07-30T18:58:06Z",
"cyom": false,
"competitive": 0.8136946435905578,
"pagerDutyNotificationEnabled": false,
"approved": true,
"rewardsMinSize": 20,
"rewardsMaxSpread": 4.5,
"spread": 0.017,
"oneDayPriceChange": -0.0055,
"oneHourPriceChange": -0.0005,
"oneWeekPriceChange": -0.017,
"oneMonthPriceChange": -0.0185,
"lastTradePrice": 0.014,
"bestBid": 0.013,
"bestAsk": 0.03,
"automaticallyActive": true,
"clearBookOnStart": true,
"showGmpSeries": false,
"showGmpOutcome": false,
"manualActivation": false,
"negRiskOther": false,
"umaResolutionStatuses": "[]",
"pendingDeployment": false,
"deploying": false,
"deployingTimestamp": "2026-07-30T18:57:05.451119Z",
"rfqEnabled": false,
"holdingRewardsEnabled": false,
"feesEnabled": true,
"feeType": "politics_fees",
"feeSchedule": {
"exponent": 1,
"rate": 0.04,
"takerOnly": true,
"rebateRate": 0.25
},
"version": "v1",
"outcomesList": [
"Yes",
"No"
],
"outcomePricesNum": [
0.0215,
0.9785
],
"clobTokenIdsList": [
"74288739467333444940073223398441508133465696601345412147162566885004122913083",
"13496782538562394046629289310351969655092189393193014968458210306239116323550"
]
},
{
"id": "3229167",
"question": "Sample comment text (redacted).",
"conditionId": "0xf9e55ef9a1dad890d080c3bda6e5ff4a5ba5ff5dd823d18e8b53b13ea783403c",
"slug": "will-donald-trump-endorse-jptdpt-vance-in-the-2028-us-presidential-election-20260727201017697",
"resolutionSource": "",
"endDate": "2028-11-07T04:59:00Z",
"liquidity": "2952.7533",
"startDate": "2026-07-30T18:59:09.584418Z",
"image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/will-jd-vance-win-the-2028-us-presidential-election-P-zEgXjCWbdY.png",
"icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/will-jd-vance-win-the-2028-us-presidential-election-P-zEgXjCWbdY.png",
"description": "This market will resolve according to the first individual that Donald Trump endorses for President of the United States in the 2028 United States Presidential Election. \n\nAn endorsement is defined as a statement by Donald Trump that i) is made publicly (e.g., through a press release, an on-the-record interview, a speech, a campaign event, a post from a verified account on social media); ii) explicitly and unambiguously expresses unique support for an individual as a candidate for President of the United States in the 2028 United States Presidential election; and iii) is characterized by a consensus of credible reporting as an official endorsement by Donald Trump of the individual for President in the 2028 United States presidential election.\n\nAn endorsement of an individual for the Republican Party’s nomination to the 2028 United States Presidential election will qualify. Endorsements of a candidate for the Democratic Party's nomination without also endorsing that candidate for President in the general election will not qualify.\n\nThe following will not be considered endorsements: positive or favorable comments about a candidate without a clear public statement of direct support; conditional statements giving support only if certain conditions are met; statements equally expressing support for multiple candidates (e.g., “I support Marco and J.D.”); statements expressing opposition to a candidate without endorsing any candidate; private or non-public statements; and statements that are clearly sarcastic, made in jest, or immediately clarified as not reflecting genuine support.\n\nAn endorsement of a ticket comprising a presidential candidate and a vice-presidential candidate constitutes a qualifying endorsement only of the individual endorsed for President. If the endorsement is of a ticket with undefined presidential and vice-presidential roles, or the roles on an endorsed ticket cannot be determined by the statement itself or a consensus of credible reporting, no qualifying endorsement will be deemed to have occurred.\n\nIf Donald Trump issues multiple concurrent statements meeting this standard, directed at different individuals, this will not constitute a qualifying endorsement and this market will remain open and resolve based on the first standalone qualifying endorsement issued. Endorsements will be considered to be issued concurrently only if they are issued in the same written statement (e.g., a public social media post), or in a singular public speaking event (e.g., a press conference, a speech).\n\nEndorsements via social media count only from verified accounts controlled by Donald Trump. Likes, reposts, or shares alone do not constitute a qualifying endorsement.\n\nIf Donald Trump officially files his candidacy for the 2028 United States Presidential election before issuing a qualifying endorsement, this market will resolve to “Donald Trump.” Statements alone will not be sufficient to resolve this market to “Donald Trump.”\n\nOnce a qualifying endorsement has occurred, subsequent retractions, rescissions, or endorsements of other individuals will not affect the determination of the first individual endorsed. If Donald Trump does not issue any qualifying endorsements, or file his own candidacy, by November 6, 2028, 11:59 PM ET, this market will resolve to “Other”.\n\nThe resolution sources for this market will be official statements from Donald Trump and a consensus of credible reporting.",
"outcomes": "[\"Yes\", \"No\"]",
"outcomePrices": "[\"0.495\", \"0.505\"]",
"volume": "8462.803645",
"active": true,
"closed": false,
"marketMakerAddress": "",
"createdAt": "2026-07-30T18:55:04.544006Z",
"updatedAt": "2026-10-02T12:53:26.408222Z",
"new": false,
"featured": false,
"submitted_by": "0xF43d55F3A8B7484Ed4B6931f93CB6F9eF5Dd369D",
"archived": false,
"resolvedBy": "0x69c47De9D4D3Dad79590d61b9e05918E03775f24",
"restricted": true,
"groupItemTitle": "J.D. Vance",
"groupItemThreshold": "1",
"questionID": "Sample comment text (redacted).",
"enableOrderBook": true,
"orderPriceMinTickSize": 0.01,
"orderMinSize": 5,
"volumeNum": 8462.803645,
"liquidityNum": 2952.7533,
"endDateIso": "2028-11-07",
"startDateIso": "2026-07-30",
"hasReviewedDates": true,
"clobTokenIds": "[\"20213624738629602734871575785250006631406621390044044063230082562317459092954\", \"409692822828057446010651693526860580657532057409114328624834759564694498621\"]",
"comboStatus": "disabled",
"umaBond": "500",
"umaReward": "3.5",
"volumeClob": 8462.803645,
"liquidityClob": 2952.7533,
"makerBaseFee": 1000,
"takerBaseFee": 1000,
"customLiveness": 0,
"acceptingOrders": true,
"negRisk": true,
"negRiskMarketID": "0x07ea23b85d3910c021e30649613fa2c3722fdfd640acbfcc411d7ecbda1b6000",
"negRiskRequestID": "0x507f8f282843a930e50fa87b041b746159ad447893beadfabaaa80c9f5fb4503",
"ready": false,
"funded": false,
"acceptingOrdersTimestamp": "2026-07-30T18:58:09Z",
"cyom": false,
"competitive": 0.9999750006249843,
"pagerDutyNotificationEnabled": false,
"approved": true,
"clobRewards": [
{
"id": "1090525",
"conditionId": "0xf9e55ef9a1dad890d080c3bda6e5ff4a5ba5ff5dd823d18e8b53b13ea783403c",
"assetAddress": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
"rewardsAmount": 0,
"rewardsDailyRate": 4,
"startDate": "2026-09-30",
"endDate": "2500-12-31"
}
],
"rewardsMinSize": 20,
"rewardsMaxSpread": 5.5,
"spread": 0.01,
"oneDayPriceChange": 0.005,
"oneMonthPriceChange": 0.005,
"lastTradePrice": 0.48,
"bestBid": 0.49,
"bestAsk": 0.5,
"automaticallyActive": true,
"clearBookOnStart": true,
"showGmpSeries": false,
"showGmpOutcome": false,
"manualActivation": false,
"negRiskOther": false,
"umaResolutionStatuses": "[]",
"pendingDeployment": false,
"deploying": false,
"deployingTimestamp": "2026-07-30T18:57:05.464472Z",
"rfqEnabled": false,
"holdingRewardsEnabled": false,
"feesEnabled": true,
"feeType": "politics_fees",
"feeSchedule": {
"exponent": 1,
"rate": 0.04,
"takerOnly": true,
"rebateRate": 0.25
},
"version": "v1",
"outcomesList": [
"Yes",
"No"
],
"outcomePricesNum": [
0.495,
0.505
],
"clobTokenIdsList": [
"20213624738629602734871575785250006631406621390044044063230082562317459092954",
"409692822828057446010651693526860580657532057409114328624834759564694498621"
]
}
],
"tags": [
{
"id": "126",
"label": "Trump",
"slug": "trump",
"forceShow": false,
"publishedAt": "2023-11-02 21:23:16.384+00",
"updatedBy": 15,
"createdAt": "2023-11-02T21:23:16.39Z",
"updatedAt": "2026-04-17T20:39:14.206724Z"
},
{
"id": "2",
"label": "Politics",
"slug": "politics",
"forceShow": false,
"publishedAt": "2023-10-25 18:55:50.674+00",
"updatedBy": 13,
"createdAt": "2023-10-25T18:55:50.681Z",
"updatedAt": "2026-04-17T20:39:54.201881Z",
"forceHide": true
}
],
"cyom": false,
"showAllOutcomes": true,
"showMarketImages": true,
"enableNegRisk": true,
"automaticallyActive": true,
"gmpChartMode": "default",
"negRiskAugmented": true,
"estimateValue": false,
"cumulativeMarkets": false,
"pendingDeployment": false,
"deploying": false,
"deployingTimestamp": "2026-07-30T18:55:59.689488Z",
"eventMetadata": {
"context_requires_regen": false
},
"version": "v1"
},
{
"id": "772736",
"ticker": "will-trumps-first-pick-win-the-2028-us-presidential-election-20260727202646079",
"slug": "will-trumps-first-pick-win-the-2028-us-presidential-election-20260727202646079",
"title": "Will Trump's first pick win the 2028 US presidential election?",
"description": "This market will resolve to “Yes” if the first individual that Donald Trump endorses for President of the United States in the 2028 United States Presidential Election wins the 2028 United States Presidential Election. Otherwise, this market will resolve to “No”. \n\nThe following rules govern the determination of the first individual that Donald Trump endorses for President of the United States in the 2028 United States Presidential Election: \n\nAn endorsement is defined as a statement by Donald Trump that i) is made publicly (e.g., through a press release, an on-the-record interview, a speech, a campaign event, a post from a verified account on social media); ii) explicitly and unambiguously expresses unique support for an individual as a candidate for President of the United States in the 2028 United States Presidential Election; and iii) is characterized by a consensus of credible reporting as an official endorsement by Donald Trump of the individual for President in the 2028 United States Presidential Election.\n\nAn endorsement of an individual for the Republican Party’s nomination in the 2028 United States Presidential Election will qualify as an endorsement for the 2028 United States Presidential Election. Endorsements of a candidate for the Democratic Party's nomination without also endorsing that candidate for President in the general election will not qualify.\n\nThe following will not be considered endorsements: positive or favorable comments about a candidate without a clear public statement of direct support; conditional statements giving support only if certain conditions are met; statements equally expressing support for multiple candidates (e.g., “I support Marco and J.D.”); statements expressing opposition to a candidate without endorsing any candidate; private or non-public statements; and statements that are clearly sarcastic, made in jest, or immediately clarified as not reflecting genuine support.\n\nAn endorsement of a ticket comprising a presidential candidate and a vice-presidential candidate constitutes a qualifying endorsement only of the individual endorsed for President. If the endorsement is of a ticket with undefined presidential and vice-presidential roles, or the roles on an endorsed ticket cannot be determined by the statement itself or a consensus of credible reporting, no qualifying endorsement will be deemed to have occurred.\n\nIf Donald Trump issues multiple concurrent statements meeting this standard, directed at different individuals, this will not constitute a qualifying endorsement and this market will remain open and resolve based on the first standalone qualifying endorsement issued. Endorsements will be considered to be issued concurrently only if they are issued in the same written statement (e.g., a public social media post), or in a singular public speaking event (e.g., a press conference, a speech).\n\nEndorsements via social media count only from verified accounts controlled by Donald Trump. Likes, reposts, or shares alone do not constitute a qualifying endorsement.\n\nIf Donald Trump officially files his candidacy for the 2028 United States Presidential Election before issuing a qualifying endorsement, he will be considered to have endorsed himself. Statements alone will not be sufficient to constitute Trump’s endorsement of himself.\n\nOnce a qualifying endorsement has occurred, subsequent retractions, rescissions, or endorsements of other individuals will not affect the determination of the first individual endorsed. If Donald Trump does not issue any qualifying endorsements, or file his own candidacy, by November 6, 2028, 11:59 PM ET, this market will resolve to “No”.\n\nThe resolution sources for Trump’s endorsement will be official statements from Donald Trump and a consensus of credible reporting. The resolution sources for the winner of the 2028 United States Presidential Election are the Associated Press, Fox News, and NBC. All three sources must call the race for the same candidate. If all three sources haven’t called the race for the same candidate by the inauguration date (January 20, 2029) this market will resolve based on who is inaugurated.",
"resolutionSource": "",
"startDate": "2026-07-30T15:16:57.124026Z",
"creationDate": "2026-07-30T15:19:13.194794Z",
"endDate": "2028-11-08T04:59:00Z",
"image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/will-trumps-first-pick-win-the-2028-us-presidential-election-20260727202646079-hAMH-QsTbPlO.jpg",
"icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/will-trumps-first-pick-win-the-2028-us-presidential-election-20260727202646079-hAMH-QsTbPlO.jpg",
"active": true,
"closed": false,
"archived": false,
"new": false,
"featured": false,
"restricted": true,
"liquidity": 31463.5141,
"volume": 1500.504576,
"openInterest": 319.613076,
"sortBy": "ascending",
"createdAt": "2026-07-30T15:14:52.071359Z",
"updatedAt": "2026-10-02T12:53:34.177351Z",
"competitive": 0.9651578033008396,
"enableOrderBook": true,
"liquidityClob": 31463.5141,
"negRisk": false,
"commentCount": 1,
"markets": [
{
"id": "3222753",
"question": "Sample comment text (redacted).",
"conditionId": "0xa986066a4a07d3f424a7e1418e3815e7742135c2c71cecacd493fabc0ec3b405",
"slug": "will-trumps-first-pick-win-the-2028-us-presidential-election-20260727202646079",
"resolutionSource": "",
"endDate": "2028-11-08T04:59:00Z",
"liquidity": "31469.3941",
"startDate": "2026-07-30T15:16:57.124026Z",
"image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/will-trumps-first-pick-win-the-2028-us-presidential-election-20260727202646079-hAMH-QsTbPlO.jpg",
"icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/will-trumps-first-pick-win-the-2028-us-presidential-election-20260727202646079-hAMH-QsTbPlO.jpg",
"description": "This market will resolve to “Yes” if the first individual that Donald Trump endorses for President of the United States in the 2028 United States Presidential Election wins the 2028 United States Presidential Election. Otherwise, this market will resolve to “No”. \n\nThe following rules govern the determination of the first individual that Donald Trump endorses for President of the United States in the 2028 United States Presidential Election: \n\nAn endorsement is defined as a statement by Donald Trump that i) is made publicly (e.g., through a press release, an on-the-record interview, a speech, a campaign event, a post from a verified account on social media); ii) explicitly and unambiguously expresses unique support for an individual as a candidate for President of the United States in the 2028 United States Presidential Election; and iii) is characterized by a consensus of credible reporting as an official endorsement by Donald Trump of the individual for President in the 2028 United States Presidential Election.\n\nAn endorsement of an individual for the Republican Party’s nomination in the 2028 United States Presidential Election will qualify as an endorsement for the 2028 United States Presidential Election. Endorsements of a candidate for the Democratic Party's nomination without also endorsing that candidate for President in the general election will not qualify.\n\nThe following will not be considered endorsements: positive or favorable comments about a candidate without a clear public statement of direct support; conditional statements giving support only if certain conditions are met; statements equally expressing support for multiple candidates (e.g., “I support Marco and J.D.”); statements expressing opposition to a candidate without endorsing any candidate; private or non-public statements; and statements that are clearly sarcastic, made in jest, or immediately clarified as not reflecting genuine support.\n\nAn endorsement of a ticket comprising a presidential candidate and a vice-presidential candidate constitutes a qualifying endorsement only of the individual endorsed for President. If the endorsement is of a ticket with undefined presidential and vice-presidential roles, or the roles on an endorsed ticket cannot be determined by the statement itself or a consensus of credible reporting, no qualifying endorsement will be deemed to have occurred.\n\nIf Donald Trump issues multiple concurrent statements meeting this standard, directed at different individuals, this will not constitute a qualifying endorsement and this market will remain open and resolve based on the first standalone qualifying endorsement issued. Endorsements will be considered to be issued concurrently only if they are issued in the same written statement (e.g., a public social media post), or in a singular public speaking event (e.g., a press conference, a speech).\n\nEndorsements via social media count only from verified accounts controlled by Donald Trump. Likes, reposts, or shares alone do not constitute a qualifying endorsement.\n\nIf Donald Trump officially files his candidacy for the 2028 United States Presidential Election before issuing a qualifying endorsement, he will be considered to have endorsed himself. Statements alone will not be sufficient to constitute Trump’s endorsement of himself.\n\nOnce a qualifying endorsement has occurred, subsequent retractions, rescissions, or endorsements of other individuals will not affect the determination of the first individual endorsed. If Donald Trump does not issue any qualifying endorsements, or file his own candidacy, by November 6, 2028, 11:59 PM ET, this market will resolve to “No”.\n\nThe resolution sources for Trump’s endorsement will be official statements from Donald Trump and a consensus of credible reporting. The resolution sources for the winner of the 2028 United States Presidential Election are the Associated Press, Fox News, and NBC. All three sources must call the race for the same candidate. If all three sources haven’t called the race for the same candidate by the inauguration date (January 20, 2029) this market will resolve based on who is inaugurated.",
"outcomes": "[\"Yes\", \"No\"]",
"outcomePrices": "[\"0.31\", \"0.69\"]",
"volume": "1500.504576",
"active": true,
"closed": false,
"marketMakerAddress": "",
"createdAt": "2026-07-30T15:14:52.478299Z",
"updatedAt": "2026-10-02T12:53:26.408222Z",
"new": false,
"featured": false,
"submitted_by": "0xF43d55F3A8B7484Ed4B6931f93CB6F9eF5Dd369D",
"archived": false,
"resolvedBy": "0x65070BE91477460D8A7AeEb94ef92fe056C2f2A7",
"restricted": true,
"questionID": "Sample comment text (redacted).",
"enableOrderBook": true,
"orderPriceMinTickSize": 0.01,
"orderMinSize": 5,
"volumeNum": 1500.504576,
"liquidityNum": 31469.3941,
"endDateIso": "2028-11-08",
"startDateIso": "2026-07-30",
"hasReviewedDates": true,
"clobTokenIds": "[\"51643523825980119811003865366710580854443210671696048280312399189599671584536\", \"37022373762366493953356825278300447180644542156943670018228576206272617068851\"]",
"comboStatus": "disabled",
"umaBond": "500",
"umaReward": "3.5",
"volumeClob": 1500.504576,
"liquidityClob": 31469.3941,
"makerBaseFee": 1000,
"takerBaseFee": 1000,
"customLiveness": 0,
"acceptingOrders": true,
"negRisk": false,
"negRiskRequestID": "",
"ready": false,
"funded": false,
"acceptingOrdersTimestamp": "2026-07-30T15:16:09Z",
"cyom": false,
"competitive": 0.9651578033008396,
"pagerDutyNotificationEnabled": false,
"approved": true,
"clobRewards": [
{
"id": "1087429",
"conditionId": "0xa986066a4a07d3f424a7e1418e3815e7742135c2c71cecacd493fabc0ec3b405",
"assetAddress": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
"rewardsAmount": 0,
"rewardsDailyRate": 2,
"startDate": "2026-07-30",
"endDate": "2500-12-31"
}
],
"rewardsMinSize": 20,
"rewardsMaxSpread": 4.5,
"spread": 0.06,
"oneWeekPriceChange": 0.12,
"oneMonthPriceChange": 0.12,
"lastTradePrice": 0.3,
"bestBid": 0.28,
"bestAsk": 0.34,
"automaticallyActive": true,
"clearBookOnStart": true,
"showGmpSeries": false,
"showGmpOutcome": false,
"manualActivation": false,
"negRiskOther": false,
"umaResolutionStatuses": "[]",
"pendingDeployment": false,
"deploying": false,
"deployingTimestamp": "2026-07-30T15:15:08.180762Z",
"rfqEnabled": false,
"holdingRewardsEnabled": false,
"feesEnabled": true,
"feeType": "politics_fees",
"feeSchedule": {
"exponent": 1,
"rate": 0.04,
"takerOnly": true,
"rebateRate": 0.25
},
"version": "v1",
"outcomesList": [
"Yes",
"No"
],
"outcomePricesNum": [
0.31,
0.69
],
"clobTokenIdsList": [
"51643523825980119811003865366710580854443210671696048280312399189599671584536",
"37022373762366493953356825278300447180644542156943670018228576206272617068851"
]
}
],
"tags": [
{
"id": "126",
"label": "Trump",
"slug": "trump",
"forceShow": false,
"publishedAt": "2023-11-02 21:23:16.384+00",
"updatedBy": 15,
"createdAt": "2023-11-02T21:23:16.39Z",
"updatedAt": "2026-04-17T20:39:14.206724Z"
},
{
"id": "100285",
"label": "Vance",
"slug": "vance",
"createdAt": "2024-06-25T19:46:59.165544Z",
"updatedAt": "2026-04-17T21:09:02.084203Z"
}
],
"cyom": false,
"showAllOutcomes": true,
"showMarketImages": true,
"enableNegRisk": false,
"automaticallyActive": true,
"gmpChartMode": "default",
"negRiskAugmented": false,
"estimateValue": false,
"cumulativeMarkets": false,
"pendingDeployment": false,
"deploying": false,
"eventMetadata": {
"context_requires_regen": false
},
"version": "v1"
}
],
"dropped": 0
},
"credits_used": 5,
"request_id": "req_example000000",
"cached": false,
"pagination": {
"next_cursor": null,
"has_more": false,
"page_size": 23
},
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-10-02T12:54:38.743Z",
"redacted": true
}Live sample illustrating the unified response shape. Field values reflect the record you query.
How does the Polymarket Research API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 68 platforms covering 10B+ monthly active users.
One schema, every platform
Query 68 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.
See your data before you code
Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usWhat does the Polymarket research endpoint do?
How is research different from the search endpoint?
Who is the prediction market research endpoint for?
What data fields come back from research?
How much does the prediction market API research call cost?
Ask AI about SocialCrawl
Ready to scrape Polymarket Research data?
Get your API key and start pulling Polymarket data in under 60 seconds.
