llms.txt
+17 −19
https://api.shopsocial-api.workers.dev/llms.txt
− > Pay-per-call e-commerce, product, price and social media data tools for AI agents, from public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.− - [GET /api/ecommerce/backmarket](https://api.shopsocial-api.workers.dev/api/ecommerce/backmarket) ($0.02): Back Market refurbished-product search on a country site (en-us, en-gb, fr-fr, de-de, es-es, it-it, ...): total hits and the first page of products with listing id, title, brand, model, category, condition grade, price and currency, new-device price, stock, review average and count, warranty months, colours, sales bucket, image and product link. From backmarket.com via a residential proxy.− - [GET /api/ecommerce/aliexpress](https://api.shopsocial-api.workers.dev/api/ecommerce/aliexpress) ($0.002): AliExpress product search from the public search page: product ID, title, sale price and original price with currency code, discount %, promo label (welcome-gift cards have no price), star rating and units-sold text when shown, listing date, image and product URL; 60 products per page plus the total result count. Language and currency can follow the caller's region (the currency code is a− - [GET /api/ecommerce/ace-hardware](https://api.shopsocial-api.workers.dev/api/ecommerce/ace-hardware) ($0.02): Ace Hardware (US) product search: total hits and up to 30 products per page with product code, name, brand, price, MSRP, on-sale flag, UPC, manufacturer part number, product type, online stock, rating, review count, image and product link. From acehardware.com via a residential proxy.− - [GET /api/ecommerce/dealstream-listings](https://api.shopsocial-api.workers.dev/api/ecommerce/dealstream-listings) ($0.002): DealStream businesses for sale: listing title, asking price (USD), short description, industry, city and state, listing id and link, 25 per page (page 1 to 50), newest first, for the whole US or one state. From dealstream.com's public listing pages via a residential proxy; financial details beyond the asking price are on the listing page.− - [GET /api/ecommerce/dealstream](https://api.shopsocial-api.workers.dev/api/ecommerce/dealstream) ($0.002): DealStream businesses for sale: listing title, asking price (USD), short description, industry, city and state, listing id and link, 25 per page (page 1 to 50), newest first, for the whole US or one state. From dealstream.com's public listing pages via a residential proxy; financial details beyond the asking price are on the listing page.− - [GET /api/ecommerce/pricerunner](https://api.shopsocial-api.workers.dev/api/ecommerce/pricerunner) ($0.002): Price comparison from PriceRunner (Klarna) in the UK, Sweden or Denmark: for a search, products with lowest price and currency, number of shops offering it, category, popularity rank, rating average and count, price-drop info, condition, stock flag, image and comparison URL, plus the total number of hits and the categories found.− - [GET /api/social/tiktok-creative-center-top-ads](https://api.shopsocial-api.workers.dev/api/social/tiktok-creative-center-top-ads) ($0.02): TikTok Creative Center Top Ads: the top-performing TikTok auction ads the public gallery shows first for a region and period (logged-out view: the first 4 cards): ad id, campaign objective, industry, likes, CTR percentile band, budget band, thumbnail and the Creative Center analytics link. From ads.tiktok.com/business/creativecenter via a rendering residen− - [GET /api/social/instagram-reel](https://api.shopsocial-api.workers.dev/api/social/instagram-reel) ($0.002): Recent reels and videos of a public Instagram account from Instagram's web profile JSON: reels and videos among the 12 newest grid posts and the newest long-form (IGTV) videos, each with URL, caption, post time, views, likes, comments and duration. Instagram does not serve the full reels tab or single-reel lookups anonymously, so only these recent items appear. Throttling gives 503 (not− - [GET /api/social/x-com-profiles](https://api.shopsocial-api.workers.dev/api/social/x-com-profiles) ($0.002): Public X (Twitter) profiles for up to 10 usernames via the free FxTwitter API (open-source relay of X's public profile data; X's own API is paid): user ID, name, bio with expanded links, location, website, join date, protected flag, verification (verified + type: individual, business, government), followers, following, posts, likes, media count, avatar and banner. Unknown or suspended u− - [GET /api/social/instagram](https://api.shopsocial-api.workers.dev/api/social/instagram) ($0.002): Engagement snapshot of a public Instagram account from Instagram's web profile JSON: followers, total posts, and the 12 newest posts with likes, comments, video views and per-post engagement rate ((likes+comments)/followers), plus averages, median likes, best post and posting frequency over those 12. Comment text is not served anonymously, only counts. Hidden like counts give null. Throttling giv− - [GET /api/social/tiktok-shop](https://api.shopsocial-api.workers.dev/api/social/tiktok-shop) ($0.002): TikTok Shop (US) category products: the products the public category page shows first (about 10) with title, price, original price, rating, review count, units sold, shop name, brand and product link, plus a few recent buyer reviews and the category tree. Pass a category URL from shop.tiktok.com/us/c/... or its slug and id. Via a residential proxy.− - [GET /api/social/instagram-contact](https://api.shopsocial-api.workers.dev/api/social/instagram-contact) ($0.002): Public contact details of an Instagram account from Instagram's web profile JSON: business email, phone and address (only when the account shows them as public contact buttons), contact method, category, website and bio links, plus emails and phone-like numbers written in the bio. Nothing hidden is looked up. Anonymous access is throttled by Instagram (503, not charged). Unknown u− - [GET /api/social/instagram-posts](https://api.shopsocial-api.workers.dev/api/social/instagram-posts) ($0.002): The 12 most recent grid posts of a public Instagram account from Instagram's web profile JSON: shortcode, URL, type (image/carousel/video/reel), full caption, post time, likes, comments, video views and duration, location and image URL, plus the account's total post count. Only the newest 12 are served anonymously (no paging, no comment text). Private accounts return an empty list. Th− - [GET /api/social/instagram-profile](https://api.shopsocial-api.workers.dev/api/social/instagram-profile) ($0.002): Public Instagram profile from Instagram's web profile JSON: ID, username, full name, bio, external link and bio links, verified/private/business flags, category, exact follower, following and post counts, reel/highlight counts and profile picture. Anonymous access is throttled by Instagram, so a call can fail with 503 (not charged); a few business profiles hit an Instagram-side er− - [GET /api/social/threads-search](https://api.shopsocial-api.workers.dev/api/social/threads-search) ($0.002): Threads (Meta) post search: the top posts for a keyword or hashtag as the logged-out search page shows them (typically 10-20) with author, text, time, likes, replies, reposts, quotes, media and link. From threads.net through a residential proxy; Threads decides the ranking and there is no date filter.− - [GET /api/social/truthsocial](https://api.shopsocial-api.workers.dev/api/social/truthsocial) ($0.003): Truth Social account and its latest posts: profile (name, followers, following, post count, verified, website, joined) and up to 20 newest posts with text, time, replies, reposts, likes, media URLs, link card and repost/quote flags. From truthsocial.com's public Mastodon-style API through a residential proxy.− - [GET /api/social/instagram-related-profiles](https://api.shopsocial-api.workers.dev/api/social/instagram-related-profiles) ($0.002): Accounts Instagram lists as related to a public profile (the suggested-accounts set in Instagram's web profile JSON, often up to ~50): ID, username, full name, verified and private flags, profile picture. No follower counts for the related accounts. Some accounts have no related list (empty result). Throttling gives 503 (not charged); unknown users 404.− - [GET /api/social/youtube-channel-search](https://api.shopsocial-api.workers.dev/api/social/youtube-channel-search) ($0.002): YouTube channels matching a search query (first page, about 20): channel id, name, handle, subscriber count text, description snippet and channel link, from YouTube's public channel-filtered search page. No video lists or exact subscriber counts.+ > Pay-per-call e-commerce, product, price and social media data tools for AI agents, from public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged, and a 503 from a source is temporary and safe to retry.+ - [GET /api/ecommerce/backmarket](https://api.shopsocial-api.workers.dev/api/ecommerce/backmarket) ($0.02): Back Market refurbished-product search on a country site (en-us, en-gb, fr-fr, de-de, es-es, it-it, ...): total hits and the first page of products with listing id, title, brand, model, category, condition grade, price and currency, new-device price, stock, review average and count, warranty months, colours, sales bucket, image and product link. From backmarket.com via a residential proxy.+ - [GET /api/ecommerce/aliexpress](https://api.shopsocial-api.workers.dev/api/ecommerce/aliexpress) ($0.002): AliExpress product search from the public search page: product ID, title, sale price and original price with currency code, discount %, promo label (welcome-gift cards have no price), star rating and units-sold text when shown, listing date, image and product URL; 60 products per page plus the total result count. Language and currency can follow the caller's region (the currency code is a+ - [GET /api/ecommerce/ace-hardware](https://api.shopsocial-api.workers.dev/api/ecommerce/ace-hardware) ($0.02): Ace Hardware (US) product search: total hits and up to 30 products per page with product code, name, brand, price, MSRP, on-sale flag, UPC, manufacturer part number, product type, online stock, rating, review count, image and product link. From acehardware.com via a residential proxy. Takes about 30 s; allow a 60 s timeout.+ - [GET /api/social/tiktok-creative-center-top-ads](https://api.shopsocial-api.workers.dev/api/social/tiktok-creative-center-top-ads) ($0.02): TikTok Creative Center Top Ads: the top-performing TikTok auction ads the public gallery shows first for a region and period (logged-out view: the first 4 cards): ad id, campaign objective, industry, likes, CTR percentile band, budget band, thumbnail and the Creative Center analytics link. From ads.tiktok.com/business/creativecenter via a rendering residen+ - [GET /api/social/instagram-reel](https://api.shopsocial-api.workers.dev/api/social/instagram-reel) ($0.005): Recent videos and reels of a public Instagram account: the videos among its 12 newest grid posts, each with URL, caption, post time, likes, comments and duration (view counts are not served, null). Not the full reels tab. Unknown users 404; a failed fetch 503 (not charged).+ - [GET /api/social/x-com-profiles](https://api.shopsocial-api.workers.dev/api/social/x-com-profiles) ($0.002): Public X (Twitter) profiles for up to 10 usernames via the free FxTwitter API (open-source relay of X's public profile data; X's own API is paid): user ID, name, bio with expanded links, location, website, join date, protected flag, verification (verified + type: individual, business, government), followers, following, posts, likes, media count, avatar and banner. Unknown or suspended u+ - [GET /api/social/instagram](https://api.shopsocial-api.workers.dev/api/social/instagram) ($0.005): Engagement snapshot of a public Instagram account: followers and the 12 newest posts with likes, comments and per-post engagement rate ((likes+comments)/followers), plus averages, median likes, best post and posting frequency over those 12. Only counts, no comment text or video views. Hidden like counts give null. Unknown users 404; a failed fetch 503 (not charged).+ - [GET /api/social/tiktok-shop](https://api.shopsocial-api.workers.dev/api/social/tiktok-shop) ($0.002): TikTok Shop (US) category products: the products the public category page shows first (about 10) with title, price, original price, rating, review count, units sold, shop name, brand and product link, plus a few recent buyer reviews and the category tree. Pass a category slug (e.g. sports-outdoor, beauty-personal-care; the id is looked up) or a shop.tiktok.com/us/c/... URL. Via a residential + - [GET /api/social/instagram-contact](https://api.shopsocial-api.workers.dev/api/social/instagram-contact) ($0.002): Public contact details of an Instagram account as a logged-out visitor sees it: bio links, plus emails and phone-like numbers written in the bio. Business email, phone and address buttons are null while Instagram keeps them behind its login (since 4 Nov 2026). Nothing hidden is looked up. Unknown usernames return 404; a blocked or failed fetch returns 503 (not charged).+ - [GET /api/social/instagram-posts](https://api.shopsocial-api.workers.dev/api/social/instagram-posts) ($0.005): The 12 most recent grid posts of a public Instagram account: shortcode, URL, type (image/carousel/video), full caption, post time, likes, comments, video duration, location and image URL, plus followers. Only the newest 12 (no paging, no comment text, no video view counts). Private accounts return an empty list. Unknown users 404; a failed fetch 503 (not charged). Takes about 26 s; al+ - [GET /api/social/instagram-profile](https://api.shopsocial-api.workers.dev/api/social/instagram-profile) ($0.002): Public Instagram profile as a logged-out visitor sees it: ID, username, full name, bio, bio links, verified and private flags, exact follower and following counts, post count and profile picture. Business category and reel/highlight counts are null while Instagram keeps its profile JSON closed to logged-out clients (since 4 Nov 2026). Unknown usernames return 404; a blocked or fai+ - [GET /api/social/threads-search](https://api.shopsocial-api.workers.dev/api/social/threads-search) ($0.002): Threads (Meta) post search: the top posts for a keyword or hashtag as the logged-out search page shows them (usually 3 to 10) with author, text, time, likes, replies, reposts, quotes, media and link. From threads.net through a residential proxy; Threads decides the ranking and there is no date filter. Some topics (for example body image or health) show no posts to logged-out visitors at+ - [GET /api/social/truthsocial](https://api.shopsocial-api.workers.dev/api/social/truthsocial) ($0.003): Truth Social account and its latest posts: profile (name, followers, following, post count, verified, website, joined) and up to 20 newest posts with text, time, replies, reposts, likes, media URLs, link card and repost/quote flags. From truthsocial.com's public Mastodon-style API through a residential proxy. Usually answers in about 7 s, up to 16 s on slower calls; allow a 30 s timeout.+ - [GET /api/social/instagram-related-profiles](https://api.shopsocial-api.workers.dev/api/social/instagram-related-profiles) ($0.02): Accounts Instagram suggests as related to a public profile (its similar-accounts list), up to 5: ID, username, full name, verified and private flags, profile picture and link. No follower counts for the related accounts. Some accounts have no related list (empty result). Unknown users 404; a failed fetch 503 (not charged).+ - [GET /api/social/youtube-channel-search](https://api.shopsocial-api.workers.dev/api/social/youtube-channel-search) ($0.002): YouTube channels matching a search query (first page, about 20): channel id, name, handle, subscriber count text, description snippet and channel link, from YouTube's public channel-filtered search page. No video lists or exact subscriber counts. Usually answers in about 9 s, up to 28 s on slower calls; allow a 45 s timeout.+ - [Payment networks](https://api.shopsocial-api.workers.dev/payment-networks) (more networks on request)