---
title: "agdata OpenAPI"
description: "Readable operation index for the live HTTP API."
canonical: "/openapi.json.md"
updated: "2026-10-09"
---

# agdata OpenAPI

This page summarizes the live OpenAPI 3.1 document at [/openapi.json](/openapi.json). Calls use JSON request bodies where specified. Paid operations return a quote before work begins and accept the documented payment protocol.

| operationId | Method | Path | Summary | Parameters | Payment |
|---|---|---|---|---|---|
| `listEndpoints` | GET | `/endpoints` | List the API endpoints, one page at a time | limit (optional); cursor (optional) | — |
| `mppAmazon` | POST | `/mpp/amazon` | Amazon product search | Idempotency-Key (optional); JSON: limit, query | x402 or MPP; quote first |
| `mppAmazonReviews` | POST | `/mpp/amazon-reviews` | Amazon customer reviews of a product | Idempotency-Key (optional); JSON: country, limit, product, sort, stars | x402 or MPP; quote first |
| `mppEbaySold` | POST | `/mpp/ebay-sold` | eBay sold prices for resale comps | Idempotency-Key (optional); JSON: condition, days, keyword, limit, site | x402 or MPP; quote first |
| `mppGoogleMaps` | POST | `/mpp/google-maps` | Google Maps places and businesses | Idempotency-Key (optional); JSON: limit, location, query | x402 or MPP; quote first |
| `mppGoogleMapsReviews` | POST | `/mpp/google-maps-reviews` | Google Maps reviews of a place | Idempotency-Key (optional); JSON: language, limit, place, sort | x402 or MPP; quote first |
| `mppGoogleNews` | POST | `/mpp/google-news` | Google News articles for a search | Idempotency-Key (optional); JSON: country, language, limit, query | x402 or MPP; quote first |
| `mppGooglePlayReviews` | POST | `/mpp/google-play-reviews` | Google Play reviews of an Android app | Idempotency-Key (optional); JSON: app, limit, rating, sort | x402 or MPP; quote first |
| `mppGoogleSearch` | POST | `/mpp/google-search` | Google Search results (SERP) | Idempotency-Key (optional); JSON: limit, query | x402 or MPP; quote first |
| `mppIndeedJobs` | POST | `/mpp/indeed-jobs` | Indeed job listings for a search | Idempotency-Key (optional); JSON: country, limit, location, posted, query | x402 or MPP; quote first |
| `mppInstagram` | POST | `/mpp/instagram` | Instagram posts by profile, tag, search | Idempotency-Key (optional); JSON: limit, mode, query | x402 or MPP; quote first |
| `mppInstagramComments` | POST | `/mpp/instagram-comments` | Comments under an Instagram post | Idempotency-Key (optional); JSON: limit, url | x402 or MPP; quote first |
| `mppLinkedin` | POST | `/mpp/linkedin` | LinkedIn profile lookup | Idempotency-Key (optional); JSON: query | x402 or MPP; quote first |
| `mppLinkedinCompany` | POST | `/mpp/linkedin-company` | LinkedIn company enrichment | Idempotency-Key (optional); JSON: companies | x402 or MPP; quote first |
| `mppLinkedinJobs` | POST | `/mpp/linkedin-jobs` | LinkedIn job listings for a search | Idempotency-Key (optional); JSON: limit, location, posted, query | x402 or MPP; quote first |
| `mppLinkedinPosts` | POST | `/mpp/linkedin-posts` | LinkedIn posts of a profile or company | Idempotency-Key (optional); JSON: limit, url | x402 or MPP; quote first |
| `mppLinkedinProfileEmail` | POST | `/mpp/linkedin-profile-email` | LinkedIn profile with verified email | Idempotency-Key (optional); JSON: url | x402 or MPP; quote first |
| `mppMetaAds` | POST | `/mpp/meta-ads` | Public ads from the Meta ad library | Idempotency-Key (optional); JSON: active, country, keyword, limit, page | x402 or MPP; quote first |
| `mppReddit` | POST | `/mpp/reddit` | Reddit posts by subreddit, user, search | Idempotency-Key (optional); JSON: limit, mode, query, raw | x402 or MPP; quote first |
| `mppScreenshot` | POST | `/mpp/screenshot` | Website screenshot or PDF of any URL | Idempotency-Key (optional); JSON: colorScheme, delayMs, device, format, fullPage, height, selector, url, waitForSelector, width | x402 or MPP; quote first |
| `mppSearchPlus` | POST | `/mpp/search-plus` | Web or news search with excerpts | Idempotency-Key (optional); JSON: category, exclude_domains, include_domains, limit, query, type | x402 or MPP; quote first |
| `mppShopifyProducts` | POST | `/mpp/shopify-products` | Public products of a Shopify store | Idempotency-Key (optional); JSON: limit, store | x402 or MPP; quote first |
| `mppTiktok` | POST | `/mpp/tiktok` | TikTok videos by user, hashtag, search | Idempotency-Key (optional); JSON: limit, mode, query, raw | x402 or MPP; quote first |
| `mppTiktokComments` | POST | `/mpp/tiktok-comments` | Comments under a TikTok video | Idempotency-Key (optional); JSON: limit, url | x402 or MPP; quote first |
| `mppTwitter` | POST | `/mpp/twitter` | X (Twitter) tweets by handle or search | Idempotency-Key (optional); JSON: limit, mode, query | x402 or MPP; quote first |
| `mppUnblock` | POST | `/mpp/unblock` | Unblocker: any URL to clean Markdown | Idempotency-Key (optional); JSON: format, url | x402 or MPP; quote first |
| `mppWebSearch` | POST | `/mpp/web-search` | Web search with page content | Idempotency-Key (optional); JSON: limit, query | x402 or MPP; quote first |
| `mppXReplies` | POST | `/mpp/x-replies` | Replies to a post on X | Idempotency-Key (optional); JSON: limit, url | x402 or MPP; quote first |
| `mppYoutube` | POST | `/mpp/youtube` | YouTube video search and channel videos | Idempotency-Key (optional); JSON: limit, mode, query | x402 or MPP; quote first |
| `mppYoutubeComments` | POST | `/mpp/youtube-comments` | Comments under a YouTube video | Idempotency-Key (optional); JSON: limit, sort, url | x402 or MPP; quote first |
| `mppYoutubeTranscript` | POST | `/mpp/youtube-transcript` | YouTube transcript of a video | Idempotency-Key (optional); JSON: format, lang, video | x402 or MPP; quote first |
| `x402Amazon` | POST | `/x402/amazon` | Amazon product search | Idempotency-Key (optional); JSON: limit, query | x402 or MPP; quote first |
| `x402AmazonReviews` | POST | `/x402/amazon-reviews` | Amazon customer reviews of a product | Idempotency-Key (optional); JSON: country, limit, product, sort, stars | x402 or MPP; quote first |
| `x402EbaySold` | POST | `/x402/ebay-sold` | eBay sold prices for resale comps | Idempotency-Key (optional); JSON: condition, days, keyword, limit, site | x402 or MPP; quote first |
| `x402GoogleMaps` | POST | `/x402/google-maps` | Google Maps places and businesses | Idempotency-Key (optional); JSON: limit, location, query | x402 or MPP; quote first |
| `x402GoogleMapsReviews` | POST | `/x402/google-maps-reviews` | Google Maps reviews of a place | Idempotency-Key (optional); JSON: language, limit, place, sort | x402 or MPP; quote first |
| `x402GoogleNews` | POST | `/x402/google-news` | Google News articles for a search | Idempotency-Key (optional); JSON: country, language, limit, query | x402 or MPP; quote first |
| `x402GooglePlayReviews` | POST | `/x402/google-play-reviews` | Google Play reviews of an Android app | Idempotency-Key (optional); JSON: app, limit, rating, sort | x402 or MPP; quote first |
| `x402GoogleSearch` | POST | `/x402/google-search` | Google Search results (SERP) | Idempotency-Key (optional); JSON: limit, query | x402 or MPP; quote first |
| `x402IndeedJobs` | POST | `/x402/indeed-jobs` | Indeed job listings for a search | Idempotency-Key (optional); JSON: country, limit, location, posted, query | x402 or MPP; quote first |
| `x402Instagram` | POST | `/x402/instagram` | Instagram posts by profile, tag, search | Idempotency-Key (optional); JSON: limit, mode, query | x402 or MPP; quote first |
| `x402InstagramComments` | POST | `/x402/instagram-comments` | Comments under an Instagram post | Idempotency-Key (optional); JSON: limit, url | x402 or MPP; quote first |
| `x402Linkedin` | POST | `/x402/linkedin` | LinkedIn profile lookup | Idempotency-Key (optional); JSON: query | x402 or MPP; quote first |
| `x402LinkedinCompany` | POST | `/x402/linkedin-company` | LinkedIn company enrichment | Idempotency-Key (optional); JSON: companies | x402 or MPP; quote first |
| `x402LinkedinJobs` | POST | `/x402/linkedin-jobs` | LinkedIn job listings for a search | Idempotency-Key (optional); JSON: limit, location, posted, query | x402 or MPP; quote first |
| `x402LinkedinPosts` | POST | `/x402/linkedin-posts` | LinkedIn posts of a profile or company | Idempotency-Key (optional); JSON: limit, url | x402 or MPP; quote first |
| `x402LinkedinProfileEmail` | POST | `/x402/linkedin-profile-email` | LinkedIn profile with verified email | Idempotency-Key (optional); JSON: url | x402 or MPP; quote first |
| `x402MetaAds` | POST | `/x402/meta-ads` | Public ads from the Meta ad library | Idempotency-Key (optional); JSON: active, country, keyword, limit, page | x402 or MPP; quote first |
| `x402Reddit` | POST | `/x402/reddit` | Reddit posts by subreddit, user, search | Idempotency-Key (optional); JSON: limit, mode, query, raw | x402 or MPP; quote first |
| `x402Screenshot` | POST | `/x402/screenshot` | Website screenshot or PDF of any URL | Idempotency-Key (optional); JSON: colorScheme, delayMs, device, format, fullPage, height, selector, url, waitForSelector, width | x402 or MPP; quote first |
| `x402SearchPlus` | POST | `/x402/search-plus` | Web or news search with excerpts | Idempotency-Key (optional); JSON: category, exclude_domains, include_domains, limit, query, type | x402 or MPP; quote first |
| `x402ShopifyProducts` | POST | `/x402/shopify-products` | Public products of a Shopify store | Idempotency-Key (optional); JSON: limit, store | x402 or MPP; quote first |
| `x402Tiktok` | POST | `/x402/tiktok` | TikTok videos by user, hashtag, search | Idempotency-Key (optional); JSON: limit, mode, query, raw | x402 or MPP; quote first |
| `x402TiktokComments` | POST | `/x402/tiktok-comments` | Comments under a TikTok video | Idempotency-Key (optional); JSON: limit, url | x402 or MPP; quote first |
| `x402Twitter` | POST | `/x402/twitter` | X (Twitter) tweets by handle or search | Idempotency-Key (optional); JSON: limit, mode, query | x402 or MPP; quote first |
| `x402Unblock` | POST | `/x402/unblock` | Unblocker: any URL to clean Markdown | Idempotency-Key (optional); JSON: format, url | x402 or MPP; quote first |
| `x402WebSearch` | POST | `/x402/web-search` | Web search with page content | Idempotency-Key (optional); JSON: limit, query | x402 or MPP; quote first |
| `x402XReplies` | POST | `/x402/x-replies` | Replies to a post on X | Idempotency-Key (optional); JSON: limit, url | x402 or MPP; quote first |
| `x402Youtube` | POST | `/x402/youtube` | YouTube video search and channel videos | Idempotency-Key (optional); JSON: limit, mode, query | x402 or MPP; quote first |
| `x402YoutubeComments` | POST | `/x402/youtube-comments` | Comments under a YouTube video | Idempotency-Key (optional); JSON: limit, sort, url | x402 or MPP; quote first |
| `x402YoutubeTranscript` | POST | `/x402/youtube-transcript` | YouTube transcript of a video | Idempotency-Key (optional); JSON: format, lang, video | x402 or MPP; quote first |

Request and response schemas, error details, and protocol extensions are available in the JSON document.