. The response is a different shape from search results: camelCase fields including entityId, description, category, totalReactionCount, aggregatedPinData, richMetadata, pinner, originPinner and genAiTopics. Measured at 12.5 KB, the smallest full response in this API; trim=true reduces it to 1.6 KB, keeping entityId, description, createdAt, pinner, originPinner, nativeCreator, shareCount, repinCount and totalReactionCount while dropping richMetadata and category. To find pins by keyword use get_pinterest_search; to page through the board a pin sits on use get_pinterest_board. Only standard numeric pin URLs resolve: of 12 search results fed straight back, the 3 whose URL ended in a shortcode (dwA0UYrl style) all answered 404 and one numeric id did too, so check for a numeric trailing id before calling and expect occasional 404s on deleted pins.\n\n\nUsage-based billing; Default request estimate: $0.00188 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n",
"operationId": "get_pinterest_pin",
"parameters": [
{
"in": "query",
"name": "trim",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "url",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"example": {
"success": true,
"entityId": "36662184461578355",
"seoAltText": "a small brown dog sitting in the back seat of a car with its head hanging out",
"originPinner": {
"entityId": "1144125617743372495",
"id": "VXNlcjoxMTQ0MTI1NjE3NzQzMzcyNDk1",
"username": "Chloe_hi15",
"imageMediumUrl": "https://i.pinimg.com/75x75_RS/90/99/6f/90996f6eac9c9fd4836fba948699fd28.jpg",
"blockedByMe": false,
"explicitlyFollowedByMe": false,
"followerCount": 55,
"fullName": "Chloe Marie Monroe",
"imageLargeUrl": "https://i.pinimg.com/140x140_RS/90/99/6f/90996f6eac9c9fd4836fba948699fd28.jpg",
"imageSmallUrl": "https://i.pinimg.com/30x30_RS/90/99/6f/90996f6eac9c9fd4836fba948699fd28.jpg",
"isVerifiedMerchant": false,
"verifiedIdentity": {
"verified": null
}
},
"pinner": {
"blockedByMe": false,
"id": "VXNlcjozNjY2MjMyMTg3NDk5NjcxNQ==",
"entityId": "36662321874996715",
"__typename": "User",
"fullName": "Crystal Catlett",
"imageSmallUrl": "https://i.pinimg.com/30x30_RS/51/76/82/5176824c31aaeec633f0f09bf1ca12e4.jpg",
"imageLargeUrl": "https://i.pinimg.com/140x140_RS/51/76/82/5176824c31aaeec633f0f09bf1ca12e4.jpg",
"explicitlyFollowedByMe": false,
"username": "cc1025",
"imageMediumUrl": "https://i.pinimg.com/75x75_RS/51/76/82/5176824c31aaeec633f0f09bf1ca12e4.jpg",
"firstName": "Crystal",
"followerCount": 347,
"isVerifiedMerchant": false,
"verifiedIdentity": {
"verified": null
}
},
"imageSpec_orig": {
"url": "https://i.pinimg.com/originals/71/5c/5d/715c5d48feb038e16f48a28e6f8ca1f3.jpg"
},
"description": " ",
"shareCount": 0,
"nativeCreator": null,
"createdAt": "Mon, 09 Jun 2025 04:04:22 +0000",
"repinCount": 88,
"totalReactionCount": 88
},
"schema": {
"$ref": "#/components/schemas/ResponseD03A0F58B24A_PinterestPinResponse"
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "pin",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "10",
"x-aisa-passthrough": true,
"x-aisa-pricing": {
"cost_contract": "response_count",
"customer_multiplier": 1.0,
"customer_pricing": "provider_cost_multiplier",
"default_request_estimate_usd": 0.00188,
"estimate_source": "profile_seed",
"evidence_source": "response_body"
},
"x-aisa-query-policy": {
"ignore_undeclared": false,
"request_wins": false
},
"x-aisa-revision": {
"customer_pricing_ref": "86baa23d8df7",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "4c2309f5add2"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/v1/pinterest/pin",
"x-aisa-validation": "mixed",
"x-aisa-catalog-id": "scrape-creators",
"x-aisa-runtime-operation": {
"operation_id": "get_pinterest_pin",
"method": "ANY",
"path": "/apis/v1/pinterest/pin"
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/pinterest.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:64e778971e726a29d5917257335f14776712f2e15294d5a09da8dc7ab9b8875f",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:b7c6f6b9f868877a41dbf1e72b1ef46742404410edc7d98c18f0d8a825933ff1"
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/pinterest.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:64e778971e726a29d5917257335f14776712f2e15294d5a09da8dc7ab9b8875f",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:b7c6f6b9f868877a41dbf1e72b1ef46742404410edc7d98c18f0d8a825933ff1"
},
"content_hash": "sha256:e8efe6693876f8dd83dfd3ee3fa6abd0188a41362f58e3783038fc7631a0b8c0"
},
"x-aisa-identity": {
"schema_version": 1,
"canonical_operation_id": "get_pinterest_pin",
"historical_aliases": [
{
"operation_id": "get_pinterest-pin",
"locale": "zh",
"published_ref": "e0ee9af05d7407976af62a72ac4e3499703a4f6a",
"source_file": "openapi/zh/pinterest.json",
"source_sha256": "9c0d38eb22fd596ba150cf94b794d397b9073e4f8d7cf62f973c035576c36149",
"canonical_source_file": "openapi/pinterest.json",
"canonical_source_sha256": "05b56f31d451f0848d17a261196e0979b3ed4fb40fca2a39e7038d1bf6fbec93",
"public_path": "/apis/v1/pinterest/pin",
"method": "GET"
}
],
"sha256": "sha256:4d48bce3e8241c5d0d6f915f93544accd079eb66ebef7013a413c0c306d64352"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/pinterest/get_pinterest-pin"
}
},
"/apis/v1/pinterest/search": {
"get": {
"description": "Searches Pinterest for pins matching a keyword and returns pins plus a cursor to page. Each pin carries id, url, title, description, grid_title, created_at, images in five sizes (170x, 236x, 474x, 736x, orig), link, domain, board (name, url, pin_count) and pinner (username). Measured at about 110 KB for 17 pins; trim=true cuts that to 28 KB and keeps six fields per pin — id, url, description, created_at, images and pinner — dropping title, link, board and domain, so only skip trim when you need those. The board.url on each result feeds get_pinterest_board; for one pin's engagement counts use get_pinterest_pin.\n\n\nUsage-based billing; Default request estimate: $0.00188 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n",
"operationId": "get_pinterest_search",
"parameters": [
{
"in": "query",
"name": "limit",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "query",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "trim",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"example": {
"success": true,
"pins": [
{
"id": "643874078015272259",
"url": "https://www.pinterest.com/pin/643874078015272259",
"description": "#cute #animal #dog #puppy #pfp #icon #dogpfp #silly #cutepuppy #bordercollie #fyp #trend",
"created_at": "Tue, 10 Jun 2025 21:45:32 +0000",
"pinner": {
"node_id": "VXNlcjo2NDM4NzQyMTUzODQxMzkwMTg=",
"full_name": "Annika Strøm",
"is_ads_only_profile": false,
"username": "annikastrom2",
"image_medium_url": "https://i.pinimg.com/75x75_RS/60/d5/a8/60d5a8405ec70c5c46b677186c626587.jpg",
"is_primary_website_verified": false,
"follower_count": 2,
"ads_only_profile_site": null,
"id": "643874215384139018",
"is_verified_merchant": false,
"image_large_url": "https://i.pinimg.com/140x140_RS/60/d5/a8/60d5a8405ec70c5c46b677186c626587.jpg",
"verified_identity": {},
"image_small_url": "https://i.pinimg.com/30x30_RS/60/d5/a8/60d5a8405ec70c5c46b677186c626587.jpg"
},
"images": {
"170x": {
"width": 236,
"height": 312,
"url": "https://i.pinimg.com/236x/a7/d6/dc/a7d6dced1ee95c11a150dcf2f1c6e05f.jpg"
},
"236x": {
"width": 236,
"height": 312,
"url": "https://i.pinimg.com/236x/a7/d6/dc/a7d6dced1ee95c11a150dcf2f1c6e05f.jpg"
},
"474x": {
"width": 474,
"height": 626,
"url": "https://i.pinimg.com/474x/a7/d6/dc/a7d6dced1ee95c11a150dcf2f1c6e05f.jpg"
},
"736x": {
"width": 736,
"height": 973,
"url": "https://i.pinimg.com/736x/a7/d6/dc/a7d6dced1ee95c11a150dcf2f1c6e05f.jpg"
},
"orig": {
"width": 946,
"height": 1251,
"url": "https://i.pinimg.com/originals/a7/d6/dc/a7d6dced1ee95c11a150dcf2f1c6e05f.jpg"
}
}
}
],
"cursor": "Y2JVSG81V2sxcmNHRlpWM1J5VFVad1ZsWl..."
},
"schema": {
"$ref": "#/components/schemas/ResponseD03A0F58B24A_PinterestPinsResponse"
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "search",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "10",
"x-aisa-passthrough": true,
"x-aisa-pricing": {
"cost_contract": "response_count",
"customer_multiplier": 1.0,
"customer_pricing": "provider_cost_multiplier",
"default_request_estimate_usd": 0.00188,
"estimate_source": "profile_seed",
"evidence_source": "response_body"
},
"x-aisa-query-policy": {
"ignore_undeclared": false,
"request_wins": false
},
"x-aisa-revision": {
"customer_pricing_ref": "86baa23d8df7",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "d0f22f1e17bc"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/v1/pinterest/search",
"x-aisa-validation": "mixed",
"x-aisa-catalog-id": "scrape-creators",
"x-aisa-runtime-operation": {
"operation_id": "get_pinterest_search",
"method": "ANY",
"path": "/apis/v1/pinterest/search"
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/pinterest.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:64e778971e726a29d5917257335f14776712f2e15294d5a09da8dc7ab9b8875f",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:b7c6f6b9f868877a41dbf1e72b1ef46742404410edc7d98c18f0d8a825933ff1"
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/pinterest.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:64e778971e726a29d5917257335f14776712f2e15294d5a09da8dc7ab9b8875f",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:b7c6f6b9f868877a41dbf1e72b1ef46742404410edc7d98c18f0d8a825933ff1"
},
"content_hash": "sha256:1a169285cd9610e1d29502a0f0922cc8a475c0de4d2a66e6b543808e58d60763"
},
"x-aisa-identity": {
"schema_version": 1,
"canonical_operation_id": "get_pinterest_search",
"historical_aliases": [
{
"operation_id": "get_pinterest-search",
"locale": "zh",
"published_ref": "e0ee9af05d7407976af62a72ac4e3499703a4f6a",
"source_file": "openapi/zh/pinterest.json",
"source_sha256": "9c0d38eb22fd596ba150cf94b794d397b9073e4f8d7cf62f973c035576c36149",
"canonical_source_file": "openapi/pinterest.json",
"canonical_source_sha256": "05b56f31d451f0848d17a261196e0979b3ed4fb40fca2a39e7038d1bf6fbec93",
"public_path": "/apis/v1/pinterest/search",
"method": "GET"
}
],
"sha256": "sha256:a687ea2d4dcbbca6c301a232c87844fb79ba5ba38b7e13775b27beead7aad989"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/pinterest/get_pinterest-search"
}
},
"/apis/v1/pinterest/user/boards": {
"get": {
"description": "Lists a user's public boards by username, with a cursor to page. Each board carries id, name, url, description, pin_count, follower_count, section_count, collaborator_count, privacy, owner, created_at, cover_pin and cover_images. Measured at 59 KB for 10 boards; trim=true collapses it to 3.3 KB — the largest trim ratio in this API — keeping id, name, url, description, pin_count, follower_count, created_at and image_cover_hd_url. The handle is the bare username as it appears in a profile URL (agkelsey, not a full URL). Feed each board's url to get_pinterest_board to read its pins; to search across all of Pinterest use get_pinterest_search.\n\n\nUsage-based billing; Default request estimate: $0.00188 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n",
"operationId": "get_pinterest_user_boards",
"parameters": [
{
"in": "query",
"name": "handle",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "trim",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"example": {
"success": true,
"boards": [
{
"id": "549580029467577434",
"url": "https://www.pinterest.com/sharat24k/turkey-recipes/",
"description": "",
"follower_count": 292,
"pin_count": 545,
"name": "Turkey Recipes",
"image_cover_hd_url": "https://i.pinimg.com/474x/45/00/df/4500dfc5bc8bbc15137ff9d9abf04cc1.jpg",
"created_at": "Mon, 17 Feb 2025 02:19:26 +0000"
}
],
"cursor": "LT41NDk1ODAwMjk0Njc1Njc1O...."
},
"schema": {
"$ref": "#/components/schemas/ResponseD03A0F58B24A_PinterestBoardsResponse"
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "boards",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "10",
"x-aisa-passthrough": true,
"x-aisa-pricing": {
"cost_contract": "response_count",
"customer_multiplier": 1.0,
"customer_pricing": "provider_cost_multiplier",
"default_request_estimate_usd": 0.00188,
"estimate_source": "profile_seed",
"evidence_source": "response_body"
},
"x-aisa-query-policy": {
"ignore_undeclared": false,
"request_wins": false
},
"x-aisa-revision": {
"customer_pricing_ref": "86baa23d8df7",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "40fda431efd1"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/v1/pinterest/user/boards",
"x-aisa-validation": "mixed",
"x-aisa-catalog-id": "scrape-creators",
"x-aisa-runtime-operation": {
"operation_id": "get_pinterest_user_boards",
"method": "ANY",
"path": "/apis/v1/pinterest/user/boards"
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/pinterest.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:64e778971e726a29d5917257335f14776712f2e15294d5a09da8dc7ab9b8875f",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:b7c6f6b9f868877a41dbf1e72b1ef46742404410edc7d98c18f0d8a825933ff1"
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/pinterest.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:64e778971e726a29d5917257335f14776712f2e15294d5a09da8dc7ab9b8875f",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:b7c6f6b9f868877a41dbf1e72b1ef46742404410edc7d98c18f0d8a825933ff1"
},
"content_hash": "sha256:fe66b46bb24c50379cc943ca5461e69bf3add1da07be45fdb86cb2aa51e86e48"
},
"x-aisa-identity": {
"schema_version": 1,
"canonical_operation_id": "get_pinterest_user_boards",
"historical_aliases": [
{
"operation_id": "get_pinterest-user-boards",
"locale": "zh",
"published_ref": "e0ee9af05d7407976af62a72ac4e3499703a4f6a",
"source_file": "openapi/zh/pinterest.json",
"source_sha256": "9c0d38eb22fd596ba150cf94b794d397b9073e4f8d7cf62f973c035576c36149",
"canonical_source_file": "openapi/pinterest.json",
"canonical_source_sha256": "05b56f31d451f0848d17a261196e0979b3ed4fb40fca2a39e7038d1bf6fbec93",
"public_path": "/apis/v1/pinterest/user/boards",
"method": "GET"
}
],
"sha256": "sha256:9a073e4a1509c02efe2af782759042c72b45ea10062ec495ca18a322dc8a60ac"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/pinterest/get_pinterest-user-boards"
}
},
"/apis/v1/reddit/post/comments": {
"get": {
"description": "Returns one post and its discussion from a post URL: post with title, author, selftext, score, ups, upvote_ratio, num_comments, created_utc, permalink, archived and locked, then comments, each with author, body, score, ups, downs, created_utc, parent_id, permalink and a nested replies object holding items and more. Paging is a third shape again: the top level carries more.has_more and more.cursor rather than the after of get_reddit_search or the cursor of get_reddit_subreddit_search. Measured at about 21 KB for 19 top-level comments. To find posts worth opening, start from get_reddit_search or get_reddit_subreddit.\n\n\nUsage-based billing; Default request estimate: $0.00188 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n",
"operationId": "get_reddit_post_comments",
"parameters": [
{
"in": "query",
"name": "cursor",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "trimmed",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "url",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"example": {
"comments": [
{
"id": "mymupxb",
"author": "Background-Emu-2890",
"author_fullname": "t2_efdlposp6",
"body": "Black cat i have one and i love her so much !",
"name": "t1_mymupxb",
"created_utc": 1750342221,
"created_at_iso": "2025-06-19T14:10:21.000Z",
"parent_id": "t3_1lfbo7u",
"url": "https://www.reddit.com/r/AskReddit/comments/1lfbo7u/what_is_a_thing_you_love_that_lots_of_people_hate/mymupxb/",
"replies": {
"items": [
{
"url": "https://www.reddit.com/r/AskReddit/comments/1lfbo7u/what_is_a_thing_you_love_that_lots_of_people_hate/mymxwde/",
"created_utc": 1750343166,
"created_at_iso": "2025-06-19T14:26:06.000Z",
"subreddit_id": "t5_2qh1i",
"approved_at_utc": null,
"author_is_blocked": false,
"comment_type": null,
"awarders": [],
"mod_reason_by": null,
"banned_by": null,
"author_flair_type": "text",
"total_awards_received": 0,
"subreddit": "AskReddit",
"author_flair_template_id": null,
"likes": null,
"replies": {
"items": [],
"more": {
"has_more": false,
"next_cursor": null
}
},
"user_reports": [],
"saved": false,
"id": "mymxwde",
"banned_at_utc": null,
"mod_reason_title": null,
"gilded": 0,
"archived": false,
"collapsed_reason_code": null,
"no_follow": false,
"author": "doublestitch",
"can_mod_post": false,
"send_replies": true,
"parent_id": "t1_mymupxb",
"score": 19,
"author_fullname": "t2_10py0g",
"removal_reason": null,
"approved_by": null,
"mod_note": null,
"all_awardings": [],
"body": "House panthers for the win",
"edited": false,
"top_awarded_type": null,
"author_flair_css_class": null,
"name": "t1_mymxwde",
"is_submitter": false,
"downs": 0,
"author_flair_richtext": [],
"author_patreon_flair": false,
"body_html": "<div class=\"md\"><p>House panthers for the win</p>\n</div>",
"gildings": {},
"collapsed_reason": null,
"distinguished": null,
"associated_award": null,
"stickied": false,
"author_premium": false,
"can_gild": false,
"link_id": "t3_1lfbo7u",
"unrepliable_reason": null,
"author_flair_text_color": null,
"score_hidden": false,
"permalink": "/r/AskReddit/comments/1lfbo7u/what_is_a_thing_you_love_that_lots_of_people_hate/mymxwde/",
"subreddit_type": "public",
"locked": false,
"report_reasons": null,
"created": 1750343166,
"author_flair_text": null,
"treatment_tags": [],
"collapsed": false,
"subreddit_name_prefixed": "r/AskReddit",
"controversiality": 0,
"depth": 1,
"author_flair_background_color": null,
"collapsed_because_crowd_control": null,
"mod_reports": [],
"num_reports": null,
"ups": 19
}
],
"more": {
"has_more": true,
"cursor": "myn970w"
}
},
"ups": 75,
"downs": 0,
"score": 75
}
],
"post": {
"id": "1lfbo7u",
"author": "Vetro_Nodulare2",
"author_fullname": "t2_16syu27ar1",
"subreddit": "AskReddit",
"title": "What is a thing you love that lots of people hate?",
"downs": 0,
"name": "t3_1lfbo7u",
"upvote_ratio": 0.91,
"ups": 47,
"total_awards_received": 0,
"score": 47,
"created": 1750341959,
"num_comments": 353,
"url": "https://www.reddit.com/r/AskReddit/comments/1lfbo7u/what_is_a_thing_you_love_that_lots_of_people_hate/",
"subreddit_subscribers": 56146601,
"is_video": false,
"created_utc": 1750341959
},
"more": {
"has_more": true,
"cursor": "myoaw2m,myob40l,myoeo9h"
}
},
"schema": {
"$ref": "#/components/schemas/Response799D183Abaf0_RedditCommentsResponse"
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "comments",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "10",
"x-aisa-passthrough": true,
"x-aisa-pricing": {
"cost_contract": "response_count",
"customer_multiplier": 1.0,
"customer_pricing": "provider_cost_multiplier",
"default_request_estimate_usd": 0.00188,
"estimate_source": "profile_seed",
"evidence_source": "response_body"
},
"x-aisa-query-policy": {
"ignore_undeclared": false,
"request_wins": false
},
"x-aisa-revision": {
"customer_pricing_ref": "86baa23d8df7",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "56e2b79ba192"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/v1/reddit/post/comments",
"x-aisa-validation": "mixed",
"x-aisa-catalog-id": "scrape-creators",
"x-aisa-runtime-operation": {
"operation_id": "get_reddit_post_comments",
"method": "ANY",
"path": "/apis/v1/reddit/post/comments"
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/reddit.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1a17302eab5d9e9ab30162f30806ab1c5133002d6358144e2cd8664861d30e42",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:26145b81d6f6da334df73e1dee35b4246e3dde6a417f80b2ab491d3772e2b6de"
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/reddit.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1a17302eab5d9e9ab30162f30806ab1c5133002d6358144e2cd8664861d30e42",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:26145b81d6f6da334df73e1dee35b4246e3dde6a417f80b2ab491d3772e2b6de"
},
"content_hash": "sha256:f0c44ff61e2cb5f7ad6e19386414dda93adad8bc2f017db3c6385884986ea8db"
},
"x-aisa-identity": {
"schema_version": 1,
"canonical_operation_id": "get_reddit_post_comments",
"historical_aliases": [
{
"operation_id": "get_reddit-post-comments",
"locale": "zh",
"published_ref": "e0ee9af05d7407976af62a72ac4e3499703a4f6a",
"source_file": "openapi/zh/reddit.json",
"source_sha256": "ecc6e5748c89d5e710520ca590a4ae3be1dad723bad2fdc01c701aeb55a44d59",
"canonical_source_file": "openapi/reddit.json",
"canonical_source_sha256": "faec0f599cd1854ec63c52a2db5b042d8feeffc85245122341b98fcd2ce97693",
"public_path": "/apis/v1/reddit/post/comments",
"method": "GET"
}
],
"sha256": "sha256:683ac14e43c682aec414ebb925fef24772caf7986226368de436bec851594a5e"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/reddit/get_reddit-post-comments"
}
},
"/apis/v1/reddit/search": {
"get": {
"description": "Searches every public subreddit for posts matching a query and returns posts plus an after token to page. Each post carries title, author, selftext, selftext_html, subreddit, score, ups, downs, upvote_ratio, num_comments, created_utc, created_at_iso, url, permalink, subreddit_subscribers, is_video, over_18 and spoiler. sort accepts relevance, new, top and comment_count, and timeframe narrows the window. Measured at 8 to 16 seconds and 8 to 26 KB, the slowest endpoint here. To stay inside one community use get_reddit_subreddit_search, which is faster and pages with cursor rather than after; to read one post's discussion use get_reddit_post_comments.\n\n\nUsage-based billing; Default request estimate: $0.00188 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n",
"operationId": "get_reddit_search",
"parameters": [
{
"in": "query",
"name": "count",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "limit",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "query",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "sort",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "time",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "timeframe",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "trim",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "trimmed",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"example": {
"success": true,
"posts": [
{
"id": "w63dgy",
"author": "Morgentau7",
"author_fullname": "t2_2hy2xjit",
"subreddit": "MadeMeSmile",
"title": "Player realizes that he nearly stole the dogs job",
"downs": 0,
"name": "t3_w63dgy",
"upvote_ratio": 0.97,
"ups": 220403,
"total_awards_received": 0,
"score": 220403,
"created": 1658580900,
"num_comments": 1246,
"url": "https://www.reddit.com/r/MadeMeSmile/comments/w63dgy/player_realizes_that_he_nearly_stole_the_dogs_job/",
"subreddit_subscribers": 11605207,
"is_video": true,
"created_utc": 1658580900
}
],
"after": "t3_1izmcgx"
},
"schema": {
"$ref": "#/components/schemas/Response799D183Abaf0_RedditPostsResponse"
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "search",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "10",
"x-aisa-passthrough": true,
"x-aisa-pricing": {
"cost_contract": "response_count",
"customer_multiplier": 1.0,
"customer_pricing": "provider_cost_multiplier",
"default_request_estimate_usd": 0.00188,
"estimate_source": "profile_seed",
"evidence_source": "response_body"
},
"x-aisa-query-policy": {
"ignore_undeclared": false,
"request_wins": false
},
"x-aisa-revision": {
"customer_pricing_ref": "86baa23d8df7",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "e9942a45f168"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/v1/reddit/search",
"x-aisa-validation": "mixed",
"x-aisa-catalog-id": "scrape-creators",
"x-aisa-runtime-operation": {
"operation_id": "get_reddit_search",
"method": "ANY",
"path": "/apis/v1/reddit/search"
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/reddit.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1a17302eab5d9e9ab30162f30806ab1c5133002d6358144e2cd8664861d30e42",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:26145b81d6f6da334df73e1dee35b4246e3dde6a417f80b2ab491d3772e2b6de"
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/reddit.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1a17302eab5d9e9ab30162f30806ab1c5133002d6358144e2cd8664861d30e42",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:26145b81d6f6da334df73e1dee35b4246e3dde6a417f80b2ab491d3772e2b6de"
},
"content_hash": "sha256:85c275cf660f39d0c203b3d302440d7ed4c9fc0cb8f8f7cdba63922c540a23c7"
},
"x-aisa-identity": {
"schema_version": 1,
"canonical_operation_id": "get_reddit_search",
"historical_aliases": [
{
"operation_id": "get_reddit-search",
"locale": "zh",
"published_ref": "e0ee9af05d7407976af62a72ac4e3499703a4f6a",
"source_file": "openapi/zh/reddit.json",
"source_sha256": "ecc6e5748c89d5e710520ca590a4ae3be1dad723bad2fdc01c701aeb55a44d59",
"canonical_source_file": "openapi/reddit.json",
"canonical_source_sha256": "faec0f599cd1854ec63c52a2db5b042d8feeffc85245122341b98fcd2ce97693",
"public_path": "/apis/v1/reddit/search",
"method": "GET"
}
],
"sha256": "sha256:fc7a02228a8dfdd0588e5469998cb12ec12505cf20c43e1db60caa69ff1d4038"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/reddit/get_reddit-search"
}
},
"/apis/v1/reddit/subreddit": {
"get": {
"description": "Returns the post stream of one subreddit with an after token to page. Posts carry the same fields as get_reddit_search, including title, author, selftext, score, ups, upvote_ratio, num_comments, created_utc, created_at_iso, url, permalink and subreddit_subscribers. sort accepts best, hot, new, top and rising. Important: timeframe is only accepted together with sort=top, and any other combination returns 400 rather than ignoring the parameter. Subreddit names are case-sensitive. Measured at about 18 KB for 24 posts. To search inside the same subreddit use get_reddit_subreddit_search, and for its metadata use get_reddit_subreddit_details.\n\n\nUsage-based billing; Default request estimate: $0.00188 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n",
"operationId": "get_reddit_subreddit",
"parameters": [
{
"in": "query",
"name": "after",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "cache_max_age",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "sort",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "subreddit",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "timeframe",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "trim",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"example": {
"posts": [
{
"id": "1lfbo7u",
"author": "Vetro_Nodulare2",
"author_fullname": "t2_16syu27ar1",
"subreddit": "AskReddit",
"title": "What is a thing you love that lots of people hate?",
"downs": 0,
"name": "t3_1lfbo7u",
"upvote_ratio": 0.9,
"ups": 45,
"total_awards_received": 0,
"score": 45,
"created": 1750341959,
"num_comments": 349,
"url": "https://www.reddit.com/r/AskReddit/comments/1lfbo7u/what_is_a_thing_you_love_that_lots_of_people_hate/",
"subreddit_subscribers": 56146328,
"is_video": false,
"created_utc": 1750341959
}
],
"after": "t3_1lfogps"
},
"schema": {
"$ref": "#/components/schemas/Response799D183Abaf0_RedditPostsResponse"
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "subreddit",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "10",
"x-aisa-passthrough": true,
"x-aisa-pricing": {
"cost_contract": "response_count",
"customer_multiplier": 1.0,
"customer_pricing": "provider_cost_multiplier",
"default_request_estimate_usd": 0.00188,
"estimate_source": "profile_seed",
"evidence_source": "response_body"
},
"x-aisa-query-policy": {
"ignore_undeclared": false,
"request_wins": false
},
"x-aisa-revision": {
"customer_pricing_ref": "86baa23d8df7",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "5ed044fed9c2"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/v1/reddit/subreddit",
"x-aisa-validation": "mixed",
"x-aisa-catalog-id": "scrape-creators",
"x-aisa-runtime-operation": {
"operation_id": "get_reddit_subreddit",
"method": "ANY",
"path": "/apis/v1/reddit/subreddit"
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/reddit.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1a17302eab5d9e9ab30162f30806ab1c5133002d6358144e2cd8664861d30e42",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:26145b81d6f6da334df73e1dee35b4246e3dde6a417f80b2ab491d3772e2b6de"
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/reddit.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1a17302eab5d9e9ab30162f30806ab1c5133002d6358144e2cd8664861d30e42",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:26145b81d6f6da334df73e1dee35b4246e3dde6a417f80b2ab491d3772e2b6de"
},
"content_hash": "sha256:75005b88610e48d0636c7c3edcf309e77c9324697e3b505dbd45789b04cd4333"
},
"x-aisa-identity": {
"schema_version": 1,
"canonical_operation_id": "get_reddit_subreddit",
"historical_aliases": [
{
"operation_id": "get_reddit-subreddit",
"locale": "zh",
"published_ref": "e0ee9af05d7407976af62a72ac4e3499703a4f6a",
"source_file": "openapi/zh/reddit.json",
"source_sha256": "ecc6e5748c89d5e710520ca590a4ae3be1dad723bad2fdc01c701aeb55a44d59",
"canonical_source_file": "openapi/reddit.json",
"canonical_source_sha256": "faec0f599cd1854ec63c52a2db5b042d8feeffc85245122341b98fcd2ce97693",
"public_path": "/apis/v1/reddit/subreddit",
"method": "GET"
}
],
"sha256": "sha256:8e5a7e101a277221af788ebbe11654d6e0b462dd4cc9ac6f15d5acdff1c9056e"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/reddit/get_reddit-subreddit"
}
},
"/apis/v1/reddit/subreddit/details": {
"get": {
"description": "Returns metadata about one subreddit, by name or by URL: subreddit_id, display_name, subscribers, weekly_active_users, weekly_contributions, description, rules, icon_img, header_img, advertiser_category, submit_text and created_at. Use it to size a community or read its rules before posting anything elsewhere. The name is case-sensitive, so AskReddit resolves and askreddit does not. Measured at about 5 KB, the smallest response here. It returns no posts at all: for those call get_reddit_subreddit, or get_reddit_subreddit_search to query within the community.\n\n\nUsage-based billing; Default request estimate: $0.00188 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n",
"operationId": "get_reddit_subreddit_details",
"parameters": [
{
"in": "query",
"name": "subreddit",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"example": {
"success": true,
"credits_remaining": 33950256,
"subreddit_id": "t5_a7wuv",
"display_name": "AbsoluteUnits",
"weekly_active_users": 1428398,
"weekly_contributions": 8923,
"rules": "#ABSOLUTE UNITS\n\n---\n\n Be in awe at the size of these lads\n\n---\n\n###[Check out our deep, well-reflected definitions of an absolute unit.](https://www.reddit.com/r/AbsoluteUnits/wiki/index) ",
"description": "Absolute Unit : an Animal or Public Figure, who is larger than we should normally expect.",
"header_img": null,
"icon_img": "https://styles.redditmedia.com/t5_a7wuv/styles/communityIcon_t3cspt08bl681.png?width=128&frame=1&auto=webp&s=6f7e59ccf1724bd6c8b3e0d2840c9b21297102c3",
"subscribers": 1923642,
"advertiser_category": "",
"created_at": "2018-01-05T10:35:24.000Z",
"submit_text": ""
},
"schema": {
"$ref": "#/components/schemas/Response799D183Abaf0_RedditSubredditDetailsResponse"
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "details",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "10",
"x-aisa-passthrough": true,
"x-aisa-pricing": {
"cost_contract": "response_count",
"customer_multiplier": 1.0,
"customer_pricing": "provider_cost_multiplier",
"default_request_estimate_usd": 0.00188,
"estimate_source": "profile_seed",
"evidence_source": "response_body"
},
"x-aisa-query-policy": {
"ignore_undeclared": false,
"request_wins": false
},
"x-aisa-revision": {
"customer_pricing_ref": "86baa23d8df7",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "fc9270a09eb8"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/v1/reddit/subreddit/details",
"x-aisa-validation": "mixed",
"x-aisa-catalog-id": "scrape-creators",
"x-aisa-runtime-operation": {
"operation_id": "get_reddit_subreddit_details",
"method": "ANY",
"path": "/apis/v1/reddit/subreddit/details"
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/reddit.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1a17302eab5d9e9ab30162f30806ab1c5133002d6358144e2cd8664861d30e42",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:26145b81d6f6da334df73e1dee35b4246e3dde6a417f80b2ab491d3772e2b6de"
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/reddit.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1a17302eab5d9e9ab30162f30806ab1c5133002d6358144e2cd8664861d30e42",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:26145b81d6f6da334df73e1dee35b4246e3dde6a417f80b2ab491d3772e2b6de"
},
"content_hash": "sha256:96cd838e38b2b3941f8dd7abe7bb8542de9f5423cb10ebf1c6a3573666a55200"
},
"x-aisa-identity": {
"schema_version": 1,
"canonical_operation_id": "get_reddit_subreddit_details",
"historical_aliases": [
{
"operation_id": "get_reddit-subreddit-details",
"locale": "zh",
"published_ref": "e0ee9af05d7407976af62a72ac4e3499703a4f6a",
"source_file": "openapi/zh/reddit.json",
"source_sha256": "ecc6e5748c89d5e710520ca590a4ae3be1dad723bad2fdc01c701aeb55a44d59",
"canonical_source_file": "openapi/reddit.json",
"canonical_source_sha256": "faec0f599cd1854ec63c52a2db5b042d8feeffc85245122341b98fcd2ce97693",
"public_path": "/apis/v1/reddit/subreddit/details",
"method": "GET"
}
],
"sha256": "sha256:5e57eb9a57e2f9f7d3d5268d01932fc9178abcb423e9233c04f7264252e4d9de"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/reddit/get_reddit-subreddit-details"
}
},
"/apis/v1/reddit/subreddit/search": {
"get": {
"description": "Searches inside one subreddit and returns matching posts with a cursor token to page. Posts carry title, author, selftext, score, ups, upvote_ratio, num_comments, created_utc, created_at_iso, url, permalink and is_video. Despite what sort suggests, every sort value returns posts and only posts: comments and media were confirmed absent from all five. Measured at about 5 KB and 2 seconds, faster than get_reddit_search, which searches all of Reddit and pages with after instead of cursor. For the replies under a result, pass its url to get_reddit_post_comments.\n\n\nUsage-based billing; Default request estimate: $0.00188 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n",
"operationId": "get_reddit_subreddit_search",
"parameters": [
{
"in": "query",
"name": "query",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "sort",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "subreddit",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "timeframe",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"example": {
"posts": [
{
"id": "t3_8gmjrb",
"post_id": "t3_8gmjrb",
"title": "Is doing 50-100 pushups a day doing anything?",
"url": "https://www.reddit.com/r/Fitness/comments/8gmjrb/is_doing_50100_pushups_a_day_doing_anything/",
"permalink": "/r/Fitness/comments/8gmjrb/is_doing_50100_pushups_a_day_doing_anything/",
"nsfw": false,
"spoiler": false,
"is_crosspost": false,
"subreddit": {
"id": "t5_2qhx4",
"name": "Fitness",
"nsfw": false,
"quarantined": false,
"icon": "https://b.thumbs.redditmedia.com/Ted4KOMuRbaCYlDS55cTqjpVVZ2ENHKtYFbBFjI1i2o.png",
"banner": null,
"description": "A place for the pursuit of physical fitness goals.\n\nPlease see the r/Fitness Wiki and FAQ at https://thefitness.wiki for help with common questions.",
"weekly_visitors": 898726,
"weekly_contributions": 1827
},
"votes": 1414,
"num_comments": 582,
"created_at": "2018-05-03T01:09:17.620000+0000",
"created_at_iso": "2018-05-03T01:09:17.620Z",
"thumbnail": null,
"thumbnail_blurred": false,
"position": 0,
"relative_position": 0
}
],
"comments": [
{
"id": "t1_nxf7p27",
"post_id": "t3_1q2p898",
"parent_comment_id": null,
"is_reply_to_comment": false,
"author": "Philser23",
"author_avatar": null,
"author_nsfw": false,
"body": "On the 30th my girlfriend out of the blue decided her new year's resolution would be to start going to the gym. I was so excited since none of my partners ever shared the fitness hobby with me.",
"body_html": "On the 30th my girlfriend out of the blue decided her new year's resolution would be to start going to the gym...
",
"images": [],
"votes": 123,
"url": "https://www.reddit.com/r/Fitness/comments/1q2p898/gym_story_saturday/nxf7p27/",
"permalink": "/r/Fitness/comments/1q2p898/gym_story_saturday/nxf7p27/",
"created_at": "2026-01-03T11:26:02.434000+0000",
"created_at_iso": "2026-01-03T11:26:02.434Z",
"post": {
"id": "t3_1q2p898",
"title": "Gym Story Saturday",
"url": "https://www.reddit.com/r/Fitness/comments/1q2p898/gym_story_saturday/",
"permalink": "/r/Fitness/comments/1q2p898/gym_story_saturday/",
"nsfw": false,
"spoiler": false,
"votes": 67,
"num_comments": 80,
"created_at": "2026-01-03T08:15:49.709000+0000",
"created_at_iso": "2026-01-03T08:15:49.709Z"
},
"subreddit": {
"id": "t5_2qhx4",
"name": "Fitness",
"nsfw": false,
"quarantined": false,
"icon": "https://b.thumbs.redditmedia.com/Ted4KOMuRbaCYlDS55cTqjpVVZ2ENHKtYFbBFjI1i2o.png"
},
"position": 0
}
],
"media": [
{
"id": "t3_geo4x",
"title": "Bodyweight training for really strong people. See on you're own what I mean with strong. (Not me)",
"url": "https://www.reddit.com/r/Fitness/comments/geo4x/bodyweight_training_for_really_strong_people_see/",
"permalink": "/r/Fitness/comments/geo4x/bodyweight_training_for_really_strong_people_see/",
"media_type": "image",
"video": null,
"image": {
"src": "https://external-preview.redd.it/X6lz5yGIzqVA5LcI9w-FsQJJHhXoCugDhsXgWW3I404.jpg?format=pjpg&auto=webp&s=46814b0a707a532e39e6c20851ddc1fefb0a111f",
"width": 480,
"height": 360,
"resolutions": [
{
"url": "https://external-preview.redd.it/X6lz5yGIzqVA5LcI9w-FsQJJHhXoCugDhsXgWW3I404.jpg?width=320&crop=smart&format=pjpg&auto=webp&s=144ac4171a1862e5d91d8dd90d44271e22a8273d",
"width": 320
}
]
},
"gallery_count": null,
"aspect_ratio": 1.3333333333333333,
"nsfw": false,
"spoiler": false,
"is_blurred": false,
"subreddit": {
"id": "t5_2qhx4",
"name": "Fitness",
"nsfw": false,
"quarantined": false
},
"position": 0,
"safe_search": "UNAVAILABLE"
}
],
"cursor": "eyJjYW5kaWRhdGVzX3JldHVybmVkIjoie1wic2VjdGlvbl8xX3BpcGVsaW5lXzBfZ2xvYmFsX21vZGlmaWVyc1wiOlwiM1wiLFwic2VjdGlvbl8xX3BpcGVsaW5lXzFfbG9jYWxfbW9kaWZpZXJzXCI6XCIzXCIsXCJzZWN0aW9uXzJfcGlwZWxpbmVfNl9zY29wZV9zd2l0Y2hlclwiOlwiMFwiLFwic2VjdGlvbl8yX3BpcGVsaW5lXzdfcG9zdF9zZWFyY2hcIjpcIjdcIn0ifQ=="
},
"schema": {
"$ref": "#/components/schemas/Response799D183Abaf0_RedditPostsResponse"
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "search",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "10",
"x-aisa-passthrough": true,
"x-aisa-pricing": {
"cost_contract": "response_count",
"customer_multiplier": 1.0,
"customer_pricing": "provider_cost_multiplier",
"default_request_estimate_usd": 0.00188,
"estimate_source": "profile_seed",
"evidence_source": "response_body"
},
"x-aisa-query-policy": {
"ignore_undeclared": false,
"request_wins": false
},
"x-aisa-revision": {
"customer_pricing_ref": "86baa23d8df7",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "daf2571462a7"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/v1/reddit/subreddit/search",
"x-aisa-validation": "mixed",
"x-aisa-catalog-id": "scrape-creators",
"x-aisa-runtime-operation": {
"operation_id": "get_reddit_subreddit_search",
"method": "ANY",
"path": "/apis/v1/reddit/subreddit/search"
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/reddit.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1a17302eab5d9e9ab30162f30806ab1c5133002d6358144e2cd8664861d30e42",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:26145b81d6f6da334df73e1dee35b4246e3dde6a417f80b2ab491d3772e2b6de"
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/reddit.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1a17302eab5d9e9ab30162f30806ab1c5133002d6358144e2cd8664861d30e42",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:26145b81d6f6da334df73e1dee35b4246e3dde6a417f80b2ab491d3772e2b6de"
},
"content_hash": "sha256:af63197fb06fde94833facede31ba3030a9f4450458958206f9b5e38080c73d9"
},
"x-aisa-identity": {
"schema_version": 1,
"canonical_operation_id": "get_reddit_subreddit_search",
"historical_aliases": [
{
"operation_id": "get_reddit-subreddit-search",
"locale": "zh",
"published_ref": "e0ee9af05d7407976af62a72ac4e3499703a4f6a",
"source_file": "openapi/zh/reddit.json",
"source_sha256": "ecc6e5748c89d5e710520ca590a4ae3be1dad723bad2fdc01c701aeb55a44d59",
"canonical_source_file": "openapi/reddit.json",
"canonical_source_sha256": "faec0f599cd1854ec63c52a2db5b042d8feeffc85245122341b98fcd2ce97693",
"public_path": "/apis/v1/reddit/subreddit/search",
"method": "GET"
}
],
"sha256": "sha256:ddfa9c625d2e1f0373171da1ab815b65b57694ece31494951b78795f28ef3cbf"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/reddit/get_reddit-subreddit-search"
}
}
}
}