{"openapi":"3.0.3","info":{"title":"ReefAPI","version":"1.0.0","description":"Unified data-API gateway. Call POST /{engine}/v1/{action} with an x-api-key header; every response is the { ok, data, meta, error } envelope."},"servers":[{"url":"https://api.reefapi.com"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"Reputation & Reviews"},{"name":"Jobs & Hiring"},{"name":"Real Estate"},{"name":"E-commerce & Marketplaces"},{"name":"Social Media"},{"name":"Travel & Lodging"},{"name":"Search & SEO"},{"name":"Finance & Data"},{"name":"Media, Film & Knowledge"},{"name":"Utilities & AI"},{"name":"Developer Tools"},{"name":"Government & Tenders"},{"name":"Classifieds & Second-hand"}],"paths":{"/academic/v1/search":{"post":{"operationId":"academic_search","summary":"search papers (source=openalex|arxiv|crossref|all; cursor pagination, year/OA/type filters, match=title, fulltext=; first-class author_id/venue_id/institution_id/concept_id/topic_id filters for papers BY an entity)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"source":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"},"filter":{"type":"string"},"sort":{"type":"string"},"from_year":{"type":"string"},"to_year":{"type":"string"},"open_access":{"type":"string"},"type":{"type":"string"},"match":{"type":"string"},"category":{"type":"string"},"include_abstract":{"type":"string"},"fulltext":{"type":"string"},"author_id":{"type":"string"},"venue_id":{"type":"string"},"institution_id":{"type":"string"},"concept_id":{"type":"string"},"topic_id":{"type":"string"}},"required":["query"]},"example":{"query":"covid"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/academic/v1/paper_detail":{"post":{"operationId":"academic_paper_detail","summary":"full paper (abstract/authors/affiliations/venue/year/DOI/OA-PDF/fields); id=OpenAlex|DOI|arXiv|PMID; cross-source abstract gap-fill","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"enrich":{"type":"string"},"raw":{"type":"string"},"fill_abstract":{"type":"string"}},"required":["id"]},"example":{"id":"W3177828909"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/academic/v1/citations":{"post":{"operationId":"academic_citations","summary":"papers that cite this work (cursor-paginated)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}},"required":["id"]},"example":{"id":"W3009885589"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/academic/v1/references":{"post":{"operationId":"academic_references","summary":"works this paper references (hydrated)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"limit":{"type":"string"}},"required":["id"]},"example":{"id":"W3009885589"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/academic/v1/related":{"post":{"operationId":"academic_related","summary":"OpenAlex-curated related works for a paper (co-cited / topically-adjacent), hydrated","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"limit":{"type":"string"}},"required":["id"]},"example":{"id":"W3177828909"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/academic/v1/author":{"post":{"operationId":"academic_author","summary":"author search (query) or profile (id): works_count, h-index, affiliations; include_works for top papers","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"query":{"type":"string"},"include_works":{"type":"string"},"works_limit":{"type":"string"},"per_page":{"type":"string"}}},"example":{"query":"yoshua bengio"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/academic/v1/institution":{"post":{"operationId":"academic_institution","summary":"institution search/profile: ROR, country, geo, works/citation counts, h-index; include_works for the org's papers","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"query":{"type":"string"},"per_page":{"type":"string"},"include_works":{"type":"string"},"works_limit":{"type":"string"}}},"example":{"query":"stanford"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/academic/v1/venue":{"post":{"operationId":"academic_venue","summary":"journal/venue search/profile: ISSN, publisher, OA/DOAJ, h-index, works/citation counts; include_works for the venue's papers","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"query":{"type":"string"},"per_page":{"type":"string"},"include_works":{"type":"string"},"works_limit":{"type":"string"}}},"example":{"query":"nature"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/academic/v1/concept":{"post":{"operationId":"academic_concept","summary":"concept search (query) or profile (id): level, works/citation counts, description; include_works for papers. NOTE: OpenAlex froze the Concepts dataset (ancestors/related now empty) — use `topic` for the live subject hierarchy","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"query":{"type":"string"},"per_page":{"type":"string"},"include_works":{"type":"string"},"works_limit":{"type":"string"}}},"example":{"query":"machine learning"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/academic/v1/topic":{"post":{"operationId":"academic_topic","summary":"topic search (query) or profile (id): domain>field>subfield hierarchy, keywords, siblings, works/citation counts; include_works for papers (the live replacement for Concepts)","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"query":{"type":"string"},"per_page":{"type":"string"},"include_works":{"type":"string"},"works_limit":{"type":"string"}}},"example":{"query":"protein folding"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/academic/v1/autocomplete":{"post":{"operationId":"academic_autocomplete","summary":"fast typeahead suggestions (works/authors/sources/institutions)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"entity":{"type":"string"}},"required":["q"]},"example":{"q":"deep learn"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/academic/v1/batch":{"post":{"operationId":"academic_batch","summary":"hydrate up to 200 papers by id/DOI in one call (RAG/ETL)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"include_abstract":{"type":"string"},"limit":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/agent-source/v1/source_url":{"post":{"operationId":"agent_source_source_url","summary":"Inspect a public URL for source-reliability: reachability, canonical + full redirect chain, title/publisher/published+updated dates, language, official-likelihood, and a stale/archived (wayback) signal.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"check_archive":{"type":"string"},"official_for":{"type":"string"}},"required":["url"]},"example":{"url":"https://openai.com/api/pricing/","official_for":"openai"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/agent-source/v1/official_source":{"post":{"operationId":"agent_source_official_source","summary":"Resolve the OFFICIAL URL a curated provider publishes for a given need (pricing/docs/changelog/status/legal/model_card) + why it is official (domain match + domain age via whois). Curated whitelist only.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"entity":{"type":"string"},"need_type":{"type":"string"},"verify":{"type":"string"}},"required":["entity"]},"example":{"entity":"OpenAI","need_type":"pricing"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/agent-source/v1/verify_claim":{"post":{"operationId":"agent_source_verify_claim","summary":"Check whether one or more public source URLs support a factual claim — returns supported, contradicted, not_found, or unclear, along with the matching evidence snippet and a confidence level. Uses exact quote and number matching against the live page content. A source-evidence checker, not a general truth oracle.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"claim":{"type":"string"},"url":{"type":"string"},"urls":{"type":"string"}},"required":["claim","url"]},"example":{"claim":"Claude Opus 4.5 costs $5 per million input tokens","url":"https://docs.claude.com/en/docs/about-claude/pricing"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/agent-source/v1/pricing_lookup":{"post":{"operationId":"agent_source_pricing_lookup","summary":"Current developer/LLM pricing for a curated provider, parsed live from the provider's own pricing page/API. Each row: model, input/output per-1M-token USD, source_url, last_seen_at, unit, currency, normalization_notes.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"provider":{"type":"string"},"model":{"type":"string"},"limit":{"type":"string"}},"required":["provider"]},"example":{"provider":"openrouter","model":"claude"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/agent-source/v1/pricing_compare":{"post":{"operationId":"agent_source_pricing_compare","summary":"Compare current pricing across several curated providers (optionally filtered to a model substring) → normalized per-1M-token USD, cheapest-first, each traceable to its source_url + last_seen_at.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"providers":{"type":"string"},"model":{"type":"string"}},"required":["providers"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/agent-source/v1/providers":{"post":{"operationId":"agent_source_providers","summary":"List the curated provider whitelist + each provider's capabilities (which need_types and structured pricing are supported) and parse-surface metadata. The honest denominator for official_source / pricing.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"provider":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/agoda/v1/destinations":{"post":{"operationId":"agoda_destinations","summary":"Resolve a free-text place ('Bangkok', 'Tokyo', 'Maldives', an airport or a landmark) into Agoda's destination ids. Returns matched cities, areas, airports, points of interest and hotels with their object_id, type and (for cities) the city_id + hotel count. Use this first to get the city_id the city_browse action needs.","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"language":{"type":"string"}},"required":["query"]},"example":{"query":"Bangkok"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/agoda/v1/city_browse":{"post":{"operationId":"agoda_city_browse","summary":"Browse a city's popular hotels and accommodation themes. Returns ~100 popular hotels (name + Agoda detail URL), property-type theme links (apartments, hostels, resorts…) and the city's travel guides. Pass a numeric city_id from the destinations action.","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"city_id":{"type":"string"},"language":{"type":"string"}},"required":["city_id"]},"example":{"city_id":9395}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/agoda/v1/detail":{"post":{"operationId":"agoda_detail","summary":"Full hotel record by hotel_id (or hotel URL): name, accommodation type, star rating, full address + city/country, coordinates, description, facilities (grouped), policies, important notes, nearby places of interest and the property FAQ.","tags":["Travel & Lodging"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"hotel_id":{"type":"string"},"url":{"type":"string"},"language":{"type":"string"}}},"example":{"hotel_id":294217}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/agoda/v1/reviews":{"post":{"operationId":"agoda_reviews","summary":"Paginated guest reviews for one hotel (70 per page): star rating, title, separate positive/negative text, review date, reviewer country, traveler type, room type and length of stay, the owner's reply and helpful votes. The response also carries the hotel's overall score and total review count. Page with `page` until meta.has_more is false.","tags":["Travel & Lodging"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"hotel_id":{"type":"string"},"url":{"type":"string"},"page":{"type":"string"},"sort_by":{"type":"string"},"language":{"type":"string"}}},"example":{"hotel_id":294217}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/airbnb/v1/stays.search":{"post":{"operationId":"airbnb_stays.search","summary":"Search Airbnb stays by location and dates with full filters: price range, guests, place/property type, bedrooms/beds/baths, amenities, instant-book, Superhost, free cancellation and host language (≈26 cards/page, cursor-paginated).","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"checkin":{"type":"string"},"checkout":{"type":"string"},"adults":{"type":"string"},"children":{"type":"string"},"infants":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"room_type":{"type":"string"},"property_type":{"type":"string"},"min_bedrooms":{"type":"string"},"min_beds":{"type":"string"},"min_bathrooms":{"type":"string"},"amenities":{"type":"string"},"host_languages":{"type":"string"},"instant_book":{"type":"string"},"superhost":{"type":"string"},"free_cancellation":{"type":"string"},"pets_allowed":{"type":"string"},"cursor":{"type":"string"},"currency":{"type":"string"},"locale":{"type":"string"}},"required":["query"]},"example":{"query":"Istanbul, Turkey","checkin":"2026-09-21","checkout":"2026-09-26","adults":2}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/airbnb/v1/stays.detail":{"post":{"operationId":"airbnb_stays.detail","summary":"Full listing details: title, property/room type, guest capacity, the six category sub-ratings, host card, complete amenity list, photo URLs, sleeping arrangement, house rules, description and map location. Returns a clean `parsed` summary plus the raw PDP payload.","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"listing_id":{"type":"string"},"currency":{"type":"string"},"locale":{"type":"string"}},"required":["listing_id"]},"example":{"listing_id":"1408102095235129361"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/airbnb/v1/host.profile":{"post":{"operationId":"airbnb_host.profile","summary":"Host profile for a listing: host name, Superhost/verified status, overall host rating, total reviews, years hosting, response rate and host highlights.","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"listing_id":{"type":"string"}},"required":["listing_id"]},"example":{"listing_id":"1408102095235129361"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/airbnb/v1/stays.reviews":{"post":{"operationId":"airbnb_stays.reviews","summary":"Listing reviews, paginated via offset/limit.","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"listing_id":{"type":"string"},"offset":{"type":"string"},"limit":{"type":"string"},"locale":{"type":"string"}},"required":["listing_id"]},"example":{"listing_id":"1408102095235129361"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/airbnb/v1/stays.availability_calendar":{"post":{"operationId":"airbnb_stays.availability_calendar","summary":"Availability calendar for a listing (up to 12 months ahead): per-day availability + min/max nights.","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"listing_id":{"type":"string"}},"required":["listing_id"]},"example":{"listing_id":"1408102095235129361","month_count":3}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/airbnb/v1/properties.search":{"post":{"operationId":"airbnb_properties.search","summary":"Alias of stays.search.","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"checkin":{"type":"string"},"checkout":{"type":"string"},"adults":{"type":"string"},"cursor":{"type":"string"},"currency":{"type":"string"},"locale":{"type":"string"}},"required":["query"]},"example":{"query":"Istanbul, Turkey"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/airbnb/v1/properties.detail":{"post":{"operationId":"airbnb_properties.detail","summary":"Alias of stays.detail.","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"listing_id":{"type":"string"},"currency":{"type":"string"},"locale":{"type":"string"}},"required":["listing_id"]},"example":{"listing_id":"1408102095235129361"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/airbnb/v1/autocomplete":{"post":{"operationId":"airbnb_autocomplete","summary":"Location autocomplete suggestions (raw passthrough).","tags":["Travel & Lodging"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/alibaba/v1/search":{"post":{"operationId":"alibaba_search","summary":"Search alibaba.com wholesale listings by keyword — 48 supplier offers per page, each with its unit price (or price range), minimum order quantity, units sold, supplier company and country, review scores and certifications. Filter by price, MOQ, supplier country, category, review score and supplier credentials; sort by relevance, sales volume, response rate or price","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"page":{"type":"string"},"sort":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"min_order":{"type":"string"},"max_order":{"type":"string"},"supplier_country":{"type":"string"},"category_id":{"type":"string"},"verified_supplier":{"type":"string"},"trade_assurance":{"type":"string"},"min_review_score":{"type":"string"}},"required":["query"]},"example":{"query":"led strip"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/alibaba/v1/product_detail":{"post":{"operationId":"alibaba_product_detail","summary":"Full wholesale detail for one alibaba.com listing — the complete quantity price ladder, minimum order quantity, production lead time, gross weight and package dimensions, the full specification table, image gallery, variant matrix with native SKU ids and per-variant stock, certifications, and the supplier scorecard","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"},"url":{"type":"string"}}},"example":{"product_id":"1600104532932"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/alibaba/v1/rfq_search":{"post":{"operationId":"alibaba_rfq_search","summary":"Search live buying requests (RFQs) posted by Alibaba buyers — the demand side of the marketplace. Each row is a purchase a real buyer is asking for right now, in their own words: what they want, how many, which country they are buying from and how long ago they posted it. Filter by keyword, buyer country, category and how recently it was posted; sort newest-first to work the board as a live feed","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"page":{"type":"string"},"sort":{"type":"string"},"buyer_country":{"type":"string"},"category_id":{"type":"string"},"posted_within":{"type":"string"},"with_attachments":{"type":"string"},"open_only":{"type":"string"}}},"example":{"query":"packaging box"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/aliexpress/v1/search":{"post":{"operationId":"aliexpress_search","summary":"Product search cards (price, sold_count, rating, store); filters sort/min_price/max_price/ship_from/free_shipping, paginated","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"country":{"type":"string"},"currency":{"type":"string"},"page":{"type":"string"},"max_pages":{"type":"string"},"max_results":{"type":"string"},"sort":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"ship_from":{"type":"string"},"free_shipping":{"type":"string"}}},"example":{"query":"wireless earbuds","country":"US","currency":"USD"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/aliexpress/v1/product_detail":{"post":{"operationId":"aliexpress_product_detail","summary":"Full product + SKU-variant price/stock matrix + specs + images + video + store + shipping + rating + coupons + sale countdown + wishlist counts + item weight where the seller published one (empty when they did not — never guessed)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"},"url":{"type":"string"},"country":{"type":"string"},"currency":{"type":"string"},"language":{"type":"string"},"province":{"type":"string"},"city":{"type":"string"}}},"example":{"product_id":"3256808363596774"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/aliexpress/v1/reviews":{"post":{"operationId":"aliexpress_reviews","summary":"Buyer reviews (paginated — fetch many pages in one call) + rating distribution","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"},"url":{"type":"string"},"page":{"type":"string"},"max_pages":{"type":"string"},"max_results":{"type":"string"},"page_size":{"type":"string"},"filter":{"type":"string"},"review_sort":{"type":"string"},"country":{"type":"string"},"currency":{"type":"string"}}},"example":{"product_id":"3256808363596774","page_size":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/aliexpress/v1/similar":{"post":{"operationId":"aliexpress_similar","summary":"Products similar to a given item (search-backed 'more like this', seed product excluded), paginated","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"},"url":{"type":"string"},"query":{"type":"string"},"page":{"type":"string"},"max_pages":{"type":"string"},"max_results":{"type":"string"},"sort":{"type":"string"},"country":{"type":"string"},"currency":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/aliexpress/v1/description":{"post":{"operationId":"aliexpress_description","summary":"Full product description text + images","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"},"url":{"type":"string"},"description_url":{"type":"string"},"country":{"type":"string"},"currency":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/aliexpress/v1/shipping":{"post":{"operationId":"aliexpress_shipping","summary":"Shipping options per destination country","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"},"url":{"type":"string"},"country":{"type":"string"},"currency":{"type":"string"},"language":{"type":"string"},"province":{"type":"string"},"city":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/aliexpress/v1/store_info":{"post":{"operationId":"aliexpress_store_info","summary":"Store profile (+ live seller metrics when a query is supplied)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"store_id":{"type":"string"},"store_url":{"type":"string"},"query":{"type":"string"},"country":{"type":"string"},"currency":{"type":"string"}}},"example":{"store_id":"1103576287"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/aliexpress/v1/deals":{"post":{"operationId":"aliexpress_deals","summary":"SuperDeals / discounted cards (search-derived, sorted by discount)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"min_discount":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"},"max_pages":{"type":"string"},"max_results":{"type":"string"},"country":{"type":"string"},"currency":{"type":"string"}},"required":["query"]},"example":{"query":"wireless earbuds"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/allegro/v1/search":{"post":{"operationId":"allegro_search","summary":"Search Allegro by keyword — returns offer cards with title, price (PLN), delivery cost, seller, rating, photos and offer URL. Supports price range, condition, free-delivery, sort and category filters, with page pagination.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"max_pages":{"type":"string"},"sort":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"condition":{"type":"string"},"free_delivery":{"type":"string"},"category":{"type":"string"}},"required":["query"]},"example":{"query":"iphone 15"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/allegro/v1/category":{"post":{"operationId":"allegro_category","summary":"Browse an Allegro category without a keyword (the /kategoria/ grid) — discover popular offers in a category. Supports price/condition/free-delivery/sort filters and page pagination.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"max_pages":{"type":"string"},"sort":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"condition":{"type":"string"},"free_delivery":{"type":"string"}},"required":["category"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/allegro/v1/offer":{"post":{"operationId":"allegro_offer","summary":"Single Allegro offer/product detail by id or URL — title, price (PLN), main image and gallery, seller handle, and description.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"offer_id":{"type":"string"},"offer_url":{"type":"string"},"url":{"type":"string"}}},"example":{"offer_id":"18673156866"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/allegro/v1/seller_offers":{"post":{"operationId":"allegro_seller_offers","summary":"A seller's public active listings, paginated — every offer a seller (shop) has live. Provide the seller login (handle from a seller URL / a search result's seller.login).","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"seller":{"type":"string"},"max_pages":{"type":"string"},"sort":{"type":"string"}},"required":["seller"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/allegro/v1/suggested":{"post":{"operationId":"allegro_suggested","summary":"Related/recommended Allegro offers for a keyword — a quick set of relevant offers (the first result page) useful for 'more like this' / market discovery.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"example":{"query":"iphone 15"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/amazon/v1/product/detail":{"post":{"operationId":"amazon_product_detail","summary":"full product page (title/price/currency/rating/count/brand/features/images/categories/variations/tech-specs/A+content/compare-similar) + top-8 inline reviews, by ASIN","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asin":{"type":"string"},"marketplace":{"type":"string"}},"required":["asin"]},"example":{"asin":"B0DGHMNQ5Z"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/amazon/v1/product/reviews":{"post":{"operationId":"amazon_product_reviews","summary":"Amazon product reviews by ASIN — the public reviews from the product page (and optionally merged + deduped across several marketplaces for more depth). Each review has author, rating, title, date, body, verified badge and helpful votes.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asin":{"type":"string"},"marketplace":{"type":"string"},"marketplaces":{"type":"string"}},"required":["asin"]},"example":{"asin":"B0DGHMNQ5Z"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/amazon/v1/product/offers":{"post":{"operationId":"amazon_product_offers","summary":"pinned buybox + all-offers (AOD aodAjaxMain): price/seller/condition/ships_from/delivery/prime, by ASIN","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asin":{"type":"string"},"marketplace":{"type":"string"}},"required":["asin"]},"example":{"asin":"B0DGHMNQ5Z"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/amazon/v1/search":{"post":{"operationId":"amazon_search","summary":"product search with optional filters (price range, minimum rating, deals, brand) → results[]{asin,title,price,currency,rating,rating_count,image,sponsored}","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"marketplace":{"type":"string"},"page":{"type":"string"},"max_results":{"type":"string"},"sort":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"min_rating":{"type":"string"},"deals":{"type":"string"},"discount":{"type":"string"},"prime":{"type":"string"},"brand":{"type":"string"}},"required":["query"]},"example":{"query":"laptop"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/amazon/v1/products_batch":{"post":{"operationId":"amazon_products_batch","summary":"Look up MANY Amazon products in ONE call by ASIN — up to 15 per request → each product's title, current price and currency, star rating with review count, image, and any clippable coupon or deal badge. ONE upstream request serves the whole list (not one per ASIN), so this is the cheap way to refresh a price list or reconcile a catalogue against Amazon. IMPORTANT — this returns the SUMMARY card for each product, which is what Amazon publishes on a multi-product surface. For features, technical specifications, variations, barcodes, A+ content or reviews, use product/detail, which reads the full product page and costs one call per ASIN.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asins":{"type":"string"},"marketplace":{"type":"string"}},"required":["asins"]},"example":{"asins":["B0DGHMNQ5Z","B01GJOMWVA","B0CKM9F15Z"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/amazon/v1/bestsellers":{"post":{"operationId":"amazon_bestsellers","summary":"best-sellers ranking for a department (category slug required)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"marketplace":{"type":"string"},"max_results":{"type":"string"}},"required":["category"]},"example":{"category":"electronics","max_results":30}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/amazon/v1/new-releases":{"post":{"operationId":"amazon_new_releases","summary":"new-releases ranking for a department (category slug required)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"marketplace":{"type":"string"},"max_results":{"type":"string"}},"required":["category"]},"example":{"category":"electronics"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/amazon/v1/seller/profile":{"post":{"operationId":"amazon_seller_profile","summary":"seller profile (name, feedback %, lifetime ratings, rating)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"seller_id":{"type":"string"},"marketplace":{"type":"string"}},"required":["seller_id"]},"example":{"seller_id":"A3A9OGKM04K3X0"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/amazon/v1/autocomplete":{"post":{"operationId":"amazon_autocomplete","summary":"search autocomplete suggestions","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"marketplace":{"type":"string"}},"required":["query"]},"example":{"query":"laptop"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/amazon/v1/seller/products":{"post":{"operationId":"amazon_seller_products","summary":"a seller's catalog/storefront by seller_id (paginated)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"seller_id":{"type":"string"},"marketplace":{"type":"string"},"page":{"type":"string"}},"required":["seller_id"]},"example":{"seller_id":"A3A9OGKM04K3X0"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/amazon/v1/seller/reviews":{"post":{"operationId":"amazon_seller_reviews","summary":"seller FEEDBACK reviews (rating/text/rater/date) by seller_id","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"seller_id":{"type":"string"},"marketplace":{"type":"string"}},"required":["seller_id"]},"example":{"seller_id":"A3A9OGKM04K3X0"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/amazon/v1/deals":{"post":{"operationId":"amazon_deals","summary":"Amazon deal-products (today's deals / goldbox): asin/title/price/image","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"marketplace":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/amazon/v1/product/related":{"post":{"operationId":"amazon_product_related","summary":"Amazon related & recommended products by ASIN — the product-recommendation carousels from the Amazon product page grouped by relationship: 'Customers who viewed this item also viewed', 'Customers also bought', 'Products related to this item' and 'Frequently bought together'. Each recommended product comes with its ASIN, title, price, star rating and image — ideal for building 'you may also like' / cross-sell feeds.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asin":{"type":"string"},"marketplace":{"type":"string"}},"required":["asin"]},"example":{"asin":"0735211299"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/amazon/v1/gtin-to-asin":{"post":{"operationId":"amazon_gtin_to_asin","summary":"Amazon barcode lookup — convert a product barcode (UPC, EAN, ISBN or GTIN) into the matching Amazon ASIN(s). Pass the 8-14 digit code from a physical product and get back the Amazon listing(s) it maps to (ASIN, title, price, rating, image) — for catalog matching, price checks and reconciling SKUs to Amazon products.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"gtin":{"type":"string"},"marketplace":{"type":"string"}}},"example":{"gtin":"9780735211292"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/app-store/v1/reviews":{"post":{"operationId":"app_store_reviews","summary":"unified Apple + Play reviews for one or more apps","tags":["Reputation & Reviews"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"apps":{"type":"string"},"appleAppId":{"type":"string"},"googlePlayPackage":{"type":"string"},"appName":{"type":"string"},"stores":{"type":"string"},"countries":{"type":"string"},"maxReviews":{"type":"string"}}},"example":{"apps":[{"name":"WhatsApp","apple":"310633997"}],"stores":["apple"],"countries":["us"],"maxReviews":100}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/app-store/v1/search":{"post":{"operationId":"app_store_search","summary":"ranked app search results","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"stores":{"type":"string"},"country":{"type":"string"},"count":{"type":"string"}},"required":["query"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/app-store/v1/topCharts":{"post":{"operationId":"app_store_topCharts","summary":"ranked chart/category apps","tags":["Reputation & Reviews"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"stores":{"type":"string"},"country":{"type":"string"},"category":{"type":"string"},"count":{"type":"string"},"chart":{"type":"string"},"device":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/app-store/v1/listCategories":{"post":{"operationId":"app_store_listCategories","summary":"static genre/category list","tags":["Reputation & Reviews"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"stores":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/app-store/v1/appDetails":{"post":{"operationId":"app_store_appDetails","summary":"full app profile","tags":["Reputation & Reviews"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"type":"string"},"appleAppId":{"type":"string"},"googlePlayPackage":{"type":"string"},"stores":{"type":"string"},"country":{"type":"string"},"includeSimilarApps":{"type":"string"}}},"example":{"stores":["apple"],"country":"us","appId":"324684580"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/app-store/v1/developerApps":{"post":{"operationId":"app_store_developerApps","summary":"every other app published by the same developer","tags":["Reputation & Reviews"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"type":"string"},"appleAppId":{"type":"string"},"googlePlayPackage":{"type":"string"},"stores":{"type":"string"},"country":{"type":"string"},"count":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/app-store/v1/similarApps":{"post":{"operationId":"app_store_similarApps","summary":"related / similar apps for an app","tags":["Reputation & Reviews"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"type":"string"},"appleAppId":{"type":"string"},"googlePlayPackage":{"type":"string"},"stores":{"type":"string"},"country":{"type":"string"},"count":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/asos/v1/search":{"post":{"operationId":"asos_search","summary":"Keyword product search across the ASOS catalogue with filters (price, brand, colour, size, product type, sale, new-in, discount), sorting and offset/limit pagination.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"store":{"type":"string"},"lang":{"type":"string"},"currency":{"type":"string"},"country":{"type":"string"},"offset":{"type":"string"},"limit":{"type":"string"},"sort":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"brand":{"type":"string"},"colour":{"type":"string"},"color":{"type":"string"},"size":{"type":"string"},"product_type":{"type":"string"},"on_sale":{"type":"string"},"new_in_within":{"type":"string"},"discount":{"type":"string"},"channel":{"type":"string"},"key_store_dataversion":{"type":"string"}},"required":["query"]},"example":{"query":"dress"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/asos/v1/category":{"post":{"operationId":"asos_category","summary":"Browse all products in a category by category_id, with the same filters, sorting and pagination as search. Get category ids from the 'navigation' action.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category_id":{"type":"string"},"store":{"type":"string"},"lang":{"type":"string"},"currency":{"type":"string"},"country":{"type":"string"},"offset":{"type":"string"},"limit":{"type":"string"},"sort":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"brand":{"type":"string"},"colour":{"type":"string"},"color":{"type":"string"},"size":{"type":"string"},"product_type":{"type":"string"},"on_sale":{"type":"string"},"new_in_within":{"type":"string"},"discount":{"type":"string"},"channel":{"type":"string"}},"required":["category_id"]},"example":{"category_id":"8799"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/asos/v1/sale":{"post":{"operationId":"asos_sale","summary":"On-sale / marked-down products only. Provide a keyword (query) or a category_id; supports the same filters, sort and pagination as search.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"category_id":{"type":"string"},"store":{"type":"string"},"lang":{"type":"string"},"currency":{"type":"string"},"country":{"type":"string"},"offset":{"type":"string"},"limit":{"type":"string"},"sort":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"brand":{"type":"string"},"colour":{"type":"string"},"color":{"type":"string"},"size":{"type":"string"},"product_type":{"type":"string"},"discount":{"type":"string"}}},"example":{"query":"dress"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/asos/v1/new_in":{"post":{"operationId":"asos_new_in","summary":"Newest arrivals — freshness-sorted products, optionally limited to a recent window (today / last 7 / 14 / 28 days). Provide a keyword (query) or a category_id.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"category_id":{"type":"string"},"store":{"type":"string"},"lang":{"type":"string"},"currency":{"type":"string"},"country":{"type":"string"},"offset":{"type":"string"},"limit":{"type":"string"},"new_in_within":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"brand":{"type":"string"},"colour":{"type":"string"},"color":{"type":"string"},"size":{"type":"string"},"product_type":{"type":"string"}}},"example":{"query":"trainers"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/asos/v1/product":{"post":{"operationId":"asos_product","summary":"full product detail (sizes/stock/description/images) by product_id or product_url","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"},"product_url":{"type":"string"},"store":{"type":"string"}}},"example":{"product_id":"210879654"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/asos/v1/products":{"post":{"operationId":"asos_products","summary":"batch product detail for comma-separated product_ids","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_ids":{"type":"string"},"store":{"type":"string"}},"required":["product_ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/asos/v1/navigation":{"post":{"operationId":"asos_navigation","summary":"category links from gender landing pages; format=tree returns nested path hierarchy","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"gender":{"type":"string"},"store":{"type":"string"},"format":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/asos/v1/reviews":{"post":{"operationId":"asos_reviews","summary":"product reviews + rating summary from PDP embedded ratings blob (paginated)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"},"product_url":{"type":"string"},"offset":{"type":"string"},"limit":{"type":"string"}}},"example":{"product_id":"210879654"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/asos/v1/similar":{"post":{"operationId":"asos_similar","summary":"related products via same-brand search fallback (true mightLike API is account-gated)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"},"product_url":{"type":"string"},"limit":{"type":"string"},"store":{"type":"string"}}},"example":{"product_id":"210879654","limit":6}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/asos/v1/filters":{"post":{"operationId":"asos_filters","summary":"available search/category facets (brands, colours, sizes, price ranges)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"category_id":{"type":"string"},"store":{"type":"string"},"lang":{"type":"string"},"currency":{"type":"string"},"country":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/asos/v1/suggestions":{"post":{"operationId":"asos_suggestions","summary":"search autocomplete suggestions for partial query","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"store":{"type":"string"},"lang":{"type":"string"},"currency":{"type":"string"},"country":{"type":"string"}},"required":["query"]},"example":{"query":"dre"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/ats-jobs/v1/company_jobs":{"post":{"operationId":"ats_jobs_company_jobs","summary":"all open jobs for a board → {jobs[]{id,title,url,company,location,locations,...}, count, total, company, ats_source}. `ats`=greenhouse|lever|ashby|workable + `company` (board token/subdomain).","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ats":{"type":"string"},"company":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"},"page":{"type":"string"}},"required":["ats","company"]},"example":{"ats":"greenhouse","company":"gitlab"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/ats-jobs/v1/job_detail":{"post":{"operationId":"ats_jobs_job_detail","summary":"one fully-populated job (description + requirements/benefits) by `ats` + `company` + `job_id`.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ats":{"type":"string"},"company":{"type":"string"},"job_id":{"type":"string"}},"required":["ats","company","job_id"]},"example":{"ats":"greenhouse","company":"gitlab","job_id":"8503792002"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/ats-jobs/v1/search":{"post":{"operationId":"ats_jobs_search","summary":"cross-company job search over the Workable aggregator (170K jobs) → jobs[]. `query` + (default `ats`=workable). paginated.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"ats":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"},"page":{"type":"string"}},"required":["query"]},"example":{"query":"python engineer","ats":"workable"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/ats-jobs/v1/providers":{"post":{"operationId":"ats_jobs_providers","summary":"the supported ATS providers + their capabilities","tags":["Jobs & Hiring"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/autodoc/v1/vehicle_lookup":{"post":{"operationId":"autodoc_vehicle_lookup","summary":"Walk Autodoc's vehicle tree — this is where every other action starts, because car parts are only meaningful against a specific car. Call it with no parameters for the 52 makers; add `maker` for that maker's model families; add `model` for the generations (the chassis codes: E82, F20, W204); add `generation` for the actual engine variants, each with Autodoc's numeric vehicle id. Add `vehicle` (or pass a `vehicle_url`) and you get the car itself — its full factory description (engine, kW/hp, fuel, build years, engine code) plus every part category Autodoc stocks for it, ready to feed straight into `search`. Set `market` to `de` to walk the German storefront's tree instead; the slugs are the same on both, so a vehicle resolved on one market can be used on the other.","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"market":{"type":"string"},"maker":{"type":"string"},"model":{"type":"string"},"generation":{"type":"string"},"vehicle":{"type":"string"},"vehicle_url":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/autodoc/v1/search":{"post":{"operationId":"autodoc_search","summary":"The parts that FIT one exact car, in one part category — the question this API exists to answer. Give a `category` (from the `categories` action, or better from the `categories[]` that a `vehicle_lookup` on your vehicle returns) plus the full vehicle: `maker` + `model` + `generation` + `vehicle`, or a single `vehicle_url`. You get Autodoc's own fitment listing — every brand that makes that part for that car, with price, RRP, rating, review count, the manufacturer's part number, the key specifications and the image — 20 per page. THE VEHICLE IS NOT OPTIONAL, and that is Autodoc's data model rather than a limit of this API: a parts list only exists for one exact engine variant. Autodoc's category page, maker page, model page and generation page are all real pages that carry NO product listing whatsoever (measured: 0 parts at every level above the engine variant, 20 at it). Omitting the vehicle returns MISSING_PARAM rather than an empty result set that would cost you a call and tell you nothing. `market` decides which storefront is priced: `uk` (GBP) or `de` (EUR). The same vehicle and the same category work on both — what changes is the price, the currency and the language of the copy.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"maker":{"type":"string"},"model":{"type":"string"},"generation":{"type":"string"},"vehicle":{"type":"string"},"market":{"type":"string"},"vehicle_url":{"type":"string"},"page":{"type":"string"},"max_results":{"type":"string"}},"required":["category"]},"example":{"category":"brake-pad-set-10130","maker":"bmw","model":"1er-reihe","generation":"1-coupe-e82","vehicle":"12272-118-d","max_results":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/autodoc/v1/product_detail":{"post":{"operationId":"autodoc_product_detail","summary":"One part in full, by Autodoc's numeric article id (or its URL). Returns the complete image gallery and the 360-degree photo set, the manufacturer's own specification table verbatim (fitting position, dimensions, material, WVA number, weight, EAN), the manufacturer part number, brand, price with currency, availability, shipping cost and return window, the aggregate rating and the customer reviews inline — and, the two fields that matter most in this industry, the full OE cross-reference (every vehicle-manufacturer part number this part replaces) and the equivalent parts Autodoc sells alongside it. `market` picks the storefront — the same `article_id` is the same part on both, priced in GBP on `uk` and EUR on `de`, and `currency` always reports what the page itself said.","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"article_id":{"type":"string"},"url":{"type":"string"},"market":{"type":"string"},"max_reviews":{"type":"string"}}},"example":{"article_id":"7999106"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/autodoc/v1/part_search":{"post":{"operationId":"autodoc_part_search","summary":"Autodoc's own catalogue-wide search, across roughly 6.7 million parts. Built for the lookup this trade actually does: paste a manufacturer part number (`1987474465`, `402B0071`) and get that part plus its alternatives, or type plain English (`brake pads`, `wiper blades`) for a normal keyword result set. Results are not scoped to a car — use `search` when you need fitment, and `oem_lookup` when the number you hold came off the vehicle manufacturer's own part. Set `market` to `de` to search the German storefront (EUR).","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"market":{"type":"string"},"page":{"type":"string"},"max_results":{"type":"string"}},"required":["query"]},"example":{"query":"1987474465"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/autodoc/v1/oem_lookup":{"post":{"operationId":"autodoc_oem_lookup","summary":"Cross-reference a vehicle manufacturer's ORIGINAL part number to everything Autodoc sells as a replacement for it. Give BMW's 34216774692 and get the Brembo, TRW, Bosch, ATE and budget-brand equivalents, each with price, rating and the manufacturer's own part number. This is the endpoint a workshop or a parts reseller uses, and it is the reverse of the `oem_numbers` list `product_detail` returns for a part. Set `market` to `de` for the German storefront's prices (EUR); the OE number and the parts it resolves to are the same on both.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"oem_number":{"type":"string"},"market":{"type":"string"},"page":{"type":"string"},"max_results":{"type":"string"}},"required":["oem_number"]},"example":{"oem_number":"34216774692"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/autodoc/v1/categories":{"post":{"operationId":"autodoc_categories","summary":"Autodoc's part-category vocabulary — all 199 leaf categories with the slug and numeric id the `search` action needs, so a caller never has to guess one. Optionally filter with `group` (`brake`, `filter`, `suspension`). `market` picks the storefront, which is what decides the LANGUAGE of the slugs and names — the numeric ids are the same category on both, and a uk slug passed to a de `search` resolves correctly because the number is what Autodoc keys on. Cached hard: this list barely moves.","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"market":{"type":"string"},"group":{"type":"string"}}},"example":{"group":"brake"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/autoscout24/v1/search":{"post":{"operationId":"autoscout24_search","summary":"Paginated car search by make (+ model/filters) across EU TLDs; deal signals priceEvaluation+superDeal","tags":["Classifieds & Second-hand"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"make":{"type":"string"},"model":{"type":"string"},"model_group":{"type":"string"},"country":{"type":"string"},"page":{"type":"string"},"sort":{"type":"string"},"desc":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"year_min":{"type":"string"},"year_max":{"type":"string"},"mileage_min":{"type":"string"},"mileage_max":{"type":"string"},"fuel":{"type":"string"},"transmission":{"type":"string"},"body_type":{"type":"string"},"zip":{"type":"string"},"radius":{"type":"string"},"power_min":{"type":"string"},"power_max":{"type":"string"},"super_deal":{"type":"string"},"seller_type":{"type":"string"},"offer_type":{"type":"string"}}},"example":{"make":"bmw","country":"de"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/autoscout24/v1/listing":{"post":{"operationId":"autoscout24_listing","summary":"Full listing detail by url/path or id (description, prices, vehicle, images, seller, leasing, warranty)","tags":["Classifieds & Second-hand"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"path":{"type":"string"},"id":{"type":"string"},"country":{"type":"string"}}},"example":{"url":"/angebote/bmw-318-318i-touring-attiva-benzin-cat_ma13mo1640-fb7acb22-cce5-4ab1-8340-7dbe9160bca9","country":"de"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/autoscout24/v1/makes":{"post":{"operationId":"autoscout24_makes","summary":"Vehicle makes taxonomy from search hub page","tags":["Classifieds & Second-hand"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/autoscout24/v1/models":{"post":{"operationId":"autoscout24_models","summary":"Models taxonomy for a make (query-param filters — path-segment /lst/make/model returns 404)","tags":["Classifieds & Second-hand"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"make":{"type":"string"},"country":{"type":"string"}},"required":["make"]},"example":{"make":"bmw"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/autoscout24/v1/filter_options":{"post":{"operationId":"autoscout24_filter_options","summary":"Available filter dimensions (fuel, body, transmission, etc.) from taxonomy blob","tags":["Classifieds & Second-hand"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"make":{"type":"string"},"country":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/autoscout24/v1/seller_listings":{"post":{"operationId":"autoscout24_seller_listings","summary":"Listings for a dealer/private seller by customer id (cid)","tags":["Classifieds & Second-hand"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cid":{"type":"string"},"country":{"type":"string"},"page":{"type":"string"},"seller_id":{"type":"string"}},"required":["cid"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/autoscout24/v1/browse_links":{"post":{"operationId":"autoscout24_browse_links","summary":"SEO browse graph: cities, body types, model lines, top models (interlinking from search page)","tags":["Classifieds & Second-hand"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"make":{"type":"string"},"country":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/autotrader/v1/search":{"post":{"operationId":"autotrader_search","summary":"UK car listings (make/model + filters, paginated); postcode defaults to a UK centroid if omitted","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"make":{"type":"string"},"model":{"type":"string"},"postcode":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"min_year":{"type":"string"},"max_year":{"type":"string"},"min_mileage":{"type":"string"},"max_mileage":{"type":"string"},"fuel":{"type":"string"},"body_type":{"type":"string"},"transmission":{"type":"string"},"radius":{"type":"string"},"page":{"type":"string"},"market":{"type":"string"}}},"example":{"make":"BMW","model":"3 Series","postcode":"SW1A 1AA","market":"uk"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/autotrader/v1/listing_detail":{"post":{"operationId":"autotrader_listing_detail","summary":"Full advert (price+priceIndicator+deviation, mileage, full spec [fuel/trans/body/doors/seats/engine], description, images[], dealer+reviews+address)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"postcode":{"type":"string"},"market":{"type":"string"}},"required":["id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/barcode/v1/lookup":{"post":{"operationId":"barcode_lookup","summary":"Barcode → one merged product: title/brand/category/image/description + dimensions/model + PACKAGE WEIGHT as an explicit {weight, weight_unit} pair (plus weight_grams, weight_type, weight_source and a weight_confidence flag) + retailer offers&prices (UPCitemdb) + net content + nutrition/ingredients/allergens if food (OFF). Includes check-digit validation, GTIN-13 normalization and issuing-country. source=auto merges them, and falls back to go-upc — US general merchandise, retailer private label, apparel and footwear — for barcodes the first two do not carry. Weight is published by roughly 1 barcode in 5 (1 in 3 with deep_weight=true) — when no source states one, weight is null, never 0 and never borrowed from a similar product.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"barcode":{"type":"string"},"source":{"type":"string"},"off_db":{"type":"string"},"deep_weight":{"type":"string"}},"required":["barcode"]},"example":{"barcode":"5449000000996"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/barcode/v1/batch":{"post":{"operationId":"barcode_batch","summary":"Up to 20 barcodes in one call → array of merged products (input order preserved), each with its own source/validation. The competitor caps at 10.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"barcodes":{"type":"string"},"source":{"type":"string"},"off_db":{"type":"string"},"deep_weight":{"type":"string"}},"required":["barcodes"]},"example":{"barcodes":"5449000000996,0885909950805"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/barcode/v1/search":{"post":{"operationId":"barcode_search","summary":"Free-text product-name search across the open databases → product cards with pagination. Optional category scope. (Competitor: keyword/title/category search.)","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"category":{"type":"string"},"off_db":{"type":"string"},"source":{"type":"string"},"page":{"type":"string"},"page_size":{"type":"string"}},"required":["query"]},"example":{"query":"nutella"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/barcode/v1/by_brand":{"post":{"operationId":"barcode_by_brand","summary":"All products for a brand/manufacturer → product cards with pagination. (Competitor: brand + manufacturer search.)","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brand":{"type":"string"},"category":{"type":"string"},"off_db":{"type":"string"},"page":{"type":"string"},"page_size":{"type":"string"}},"required":["brand"]},"example":{"brand":"coca-cola"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/barcode/v1/by_prefix":{"post":{"operationId":"barcode_by_prefix","summary":"GS1 company-prefix (partial-barcode) search → products whose barcode starts with the given 6+ digits, plus the decoded issuing country. (Competitor: `491234*` partial method.)","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prefix":{"type":"string"},"off_db":{"type":"string"},"page":{"type":"string"},"page_size":{"type":"string"}},"required":["prefix"]},"example":{"prefix":"5449000"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/barcode/v1/by_mpn":{"post":{"operationId":"barcode_by_mpn","summary":"Manufacturer-Part-Number / model lookup → products with that MPN/model (UPCitemdb keyword index over the MPN). Exact model/mpn matches are surfaced first. Closes the competitor's mpn query-method (the proprietary mpn= DB-index isn't on the open tier, but the keyword index resolves real MPNs — Logitech 910-005565, Sony WH-1000XM4, Canon 2727C002 all verified).","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mpn":{"type":"string"},"page":{"type":"string"},"page_size":{"type":"string"}},"required":["mpn"]},"example":{"mpn":"910-005565"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/barcode/v1/validate":{"post":{"operationId":"barcode_validate","summary":"Validate + decode a barcode WITHOUT a network call: mod-10 check digit, GTIN type, GTIN-13 normalization, GS1 issuing country, ISBN/Bookland detection. (We EXCEED the competitor here — it has no standalone validate.)","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"barcode":{"type":"string"}},"required":["barcode"]},"example":{"barcode":"40123455"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bestbuy/v1/search":{"post":{"operationId":"bestbuy_search","summary":"Search Best Buy by keyword → a paginated, sortable, filterable list of products with name, brand, model, current & regular price, savings, star rating + review count, stock status, image gallery, variants, category, seller type (Best Buy itself vs a marketplace seller), and the product link. Narrow with friendly filters: brand, min_price/max_price, min_rating, condition. NOTE: the full category breadcrumb (category_path) is not published on Best Buy's result grid - grid rows carry the product_type labels instead. For the breadcrumb, use product_detail for one product or products_batch for up to 15 at a time.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"max_results":{"type":"string"},"page":{"type":"string"},"sort":{"type":"string"},"brand":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"min_rating":{"type":"string"},"condition":{"type":"string"},"category":{"type":"string"},"include_sponsored":{"type":"string"}},"required":["query"]},"example":{"query":"laptop"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bestbuy/v1/product_detail":{"post":{"operationId":"bestbuy_product_detail","summary":"Get the full product card for one Best Buy item by its product number, URL, or product-id → name, brand, model, current/regular price + savings, clearance/sale flags & special offers, stock status, star rating with a 5★-to-1★ breakdown, what customers like/dislike, image gallery, color/storage/carrier variants, and the category breadcrumb.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"sku":{"type":"string"},"url":{"type":"string"}}},"example":{"sku":"6571043"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bestbuy/v1/products_batch":{"post":{"operationId":"bestbuy_products_batch","summary":"Look up MANY Best Buy products in ONE call by product number — up to 15 per request → each product's barcode (UPC), name, brand, price, rating, images, full technical specifications, shipping weight and package dimensions. Built for enriching a whole catalogue or price list at once instead of one product at a time.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"skus":{"type":"string"}},"required":["skus"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bestbuy/v1/reviews":{"post":{"operationId":"bestbuy_reviews","summary":"Get customer reviews for a Best Buy product → each review's star rating, title, full text, author, date, pros & cons, verified-purchase / incentivized flags, how long they've owned it, helpful-vote counts, and any customer photos. Paginated.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"sku":{"type":"string"},"url":{"type":"string"},"page":{"type":"string"},"page_size":{"type":"string"},"sort":{"type":"string"}}},"example":{"sku":"6565837"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bestbuy/v1/review_summary":{"post":{"operationId":"bestbuy_review_summary","summary":"Get the review snapshot for a Best Buy product → average rating, total review count, verified-purchase count, the full 5★-to-1★ rating breakdown, and a 'what customers say' summary of the most-mentioned pros and cons — in a single call.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"sku":{"type":"string"},"url":{"type":"string"}}},"example":{"sku":"6565837"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bestbuy/v1/search_suggestions":{"post":{"operationId":"bestbuy_search_suggestions","summary":"Get Best Buy search autocomplete suggestions for a partial query → the suggested search terms (with spell-correction), just like the dropdown under the search box.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"}},"required":["query"]},"example":{"query":"laptop"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bestbuy/v1/popular_terms":{"post":{"operationId":"bestbuy_popular_terms","summary":"Get Best Buy's currently trending / most-popular search terms (no input needed).","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bestbuy/v1/price":{"post":{"operationId":"bestbuy_price","summary":"Get the live pricing for a Best Buy product by SKU → current price, regular price, savings, clearance/sale flags and special offers (from Best Buy's pricing API).","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sku":{"type":"string"}},"required":["sku"]},"example":{"sku":"6571043"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bestbuy/v1/gifts":{"post":{"operationId":"bestbuy_gifts","summary":"Get the Gift-With-Purchase offers for a Best Buy product by SKU → each promotional offer (e.g. 'Apple TV Up to 1 Month GWP') and the free gift SKUs that come with it.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sku":{"type":"string"}},"required":["sku"]},"example":{"sku":"6571043"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bestbuy/v1/description":{"post":{"operationId":"bestbuy_description","summary":"Get a Best Buy product's full description and complete technical specifications by SKU → the marketing description plus every spec (name/value pairs: connectivity, dimensions, features, etc.). The deep product detail that lives on the product page.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"sku":{"type":"string"},"url":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bestbuy/v1/deals":{"post":{"operationId":"bestbuy_deals","summary":"Browse Best Buy's current deals — on-sale and clearance products site-wide, sorted by biggest discount by default → each product's name, brand, current & regular price, the amount and percent saved, star rating, stock status, image and link. Great for a 'today's best deals' / price-drop feed. (To find deals within a category, use search with sort=best_discount.)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"sort":{"type":"string"},"max_results":{"type":"string"},"page":{"type":"string"},"include_sponsored":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bestbuy/v1/trending":{"post":{"operationId":"bestbuy_trending","summary":"Get Best Buy's trending-right-now search terms — what shoppers are searching for at the moment (distinct from popular_terms, which is all-time most-popular). No input needed.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bestbuy/v1/qa":{"post":{"operationId":"bestbuy_qa","summary":"Get the customer questions & answers for a Best Buy product → each question with its author, date, and every answer (text, author, date, helpful-vote count, and which answer was voted best). Great for pre-purchase research. Paginated.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"sku":{"type":"string"},"url":{"type":"string"},"page":{"type":"string"},"page_size":{"type":"string"},"sort":{"type":"string"}}},"example":{"sku":"6565837"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bestbuy/v1/store_availability":{"post":{"operationId":"bestbuy_store_availability","summary":"Check whether a Best Buy product (by SKU) is available to buy for a given ZIP code (and optionally a specific store) → an available flag plus the live buy-button status (e.g. Add to Cart / Sold Out / Pre-Order). Useful for retail-arbitrage and local-stock checks.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sku":{"type":"string"},"zip":{"type":"string"},"store_id":{"type":"string"}},"required":["sku"]},"example":{"sku":"6505727","zip":"10001"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bestbuy/v1/categories":{"post":{"operationId":"bestbuy_categories","summary":"Discover the categories and filter facets available for a Best Buy keyword search → the category sub-paths (each with a category id you can browse) plus every filterable facet (Brand, Price, Customer Rating, and category-specific attributes) with their values and product counts. Use it to learn what you can filter by before calling search.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"category":{"type":"string"}},"required":["query"]},"example":{"query":"laptop"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bing/v1/search":{"post":{"operationId":"bing_search","summary":"Bing web search results — ranked organic pages with title, URL, snippet, answer box and related searches. Filter by market/language (mkt or gl/hl), SafeSearch and recency (freshness), with offset pagination.","tags":["Search & SEO"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"engine":{"type":"string"},"depth":{"type":"string"},"mkt":{"type":"string"},"gl":{"type":"string"},"hl":{"type":"string"},"count":{"type":"string"},"page":{"type":"string"},"first":{"type":"string"},"safe":{"type":"string"},"freshness":{"type":"string"},"device":{"type":"string"}},"required":["q"]},"example":{"q":"best laptop 2026","engine":"bing","gl":"us"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bing/v1/news":{"post":{"operationId":"bing_news","summary":"Bing News results for a keyword — article title, source, URL and snippet, sorted by recency. Filter by market and a recency window (freshness).","tags":["Search & SEO"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"mkt":{"type":"string"},"gl":{"type":"string"},"hl":{"type":"string"},"count":{"type":"string"},"freshness":{"type":"string"}},"required":["q"]},"example":{"q":"tesla","gl":"us"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bing/v1/videos":{"post":{"operationId":"bing_videos","summary":"Bing video search results — watch-page URL, thumbnail, duration and hosting platform (YouTube/Dailymotion/…) for every result; publisher/channel, view count, publish date and description when Bing exposes them. ~30 videos per page; paginate for more.","tags":["Search & SEO"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"mkt":{"type":"string"},"gl":{"type":"string"},"hl":{"type":"string"},"page":{"type":"string"},"first":{"type":"string"},"safe":{"type":"string"}},"required":["q"]},"example":{"q":"how to make pizza","gl":"us"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bing/v1/autocomplete":{"post":{"operationId":"bing_autocomplete","summary":"Bing search autocomplete — query suggestions / typeahead from Bing's public suggest endpoint — fast and cheap. Useful for keyword research.","tags":["Search & SEO"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"mkt":{"type":"string"},"gl":{"type":"string"},"hl":{"type":"string"}},"required":["q"]},"example":{"q":"best lap","gl":"us"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/profile":{"post":{"operationId":"bluesky_profile","summary":"actor profile: did/handle/displayName/desc/followers/follows/posts counts/avatar/banner/labels (+ batch via 'actors' <=25). Requires actor OR actors (engine-enforced; required_params=() so the actors-only batch isn't rejected by the gateway literal-key validator).","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"type":"string"},"actors":{"type":"string"}}},"example":{"actor":"bsky.app"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/author_feed":{"post":{"operationId":"bluesky_author_feed","summary":"an actor's posts (full record+embed+counts), cursor-paginated; filter=posts_no_replies|posts_with_replies|posts_with_media|posts_and_author_threads","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"type":"string"},"limit":{"type":"string"},"filter":{"type":"string"},"cursor":{"type":"string"}},"required":["actor"]},"example":{"actor":"bsky.app","limit":30}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/search_actors":{"post":{"operationId":"bluesky_search_actors","summary":"search users by name/handle/bio (cursor); typeahead=true for fast suggest","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"},"typeahead":{"type":"string"}},"required":["q"]},"example":{"q":"news","limit":25}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/thread":{"post":{"operationId":"bluesky_thread","summary":"a post + its reply tree (recursive) + parent","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uri":{"type":"string"},"depth":{"type":"string"},"parent_height":{"type":"string"}},"required":["uri"]},"example":{"uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l","depth":3}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/post_detail":{"post":{"operationId":"bluesky_post_detail","summary":"hydrate one or more posts by at:// URI (<=25): record/embed/like+repost+reply+quote counts","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uris":{"type":"string"}},"required":["uris"]},"example":{"uris":["at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/likes":{"post":{"operationId":"bluesky_likes","summary":"actors who liked a post (cursor); cid auto-used if given","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uri":{"type":"string"},"cid":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["uri"]},"example":{"uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l","cid":"bafyreicnt42y6vo6pfpvyro234ac4o6ijug6adwwrh7awflgrqlt4zibxq","limit":25}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/reposts":{"post":{"operationId":"bluesky_reposts","summary":"actors who reposted a post (cursor)","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uri":{"type":"string"},"cid":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["uri"]},"example":{"uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l","cid":"bafyreicnt42y6vo6pfpvyro234ac4o6ijug6adwwrh7awflgrqlt4zibxq","limit":25}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/followers":{"post":{"operationId":"bluesky_followers","summary":"actors following the subject (cursor)","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["actor"]},"example":{"actor":"bsky.app","limit":50}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/follows":{"post":{"operationId":"bluesky_follows","summary":"actors the subject follows (cursor)","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["actor"]},"example":{"actor":"bsky.app","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/quotes":{"post":{"operationId":"bluesky_quotes","summary":"Accounts/posts that QUOTE a given post (quote-posts), cursor-paginated. The other half of a post's engagement alongside likes and reposts.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uri":{"type":"string"},"cid":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["uri"]},"example":{"uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l","cid":"bafyreicnt42y6vo6pfpvyro234ac4o6ijug6adwwrh7awflgrqlt4zibxq","limit":25}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/suggested_follows":{"post":{"operationId":"bluesky_suggested_follows","summary":"Accounts suggested from a given account — Bluesky's 'who to follow next' / similar-accounts set. Not paginated (a fixed suggestion set, ~10-50 actors).","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"type":"string"},"limit":{"type":"string"}},"required":["actor"]},"example":{"actor":"bsky.app"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/lists":{"post":{"operationId":"bluesky_lists","summary":"The curated/moderation lists an account CREATED (user-curated lists + mute/block mod-lists), cursor-paginated.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["actor"]},"example":{"actor":"nytimes.com","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/list":{"post":{"operationId":"bluesky_list","summary":"A single list's metadata plus its MEMBERS (the accounts on the list), members cursor-paginated.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"list":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["list"]},"example":{"list":"at://did:plc:eclio37ymobqex2ncko63h4r/app.bsky.graph.list/3lbl2hyzmfy2u","limit":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/list_feed":{"post":{"operationId":"bluesky_list_feed","summary":"The feed of posts authored by the members of a list (a list used as a custom timeline), cursor-paginated.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"list":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["list"]},"example":{"list":"at://did:plc:eclio37ymobqex2ncko63h4r/app.bsky.graph.list/3lbl2hyzmfy2u","limit":15}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/actor_feeds":{"post":{"operationId":"bluesky_actor_feeds","summary":"The custom feed generators an account CREATED (its published feeds), cursor-paginated.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["actor"]},"example":{"actor":"bsky.app","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/feed_generator":{"post":{"operationId":"bluesky_feed_generator","summary":"One custom feed generator's metadata plus its live online/valid status (is the feed service up).","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"feed":{"type":"string"}},"required":["feed"]},"example":{"feed":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.generator/whats-hot"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/popular_feeds":{"post":{"operationId":"bluesky_popular_feeds","summary":"Discover popular custom feed generators — pass `q` to search feeds by name/topic, or omit for the platform-wide popular list. Cursor-paginated.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}}},"example":{"q":"news","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/get_feed":{"post":{"operationId":"bluesky_get_feed","summary":"The posts served BY a custom feed generator (e.g. a Discover/What's-Hot/topic feed) by its at:// URI, cursor-paginated. Public — no account required.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"feed":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["feed"]},"example":{"feed":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.generator/whats-hot","limit":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/starter_packs":{"post":{"operationId":"bluesky_starter_packs","summary":"The starter packs an account CREATED (shareable onboarding bundles of accounts + feeds), cursor-paginated.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["actor"]},"example":{"actor":"bsky.app","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/starter_pack":{"post":{"operationId":"bluesky_starter_pack","summary":"One starter pack's full detail: its underlying list, sample member profiles and any bundled feeds.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"starter_pack":{"type":"string"}},"required":["starter_pack"]},"example":{"starter_pack":"at://did:plc:ragtjsm2j2vknwkz3zp4oxrd/app.bsky.graph.starterpack/3m4j33zq7sz2m"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/search_posts":{"post":{"operationId":"bluesky_search_posts","summary":"Search Bluesky posts by keyword or hashtag — filter by sort order, date range, author, language, domain or tag. Requires an app-password; returns a clear error if none is configured.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"sort":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"},"since":{"type":"string"},"until":{"type":"string"},"author":{"type":"string"},"mentions":{"type":"string"},"lang":{"type":"string"},"domain":{"type":"string"},"url":{"type":"string"},"tag":{"type":"string"}},"required":["q"]},"example":{"q":"bluesky","sort":"top","limit":25}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/get_actor_likes":{"post":{"operationId":"bluesky_get_actor_likes","summary":"posts an actor liked (authed; the AppView serves the authenticated account's own likes). Defaults to the logged-in handle.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}}},"example":{"limit":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/bluesky/v1/timeline":{"post":{"operationId":"bluesky_timeline","summary":"the authenticated account's home timeline (authed)","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"string"},"cursor":{"type":"string"},"algorithm":{"type":"string"}}},"example":{"limit":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/booking/v1/hotels/search":{"post":{"operationId":"booking_hotels_search","summary":"Search hotels in a destination for given dates (25 hotels per page, with prices, review scores, photos, room configurations). Supports sorting, price/star/rating/amenity filters and paging. Pass ?include_facets=1 to list every available filter and sorter for the destination.","tags":["Travel & Lodging"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"dest_id":{"type":"string"},"dest_type":{"type":"string"},"checkin":{"type":"string"},"checkout":{"type":"string"},"adults":{"type":"string"},"rooms":{"type":"string"},"children_ages":{"type":"string"},"currency":{"type":"string"},"page":{"type":"string"},"sort_by":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"min_rating":{"type":"string"},"stars":{"type":"string"},"free_cancellation":{"type":"string"},"breakfast_included":{"type":"string"},"amenities":{"type":"string"},"include_facets":{"type":"string"},"include_raw":{"type":"string"}}},"example":{"dest_id":"-755070","dest_type":"city","checkin":"2026-09-21","checkout":"2026-09-23"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/booking/v1/hotels/detail":{"post":{"operationId":"booking_hotels_detail","summary":"Full hotel record: summary, rating breakdown, facilities, room types, surroundings, FAQ.","tags":["Travel & Lodging"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"page_name":{"type":"string"},"country_code":{"type":"string"},"hotel_url":{"type":"string"},"checkin":{"type":"string"},"checkout":{"type":"string"},"adults":{"type":"string"},"rooms":{"type":"string"},"currency":{"type":"string"}}},"example":{"page_name":"celine-taxim","country_code":"tr"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/booking/v1/hotels/availability":{"post":{"operationId":"booking_hotels_availability","summary":"Visible room blocks (room, occupancy, price, cancellation policy, meal plan) for a destination's top hotel on given dates.","tags":["Travel & Lodging"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"dest_id":{"type":"string"},"dest_type":{"type":"string"},"checkin":{"type":"string"},"checkout":{"type":"string"},"hotel_id":{"type":"string"},"adults":{"type":"string"},"rooms":{"type":"string"},"children_ages":{"type":"string"},"currency":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/booking/v1/hotels/reviews":{"post":{"operationId":"booking_hotels_reviews","summary":"Paginated, deduped guest reviews for one hotel (score, title, pros/cons text, owner reply, room type, stay dates, reviewer country, photos). Fetches ALL reviews by default; supports sorting and keyword search. The response also lists the available review filters (by score / language / customer type / season / topic).","tags":["Travel & Lodging"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"page_name":{"type":"string"},"country_code":{"type":"string"},"hotel_id":{"type":"string"},"hotel_url":{"type":"string"},"max_reviews":{"type":"string"},"sort_by":{"type":"string"},"keyword":{"type":"string"},"review_page_size":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/booking/v1/destinations/autocomplete":{"post":{"operationId":"booking_destinations_autocomplete","summary":"Resolve a free-text place ('Paris', 'Maldives', 'JFK') into the destination IDs the other actions take (dest_id + dest_type), with country, coordinates and how many hotels/homes each match has. Use this first when you only have a place name.","tags":["Travel & Lodging"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"}}},"example":{"query":"Paris"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/books/v1/book_detail":{"post":{"operationId":"books_book_detail","summary":"merged book record by ISBN-10/13 or OLID (work OL..W / edition OL..M): title/authors/covers/subjects/description/pages/publishers/languages/editions/identifiers/ratings+distribution/reading-log; queried ISBN always injected","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]},"example":{"id":"9780439023528"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/books/v1/search":{"post":{"operationId":"books_search","summary":"search books: q OR fielded (title/author/subject/publisher/place/person/isbn/language); rich cards (ratings/reading-log/ebook_access/IA); sort=new|old|rating|want_to_read|editions; pagination","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"query":{"type":"string"},"title":{"type":"string"},"author":{"type":"string"},"subject":{"type":"string"},"publisher":{"type":"string"},"place":{"type":"string"},"person":{"type":"string"},"isbn":{"type":"string"},"language":{"type":"string"},"sort":{"type":"string"},"limit":{"type":"string"},"per_page":{"type":"string"},"page":{"type":"string"}}},"example":{"q":"the hunger games"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/books/v1/author":{"post":{"operationId":"books_author","summary":"author by OLID (OL..A) → bio/photo/dates/alternate-names/remote-ids(goodreads/wikidata/viaf/gutenberg)/links + include_works; or query/name → best-match-ranked author list","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"query":{"type":"string"},"name":{"type":"string"},"q":{"type":"string"},"include_works":{"type":"string"},"works_limit":{"type":"string"},"per_page":{"type":"string"},"limit":{"type":"string"}}},"example":{"query":"j r r tolkien"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/books/v1/author_works":{"post":{"operationId":"books_author_works","summary":"full paginated bibliography of an author (OL..A): every work with cover, first-publish year and subjects; page/limit pagination over the author's complete catalog","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"olid":{"type":"string"},"limit":{"type":"string"},"per_page":{"type":"string"},"page":{"type":"string"}},"required":["id"]},"example":{"id":"OL26320A","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/books/v1/subjects":{"post":{"operationId":"books_subjects","summary":"browse a subject / genre / theme → ranked work cards PLUS facets (top authors, publishers, related subjects, people, places, time-periods) and work_count/ebook_count; optional ebooks-only and published_in year-range filters; page/limit pagination","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subject":{"type":"string"},"name":{"type":"string"},"q":{"type":"string"},"genre":{"type":"string"},"ebooks":{"type":"string"},"published_in":{"type":"string"},"sort":{"type":"string"},"limit":{"type":"string"},"per_page":{"type":"string"},"page":{"type":"string"}},"required":["subject"]},"example":{"subject":"fantasy","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/books/v1/trending":{"post":{"operationId":"books_trending","summary":"most popular / trending books for a time window (now|daily|weekly|monthly|yearly) → ranked work cards (title, authors, cover, year, ebook access); page/limit pagination","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"period":{"type":"string"},"range":{"type":"string"},"limit":{"type":"string"},"per_page":{"type":"string"},"page":{"type":"string"}}},"example":{"period":"daily","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/books/v1/editions":{"post":{"operationId":"books_editions","summary":"every printing / edition of a book (give a work OLID, an edition OLID, or any ISBN) → each edition's ISBN-10/13, publisher, format, publish date/place, page count, language and cover; page/limit pagination","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"olid":{"type":"string"},"isbn":{"type":"string"},"limit":{"type":"string"},"per_page":{"type":"string"},"page":{"type":"string"}},"required":["id"]},"example":{"id":"OL5735363W","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/books/v1/ebook":{"post":{"operationId":"books_ebook","summary":"public-domain full-text (Project Gutenberg): query OR id=Gutenberg-id OR ids=batch; filters languages/topic/sort; returns formats{epub/txt/html/kindle/cover}+download_url+read_url; gutenberg.org OPDS fallback when gutendex is down","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"search":{"type":"string"},"q":{"type":"string"},"id":{"type":"string"},"gutenberg_id":{"type":"string"},"ids":{"type":"string"},"languages":{"type":"string"},"topic":{"type":"string"},"sort":{"type":"string"},"mime_type":{"type":"string"},"author_year_start":{"type":"string"},"author_year_end":{"type":"string"},"copyright":{"type":"string"},"limit":{"type":"string"},"per_page":{"type":"string"},"page":{"type":"string"}}},"example":{"id":"1342"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/boyner/v1/search":{"post":{"operationId":"boyner_search","summary":"Search Boyner by keyword (`query`), paginated (`page`, 24/page). Every card carries product_id, title, brand, price (current + original + discount%), seller (merchantName — filter 'BOYNER' for Boyner-sold), campaigns/coupons (Hopi, 'Sepette %N İndirim'), image, url, category, rating, stock.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"page":{"type":"string"},"max_rotations":{"type":"string"}},"required":["query"]},"example":{"query":"erkek spor ayakkabı"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/boyner/v1/product/detail":{"post":{"operationId":"boyner_product_detail","summary":"Full Boyner product by `url` OR `product_id`: title, brand, price (current + original + discount%), campaign headline + coupons (Hopi etc.), seller/merchantName + other offers, SIZES (Beden — EU sizes with per-size stock + barcode), all images, rating, review_count, stock, gtin/barcode, category, breadcrumbs, attributes, description and sample reviews. Parsed from Boyner's own getProductDetail JSON.","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"product_id":{"type":"string"},"max_rotations":{"type":"string"}}},"example":{"url":"https://www.boyner.com.tr/tommy-hilfiger-lacivert-erkek-sneaker-th-hi-vulc-core-low-lth-ii-ess-p-15593795"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/car-rental/v1/cars/search":{"post":{"operationId":"car_rental_cars_search","summary":"aggregated rental-car offers for a location + dates → offers[]{vehicle(name/category/ACRISS/transmission/seats/bags/fuel), price{amount,currency}, supplier(name/rating/pickup_address/coords), pickup.type, mileage, fuel_policy, free_cancellation, book_url} + facets. Location via `query` OR explicit place_id/city_id/country_id. One-way via drop_query. Dates pickup_date/dropoff_date (YYYY-MM-DD). Narrow with category/supplier/transmission/max_price/min_supplier_rating/free_cancellation_only filters + sort.","tags":["Travel & Lodging"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"place_id":{"type":"string"},"city_id":{"type":"string"},"country_id":{"type":"string"},"pickup_date":{"type":"string"},"dropoff_date":{"type":"string"},"pickup_time":{"type":"string"},"dropoff_time":{"type":"string"},"currency":{"type":"string"},"residence_country":{"type":"string"},"driver_age":{"type":"string"},"drop_query":{"type":"string"},"drop_place_id":{"type":"string"},"drop_city_id":{"type":"string"},"drop_country_id":{"type":"string"},"max_offers":{"type":"string"},"include_facets":{"type":"string"},"prefer_airport":{"type":"string"},"category":{"type":"string"},"supplier":{"type":"string"},"transmission":{"type":"string"},"min_seats":{"type":"string"},"max_price":{"type":"string"},"min_supplier_rating":{"type":"string"},"free_cancellation_only":{"type":"string"},"unlimited_mileage_only":{"type":"string"},"sort":{"type":"string"},"include_supplier_summary":{"type":"string"}}},"example":{"query":"Madrid Airport","currency":"EUR","pickup_date":"2026-10-15","dropoff_date":"2026-10-18","max_offers":40}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/car-rental/v1/cars/autocomplete":{"post":{"operationId":"car_rental_cars_autocomplete","summary":"resolve a location string (`query`) → place/city/country IDs (for cars/search)","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"example":{"query":"London"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/car-rental/v1/cars/reviews":{"post":{"operationId":"car_rental_cars_reviews","summary":"DiscoverCars customer reviews for a location → reviews[]{rating(0-10), text, author, author_country, car_name, date, photos} + average_rating + count. Location via `query` (city/country name; resolved automatically) OR explicit location_url. Filter with min_rating / with_text_only; country_only widens city→country scope.","tags":["Travel & Lodging"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"location_url":{"type":"string"},"country_only":{"type":"string"},"min_rating":{"type":"string"},"with_text_only":{"type":"string"},"max_reviews":{"type":"string"}}},"example":{"query":"Madrid"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/change-detect/v1/snapshot":{"post":{"operationId":"change_detect_snapshot","summary":"Fetch a URL and return a noise-resistant fingerprint: content_hash (normalised main content, rotating-token-stripped), structural_hash (DOM skeleton), text_hash, title, meta_description, main_content (boilerplate-stripped), word_count, links[]. Store the returned snapshot/hash and feed it back to diff/monitor_check later.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"selector":{"type":"string"},"follow_redirects":{"type":"string"}},"required":["url"]},"example":{"url":"https://example.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/change-detect/v1/diff":{"post":{"operationId":"change_detect_diff","summary":"Diff a page against a prior baseline (snapshot object OR content_hash OR raw text), or compare two live URLs (url + url2). Returns changed(bool), change_ratio(0..1), change_type(text|structural|both|none), added[]/removed[]/modified[] blocks, and a human summary — all on the NOISE-RESISTANT normalised content.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"baseline":{"type":"string"},"url2":{"type":"string"},"selector":{"type":"string"},"mode":{"type":"string"},"follow_redirects":{"type":"string"}},"required":["url"]},"example":{"url":"https://example.com","url2":"https://www.iana.org/help/example-domains"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/change-detect/v1/monitor_check":{"post":{"operationId":"change_detect_monitor_check","summary":"The stateless half of monitoring: re-fetch the URL and tell you FAST whether it changed since a known hash. Pass baseline_hash (+ optional selector/mode). Returns changed(bool) + current_hash + a short diff_summary — the cheap 'did it change?' path.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"baseline_hash":{"type":"string"},"selector":{"type":"string"},"mode":{"type":"string"},"follow_redirects":{"type":"string"}},"required":["url","baseline_hash"]},"example":{"url":"https://example.com","baseline_hash":"0000000000000000000000000000000000000000000000000000000000000000"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/change-detect/v1/extract":{"post":{"operationId":"change_detect_extract","summary":"Main-content extraction only — boilerplate (nav/header/footer/ads/cookie/comments) stripped → clean text + structured blocks + links. Useful to feed clean diffs or to get just the article. No fingerprint comparison.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"selector":{"type":"string"},"follow_redirects":{"type":"string"}},"required":["url"]},"example":{"url":"https://example.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/change-detect/v1/batch":{"post":{"operationId":"change_detect_batch","summary":"Snapshot up to 20 URLs concurrently in one call (each independently SSRF-guarded, shared concurrency). Returns a compact fingerprint per URL.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string"},"selector":{"type":"string"}},"required":["urls"]},"example":{"urls":["https://example.com","https://www.iana.org/domains/reserved"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/chrono24/v1/search":{"post":{"operationId":"chrono24_search","summary":"Search Chrono24 by free-text keyword (brand + model + reference, e.g. 'rolex submariner', 'omega speedmaster 3861'). Optional filters: price_min/price_max, condition (new/used), movement, year, sort. Paginated (~60/page). Returns listing cards with title, price, currency, condition availability, image and url.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"page":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"condition":{"type":"string"},"movement":{"type":"string"},"year":{"type":"string"},"sort":{"type":"string"}},"required":["query"]},"example":{"query":"rolex submariner"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/chrono24/v1/browse":{"post":{"operationId":"chrono24_browse","summary":"Browse all listings for a brand (e.g. brand='rolex') or a brand+model (brand='omega', model='speedmaster'). Same filters and paginated card shape as search — the catalog-discovery surface for a whole brand or model family.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brand":{"type":"string"},"model":{"type":"string"},"page":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"condition":{"type":"string"},"movement":{"type":"string"},"year":{"type":"string"},"sort":{"type":"string"}},"required":["brand"]},"example":{"brand":"omega"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/chrono24/v1/detail":{"post":{"operationId":"chrono24_detail","summary":"Full watch listing by `url` OR `listing_id`: brand, model, reference number, price, currency, condition (+ condition text), year, movement, case material, case diameter, crystal, strap material, dial, gender, jewels, power reserve, scope of delivery, seller location, delivery estimate, description and all images.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"listing_id":{"type":"string"}}},"example":{"url":"https://www.chrono24.com/omega/seamaster--id45792727.htm"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/copart/v1/search":{"post":{"operationId":"copart_search","summary":"Search live Copart auction lots by free-text `query` and/or structured filters (make, model, year or year_min/year_max, title_type, vehicle_type, damage, condition, source, odometer_min/max, yard_number). Sortable + paginated. Returns rich lot cards with damage, title, odometer, estimated value, current bid, sale date, location and thumbnail.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"make":{"type":"string"},"model":{"type":"string"},"year":{"type":"string"},"year_min":{"type":"string"},"year_max":{"type":"string"},"title_type":{"type":"string"},"vehicle_type":{"type":"string"},"damage":{"type":"string"},"condition":{"type":"string"},"source":{"type":"string"},"odometer_min":{"type":"string"},"odometer_max":{"type":"string"},"yard_number":{"type":"string"},"location":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"},"size":{"type":"string"}}},"example":{"make":"HONDA","size":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/copart/v1/lot_detail":{"post":{"operationId":"copart_lot_detail","summary":"Full detail for one lot by `lot_number`: VIN (publicly masked by Copart), make, model, trim, year, primary/secondary damage, title type & group, odometer, color, engine, fuel, drive, transmission, estimated retail value, current/high bid, sale date & time, yard location (city/state/zip/lat/long) and keys availability.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lot_number":{"type":"string"}},"required":["lot_number"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/copart/v1/lot_images":{"post":{"operationId":"copart_lot_images","summary":"All auction photos for one lot by `lot_number`: ordered full-size, hi-res and thumbnail image URLs for the vehicle (exterior, interior, damage, VIN plate, odometer).","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lot_number":{"type":"string"}},"required":["lot_number"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/copart/v1/yards":{"post":{"operationId":"copart_yards","summary":"Live list of Copart yards / locations you can filter `search` by, each with its yard_number and current lot count. Lifted from the live search facet taxonomy — use a yard_number with search's `yard_number` filter to scope to one location.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/coursera/v1/search":{"post":{"operationId":"coursera_search","summary":"Search Coursera by keyword (any topic, skill, tool or title). Returns a paginated list of result cards — name, url, type (course / specialization / professional certificate / guided project), partner, rating, review count, difficulty, duration, skills and free status — most-relevant first. Optional filters: level, type, language, sort. Feed a result's slug/url into the detail action. Page with `page`; meta.has_more / meta.total_count tell you how many.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"level":{"type":"string"},"type":{"type":"string"},"language":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"},"subject":{"type":"string"}},"required":["query"]},"example":{"query":"machine learning"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/coursera/v1/detail":{"post":{"operationId":"coursera_detail","summary":"Full detail for one Coursera course OR program (specialization / professional certificate) by slug or URL. For a course: description, difficulty, estimated workload, rating (average, count, by-star), total enrollments, languages, certificates, what-you'll-learn, recommended background, skills, instructors and partners. For a program: the same plus the list of courses inside it. Pass a search result's url, or a slug with type='specialization' to force the program path.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"url":{"type":"string"},"type":{"type":"string"}}},"example":{"slug":"machine-learning"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/coursera/v1/reviews":{"post":{"operationId":"coursera_reviews","summary":"Top public student reviews for a Coursera course or program by slug/url: star rating, review text, author and date. Returns the most-helpful reviews Coursera surfaces on the page (top reviews — Coursera does not expose deep review pagination without login). Use meta.review_count for the total number of ratings.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"url":{"type":"string"},"type":{"type":"string"}}},"example":{"slug":"machine-learning"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/coursera/v1/partners":{"post":{"operationId":"coursera_partners","summary":"Browse the universities and companies that partner with Coursera (Stanford, University of Michigan, Google, IBM, …). Returns partner id, name and logo. Use it to map who publishes on Coursera.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/coursera/v1/subjects":{"post":{"operationId":"coursera_subjects","summary":"Browse Coursera's subject catalogue — the top-level domains (Data Science, Business, Computer Science, Arts & Humanities, …) with their slug and description. Use a subject slug as the search `subject` filter.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/currency/v1/latest":{"post":{"operationId":"currency_latest","summary":"latest reference rates for a base (default EUR) → all or selected target currencies (+ unix timestamp)","tags":["Finance & Data"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"base":{"type":"string"},"symbols":{"type":"string"}}},"example":{"base":"EUR"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/currency/v1/convert":{"post":{"operationId":"currency_convert","summary":"convert an amount from→to at the latest rate (or a given historical date); returns rate + result","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"},"amount":{"type":"string"},"date":{"type":"string"}},"required":["from","to"]},"example":{"from":"USD","to":"EUR","amount":100}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/currency/v1/historical":{"post":{"operationId":"currency_historical","summary":"reference rates on a past date (YYYY-MM-DD; weekend/holiday → last working day) since 1999-01-04","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string"},"base":{"type":"string"},"symbols":{"type":"string"}},"required":["date"]},"example":{"date":"2020-07-01","base":"USD","symbols":"EUR,GBP"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/currency/v1/timeseries":{"post":{"operationId":"currency_timeseries","summary":"rates over a date range (working days) for a base → selected/all targets; {date:{CUR:val}}","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"start":{"type":"string"},"end":{"type":"string"},"base":{"type":"string"},"symbols":{"type":"string"}},"required":["start","end"]},"example":{"start":"2024-01-02","end":"2024-01-05","base":"EUR","symbols":"USD"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/currency/v1/fluctuation":{"post":{"operationId":"currency_fluctuation","summary":"per-currency change over a date range: {CUR:{start_rate,end_rate,change,change_pct}} (derived from the range endpoints)","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"start":{"type":"string"},"end":{"type":"string"},"base":{"type":"string"},"symbols":{"type":"string"}},"required":["start","end"]},"example":{"start":"2024-01-02","end":"2024-01-31","base":"EUR","symbols":"USD"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/currency/v1/currencies":{"post":{"operationId":"currency_currencies","summary":"the current ECB reference currency set (code → name)","tags":["Finance & Data"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/decathlon/v1/search":{"post":{"operationId":"decathlon_search","summary":"Search or browse the decathlon.com (US) catalogue. Give a free-text `query` ('hiking boots', 'bike helmet', 'kiprun'), a `collection` handle to browse (`running`, `womens`, `mens-hiking-boots`, `all`), or both to search inside one collection. Every result carries Decathlon's own product id and handle, the product title, house brand, product type, tags, image, price range, sale price, stock flag and — in catalogue and collection mode — the variant count, SKU list and shipping-weight range. Narrow with product_type, vendor, tag, min_price, max_price and available_only; sort by price, name or publish date; page through the whole match set. Live facet vocabularies with counts come back with every catalogue-mode response, so the filter values are never a guess. Feed a result's `handle` straight into `product_detail` for barcodes and per-variant weights.","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"collection":{"type":"string"},"mode":{"type":"string"},"max_results":{"type":"string"},"page":{"type":"string"},"sort":{"type":"string"},"product_type":{"type":"string"},"vendor":{"type":"string"},"tag":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"available_only":{"type":"string"}}},"example":{"query":"hiking boots"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/decathlon/v1/product_detail":{"post":{"operationId":"decathlon_product_detail","summary":"Get one Decathlon product in full, by handle, product id or decathlon.com URL — title, house brand, product type, tags, the marketing description in both plain text and its original HTML, every image with dimensions and the variants it belongs to, product video and 3D media, the option axes with their values, and one row per size x colour variant. Each variant row carries Decathlon's own variant id, the retail SKU, the **EAN-13 barcode**, the **shipping weight in grams** (plus the merchant's own weight + unit pair), the live **inventory quantity** as a real integer, the buyable flag, price, compare-at price, tax and shipping flags, and any volume-pricing rules. Built for shipping-cost and catalogue-matching work: barcode and grams are the two fields this endpoint exists for.","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string"},"product_id":{"type":"string"},"url":{"type":"string"}}},"example":{"handle":"decathlon-gift-card"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/dev-utils/v1/hash":{"post":{"operationId":"dev_utils_hash","summary":"Hash/checksum text or binary (base64/hex) input: md5…sha3·blake2·crc32·adler32, optional HMAC keying → hex + base64 digests.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"string"},"algo":{"type":"string"},"hmac_key":{"type":"string"},"input_encoding":{"type":"string"}},"required":["input"]},"example":{"input":"hello world","algo":"sha256"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/dev-utils/v1/uuid":{"post":{"operationId":"dev_utils_uuid","summary":"Generate ids: uuid v4/v7/v1(MAC-safe)/v3/v5, ULID, nanoid — up to 100.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"string"},"count":{"type":"string"},"namespace":{"type":"string"},"name":{"type":"string"},"size":{"type":"string"}}},"example":{"version":"v4","count":3}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/dev-utils/v1/encode":{"post":{"operationId":"dev_utils_encode","summary":"Encode/decode: base64(+url-safe), hex, URL (path/component/form), HTML entities, unicode-escape, json-string.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"string"},"op":{"type":"string"},"direction":{"type":"string"}},"required":["input","op"]},"example":{"input":"Merhaba Dünya! 👋","op":"base64"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/dev-utils/v1/jwt_decode":{"post":{"operationId":"dev_utils_jwt_decode","summary":"Decode a JWT WITHOUT needing the key (header+payload+claims analysis); optionally verify the signature with a provided key. Decode-only — this API never signs tokens.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string"},"verify_key":{"type":"string"}},"required":["token"]},"example":{"token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c","verify_key":"your-256-bit-secret"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/dev-utils/v1/password":{"post":{"operationId":"dev_utils_password","summary":"Generate cryptographically-secure passwords (charset controls, ambiguity filter) + entropy strength score; or score a provided password with `check`.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"length":{"type":"string"},"count":{"type":"string"},"lowercase":{"type":"string"},"uppercase":{"type":"string"},"digits":{"type":"string"},"symbols":{"type":"string"},"exclude_ambiguous":{"type":"string"},"check":{"type":"string"}}},"example":{"length":24,"count":2}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/dev-utils/v1/cron":{"post":{"operationId":"dev_utils_cron","summary":"Explain a cron expression in plain language (15 locales) + compute the next N run times in any IANA timezone (DST-correct).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expression":{"type":"string"},"runs":{"type":"string"},"tz":{"type":"string"},"locale":{"type":"string"},"from_time":{"type":"string"}},"required":["expression"]},"example":{"expression":"*/15 9-17 * * 1-5","runs":3,"tz":"UTC","from_time":"2026-06-10T12:00:00+00:00"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/dev-utils/v1/slugify":{"post":{"operationId":"dev_utils_slugify","summary":"URL-safe slug from any-script text (CJK/Cyrillic/Arabic → ASCII via anyascii transliteration).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"string"},"separator":{"type":"string"},"lowercase":{"type":"string"},"max_length":{"type":"string"}},"required":["input"]},"example":{"input":"Çok Güzel Bir Başlık — 2026!"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/dev-utils/v1/regex_test":{"post":{"operationId":"dev_utils_regex_test","summary":"Test a regex against text: matches + groups + named groups, optional replace. User patterns run with a hard 1s timeout (ReDoS-guarded) + size caps.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"pattern":{"type":"string"},"input":{"type":"string"},"flags":{"type":"string"},"replacement":{"type":"string"},"max_matches":{"type":"string"}},"required":["pattern","input"]},"example":{"pattern":"(\\w+)@([\\w.]+)","input":"mail jane@acme.com now"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/dev-utils/v1/format":{"post":{"operationId":"dev_utils_format","summary":"Pretty-print, minify or validate JSON / YAML / XML / SQL (string-level; file/data CONVERSION lives in the file-convert API).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"string"},"type":{"type":"string"},"op":{"type":"string"},"indent":{"type":"string"},"sort_keys":{"type":"string"},"keyword_case":{"type":"string"}},"required":["input","type"]},"example":{"input":"{\"b\":1,\"a\":[1,2]}","type":"json","op":"pretty","sort_keys":true}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/dev-utils/v1/convert":{"post":{"operationId":"dev_utils_convert","summary":"Convert structured data between JSON / YAML / CSV / XML at the string level (paste-in, ≤512KB). CSV↔JSON is tabular (array of flat objects). For file/Excel/multi-MB conversion use the file-convert API.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"indent":{"type":"string"},"sort_keys":{"type":"string"}},"required":["input","from","to"]},"example":{"input":"[{\"id\":1,\"name\":\"a\"},{\"id\":2,\"name\":\"b\"}]","from":"json","to":"csv"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/dev-utils/v1/qr":{"post":{"operationId":"dev_utils_qr","summary":"Generate a QR code as SVG (text), base64-PNG (text data-URI), or terminal ASCII — all textual output, no binary asset. Up to QR version 40.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"string"},"kind":{"type":"string"},"error_correction":{"type":"string"},"scale":{"type":"string"},"border":{"type":"string"}},"required":["input"]},"example":{"input":"https://reefapi.com","kind":"svg"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/dev-utils/v1/color":{"post":{"operationId":"dev_utils_color","summary":"Parse any CSS color (hex/rgb()/hsl()/name) → every format + CSS3 name + luminance; optional second color → WCAG 2.x contrast ratio + AA/AAA.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"string"},"contrast_with":{"type":"string"}},"required":["input"]},"example":{"input":"#1a2b3c","contrast_with":"#ffffff"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/dev-utils/v1/mock_data":{"post":{"operationId":"dev_utils_mock_data","summary":"Generate fake/test records (Faker, 70+ locales): preset bundles (person/address/company/internet/profile/product/lorem) or a custom field→type schema; seed for reproducible output.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"preset":{"type":"string"},"schema":{"type":"string"},"count":{"type":"string"},"locale":{"type":"string"},"seed":{"type":"string"}}},"example":{"preset":"person","count":2,"seed":42}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/dev-utils/v1/text_diff":{"post":{"operationId":"dev_utils_text_diff","summary":"Unified diff between two texts + change stats + similarity ratio.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"a":{"type":"string"},"b":{"type":"string"},"context":{"type":"string"},"label_a":{"type":"string"},"label_b":{"type":"string"}},"required":["a","b"]},"example":{"a":"one\ntwo","b":"one\n2"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/dev-utils/v1/text_analyze":{"post":{"operationId":"dev_utils_text_analyze","summary":"Algorithmic text analysis (no LLM): language detect (97 langs) · readability (Flesch & co) · profanity flag/censor · keyword extraction · full stats. Pick checks or get all.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"string"},"checks":{"type":"string"},"top_keywords":{"type":"string"}},"required":["input"]},"example":{"input":"The quick brown fox jumps over the lazy dog. The fox is fast."}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/dev-utils/v1/timestamp":{"post":{"operationId":"dev_utils_timestamp","summary":"Parse/convert any timestamp ('now', unix s/ms/µs, ISO-8601, RFC-2822) → every format + timezone conversion + relative time.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"value":{"type":"string"},"tz":{"type":"string"}}},"example":{"value":"1718000000","tz":"Europe/Istanbul"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/dev-utils/v1/case_convert":{"post":{"operationId":"dev_utils_case_convert","summary":"Convert identifier/text casing: camel·pascal·snake·kebab·constant·dot·title·sentence·upper·lower (+ detected input case).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"string"},"target":{"type":"string"}},"required":["input","target"]},"example":{"input":"getUserProfileURL","target":"snake"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/dev-utils/v1/base_convert":{"post":{"operationId":"dev_utils_base_convert","summary":"Convert integers between bases 2-36 (arbitrary precision; 0x/0b/0o prefixes accepted).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"string"},"from_base":{"type":"string"},"to_base":{"type":"string"}},"required":["input"]},"example":{"input":"ff","from_base":16,"to_base":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/dev-utils/v1/markdown":{"post":{"operationId":"dev_utils_markdown","summary":"Render CommonMark+tables markdown → sanitized HTML (raw HTML escaped, XSS-safe) + heading TOC with slugs.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"string"}},"required":["input"]},"example":{"input":"# Hello\n\nworld **bold**\n\n## Sub Title"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/dev-utils/v1/user_agent":{"post":{"operationId":"dev_utils_user_agent","summary":"Parse a User-Agent string → browser/OS/device families + versions + bot flag (uap-core database).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"string"}},"required":["input"]},"example":{"input":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/dev-utils/v1/batch":{"post":{"operationId":"dev_utils_batch","summary":"Run up to 100 mixed dev-utils calls in one request.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"string"}},"required":["items"]},"example":{"items":[{"action":"hash","params":{"input":"abc","algo":"md5"}},{"action":"base_convert","params":{"input":"1010","from_base":2}},{"action":"encode","params":{"input":"x","op":"nope"}}]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-availability/v1/check":{"post":{"operationId":"domain_availability_check","summary":"Is one domain available? Combined RDAP and DNS verdict with confidence + Domainr-style status tokens + a register_url when free. Accepts domain OR name+tld.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"name":{"type":"string"},"tld":{"type":"string"},"signal":{"type":"string"},"whois":{"type":"string"},"include_pii":{"type":"string"}},"required":["domain"]},"example":{"domain":"google.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-availability/v1/bulk_check":{"post":{"operationId":"domain_availability_bulk_check","summary":"One NAME across many TLDs → availability map (which of name.com/.io/.ai/… are free).","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"tlds":{"type":"string"},"signal":{"type":"string"}},"required":["name"]},"example":{"name":"google","tlds":"com,net,org"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-availability/v1/rdap":{"post":{"operationId":"domain_availability_rdap","summary":"Full WHOIS via RDAP for a registered domain (registrar, created/expires, status, nameservers, dnssec, abuse). A 404 is returned cleanly (available on RDAP-served TLDs; null + a pointer to 'check' on TLDs with no RDAP server), not an error.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"raw":{"type":"string"},"include_pii":{"type":"string"}},"required":["domain"]},"example":{"domain":"github.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-availability/v1/suggest":{"post":{"operationId":"domain_availability_suggest","summary":"Name variations (prefix/suffix/TLD permutations, deterministic — no LLM) each with a live availability verdict; available ones surfaced first.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"tlds":{"type":"string"},"signal":{"type":"string"}},"required":["name"]},"example":{"name":"reefapi","tlds":"com,io,ai"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-availability/v1/batch":{"post":{"operationId":"domain_availability_batch","summary":"Many DIFFERENT full domains in one call → availability for each (bulk check).","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domains":{"type":"string"},"signal":{"type":"string"}},"required":["domains"]},"example":{"domains":"google.com,this-name-is-surely-free-9z8x7q.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-intel/v1/whois":{"post":{"operationId":"domain_intel_whois","summary":"Domain registration (WHOIS) via RDAP: registrar (+ IANA id), reseller, status flags, created/updated/expires dates, nameservers, DNSSEC flag, abuse contact, and registrant (org-only unless include_pii). Legacy-WHOIS-only TLDs (.io/.de) return NOT_FOUND — see tld_detail.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"raw":{"type":"string"},"include_pii":{"type":"string"}},"required":["domain"]},"example":{"domain":"github.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-intel/v1/dns":{"post":{"operationId":"domain_intel_dns","summary":"DNS records over DNS-over-HTTPS: A/AAAA/MX/TXT/NS/CNAME/SOA/CAA by default; PTR/SRV/DS/DNSKEY/TLSA and any RR type on request via the 'types' param.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"types":{"type":"string"}},"required":["domain"]},"example":{"domain":"github.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-intel/v1/reverse_dns":{"post":{"operationId":"domain_intel_reverse_dns","summary":"Reverse DNS (PTR): the hostname each of the domain's A/AAAA IPs resolves back to, or pass an explicit IPv4/IPv6 to PTR that single address. Missing PTR is a common mail-rejection cause.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]},"example":{"domain":"github.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-intel/v1/hosting":{"post":{"operationId":"domain_intel_hosting","summary":"Hosting / ASN / IP-owner: resolves the domain's A+AAAA IPs and looks up each via Team Cymru — ASN, announced prefix, country, RIR, AS-name (network owner) + reverse DNS. Tells you who hosts a domain and on what network.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]},"example":{"domain":"github.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-intel/v1/dnssec":{"post":{"operationId":"domain_intel_dnssec","summary":"DNSSEC signing status: the DoH AD (Authenticated-Data) flag (the resolver cryptographically validated the answer), the DS record at the parent (delegation signed), and DNSKEY presence — plus a broken-chain warning (DS without DNSKEY).","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]},"example":{"domain":"cloudflare.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-intel/v1/ssl_certs":{"post":{"operationId":"domain_intel_ssl_certs","summary":"SSL/TLS certificates from Certificate Transparency (CT) logs (certspotter primary, crt.sh deep fallback): issuer, common name, SANs, validity window, serial, expired flag.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"limit":{"type":"string"},"deep":{"type":"string"}},"required":["domain"]},"example":{"domain":"github.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-intel/v1/subdomains":{"post":{"operationId":"domain_intel_subdomains","summary":"Subdomain discovery via Certificate-Transparency-log cert SANs (the standard passive method; pass deep=true for full crt.sh history = more results).","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"deep":{"type":"string"}},"required":["domain"]},"example":{"domain":"github.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-intel/v1/availability":{"post":{"operationId":"domain_intel_availability","summary":"Domain registration availability via RDAP (registered ⇔ an RDAP record exists). Caveat: legacy-WHOIS-only TLDs report 'available' falsely — surfaced in the note.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]},"example":{"domain":"github.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-intel/v1/tld_list":{"post":{"operationId":"domain_intel_tld_list","summary":"The IANA list of all delegated top-level domains (optionally substring-filtered).","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"search":{"type":"string"},"limit":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-intel/v1/tld_detail":{"post":{"operationId":"domain_intel_tld_detail","summary":"Per-TLD metadata: ccTLD vs gTLD and its IANA RDAP server(s) (or a note that it is legacy-WHOIS-only, which explains why whois/availability 404 for that TLD).","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tld":{"type":"string"}},"required":["tld"]},"example":{"tld":"com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-intel/v1/tech_detect":{"post":{"operationId":"domain_intel_tech_detect","summary":"Tech-stack fingerprint from the homepage response headers + HTML: web server, CDN/WAF, and frameworks/CMS/analytics (WordPress, Next.js, Shopify, React, Bitrix, Tilda, Yandex.Metrica, …). Tries https, then plain http, then the www host, so HTTP-only and www-only-certificate sites are fingerprinted instead of reported as blocked; `https_available` tells you which it was.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]},"example":{"domain":"github.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-intel/v1/full_report":{"post":{"operationId":"domain_intel_full_report","summary":"One-call merge: whois + dns + dnssec + ssl_certs + subdomains (and optionally tech + hosting). meta.sections shows per-part status.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"include_tech":{"type":"string"},"include_hosting":{"type":"string"},"include_pii":{"type":"string"},"deep":{"type":"string"}},"required":["domain"]},"example":{"domain":"github.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-risk/v1/assess":{"post":{"operationId":"domain_risk_assess","summary":"Comprehensive fraud and security risk report for one domain: a 0-100 risk score, human-readable reasons, and a risk level (low / medium / elevated / high). Combines domain age, expiry status, parked/for-sale detection, TLS certificate presence, hostname structure, brand impersonation signals, and email/DNSSEC legitimacy into a single verdict. The primary action for phishing detection and brand protection.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"check_parked":{"type":"string"},"include_pii":{"type":"string"}},"required":["domain"]},"example":{"domain":"google.com","check_parked":false}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-risk/v1/age":{"post":{"operationId":"domain_risk_age","summary":"Domain age + expiry-risk band + renewal status (lifecycle synthesis from RDAP dates — NOT a raw whois dump; use domain-intel.whois for that).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]},"example":{"domain":"github.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-risk/v1/parked":{"post":{"operationId":"domain_risk_parked","summary":"Detect whether a domain is parked or listed for sale. Checks parking nameserver signals and the domain's root page for for-sale phrases and marketplace redirect hosts (Sedo, Afternic, GoDaddy, etc.). Returns a confidence-scored verdict: parked, for_sale, or actively in use. Returns 'unknown' when the page cannot be read.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]},"example":{"domain":"google.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-risk/v1/typosquat":{"post":{"operationId":"domain_risk_typosquat","summary":"Generate a brand's lookalike domains across 16 permutation families (meets/exceeds dnstwist; incl IDN homoglyph/homograph) then report which are ACTUALLY REGISTERED + their risk — the brand-protection product.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"families":{"type":"string"},"keywords":{"type":"string"},"check_registered":{"type":"string"}},"required":["domain"]},"example":{"domain":"paypal.com","families":"homoglyph,replacement,omission"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-risk/v1/reputation":{"post":{"operationId":"domain_risk_reputation","summary":"Registrar / nameserver / age / mail-hygiene (SPF·DMARC·DNSSEC) trust signals → a 0-100 reputation_score + trust_level. Reputation is a positive-trust lens (vs assess's risk lens).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]},"example":{"domain":"github.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/domain-risk/v1/batch":{"post":{"operationId":"domain_risk_batch","summary":"Risk-assess up to 50 domains in one call (RDAP + DNS + email hygiene scoring, no per-domain parked-page probe). Returns a risk verdict per domain plus a combined high-risk list — ideal for bulk fraud screening.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domains":{"type":"string"}},"required":["domains"]},"example":{"domains":"google.com,g00gle.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/donanimhaber/v1/search":{"post":{"operationId":"donanimhaber_search","summary":"Keyword-search every post on DonanımHaber Forum — the site's own search index, not a page scrape. Returns the matching post's title, excerpt, section, author-visible timestamp and a deep link to the exact message. Filter to opening posts only (topic search), to one section, or to one thread; sort by recency or relevance. Ideal for Turkish-market demand signals, product mentions and support chatter.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"search_in":{"type":"string"},"match":{"type":"string"},"sort":{"type":"string"},"first_post_only":{"type":"string"},"section":{"type":"string"},"topic":{"type":"string"},"posted_within":{"type":"string"},"limit":{"type":"string"},"page":{"type":"string"}},"required":["query"]},"example":{"query":"ekran kartı","search_in":"title","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/donanimhaber/v1/topic":{"post":{"operationId":"donanimhaber_topic","summary":"Full detail for one DonanımHaber Forum thread: title, the complete opening post as clean text, the author (public handle, profile, staff title, lifetime post count), published/last-updated timestamps, the section it lives in, view / post / like counts, and the replies on the requested page with their own authors, timestamps and like counts.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"topic":{"type":"string"},"page":{"type":"string"}},"required":["topic"]},"example":{"topic":"163852334"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/donanimhaber/v1/section":{"post":{"operationId":"donanimhaber_section","summary":"List the topics in one DonanımHaber Forum section, newest activity first, with pagination (65 topics per page). Each row carries the title, the site's own opening-post teaser, the thread starter, reply and view counts, and the last-post timestamp — enough to monitor a section without opening a single thread.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"section":{"type":"string"},"page":{"type":"string"},"limit":{"type":"string"},"query":{"type":"string"},"posted_within":{"type":"string"},"include_sticky":{"type":"string"}},"required":["section"]},"example":{"section":"2770","limit":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/donanimhaber/v1/sections":{"post":{"operationId":"donanimhaber_sections","summary":"The DonanımHaber Forum section directory — every public section with its numeric id, name and URL, optionally filtered by name. Use it to resolve a topic area ('SEO', 'yazılım', 'ekran kartı') to the `section` id that `search` and `section` take.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"}}},"example":{"query":"seo","limit":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/ebay/v1/search":{"post":{"operationId":"ebay_search","summary":"active-listing search by `query` -> results[]{item_id,title,price{value,currency},condition,buying_format,shipping,location,image,url,sold_count?,catalog_rating?}. Filters: domain(com/co.uk/de/...), page, max_results(<=240/page), sort(best_match|newly_listed|ending_soonest|price_low|price_high), condition(new|used|refurbished|open_box|for_parts), category, buy_it_now, auction. seller is item-page-only.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"domain":{"type":"string"},"page":{"type":"string"},"max_results":{"type":"string"},"sort":{"type":"string"},"condition":{"type":"string"},"category":{"type":"string"},"buy_it_now":{"type":"string"},"auction":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"free_shipping":{"type":"string"},"returns_accepted":{"type":"string"},"best_offer":{"type":"string"},"location":{"type":"string"}},"required":["query"]},"example":{"query":"iphone 13 pro"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/ebay/v1/item_detail":{"post":{"operationId":"ebay_item_detail","summary":"Full eBay item detail by item_id or listing URL: title, price, list price, currency, condition, availability, brand, model, MPN, images, category path, item specifics, seller (name, feedback score, review count), shipping terms, return policy, PLUS auction fields (bids, current_bid, time_left, end_time), watchers, quantity_available/quantity_sold, best_offer flag, and multi-variation SKUs (variations[]{dimension, values[]{value, out_of_stock}}). Set include_description=1 to inline the full seller description text.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"item_id":{"type":"string"},"url":{"type":"string"},"domain":{"type":"string"},"include_description":{"type":"string"}}},"example":{"item_id":"287070621317"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/ebay/v1/items_batch":{"post":{"operationId":"ebay_items_batch","summary":"Look up MANY eBay listings in ONE call by item number — up to 15 per request → the same full record `item_detail` returns for each one (title, price, condition, brand/model/MPN, images, category path, item specifics, seller reputation, shipping terms, return policy, auction fields, quantities). Built for enriching a price list or a competitor's catalogue in one round trip instead of one item at a time. COST, stated plainly so you can budget it: eBay publishes no batched item endpoint — every listing is its own page — so this costs ONE UPSTREAM REQUEST PER ITEM ID, exactly as if you had called item_detail N times, and it is priced that way. What you save is wall-clock, not requests: the fetches run concurrently, measured at 25.6s sequential vs 4.1s for 8 ids (6.2x). `meta.upstream_calls` always reports the true number. Anything eBay does not resolve comes back in `not_found` rather than being silently dropped, so a batch of 15 can never hide which one went missing. If you only need card-level fields (item_id, title, price, condition, shipping, image, url) there is a genuinely cheaper route that costs ONE upstream call: `search` with query `(id1,id2,id3)` — eBay's own OR syntax — measured to resolve 6 ids per call (a 7th is dropped) and to return no item specifics, seller or return policy.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"item_ids":{"type":"string"},"domain":{"type":"string"}},"required":["item_ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/ebay/v1/seller_items":{"post":{"operationId":"ebay_seller_items","summary":"All active listings in a seller's storefront by `seller` username (eBay _ssn) -> results[]{item_id,title,price{value,currency},condition,buying_format,shipping,location,image,url}. Same card shape + filters/pagination as `search`. Use to scan a competitor's full catalog. Page-native paging via meta.pagination.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"seller":{"type":"string"},"domain":{"type":"string"},"page":{"type":"string"},"max_results":{"type":"string"},"sort":{"type":"string"},"condition":{"type":"string"},"category":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"free_shipping":{"type":"string"},"returns_accepted":{"type":"string"},"best_offer":{"type":"string"},"location":{"type":"string"},"buy_it_now":{"type":"string"},"auction":{"type":"string"}},"required":["seller"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/ebay/v1/seller_profile":{"post":{"operationId":"ebay_seller_profile","summary":"Seller reputation by `seller` username -> seller_profile{store_name, feedback_score, feedback_positive_pct, positive_pct_12mo, items_sold_display, followers_display, member_since, location, business_seller, top_rated, feedback_ratings{positive/neutral/negative:{m1,m6,m12}}}. From the public storefront + feedback pages (logged-out, no account).","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"seller":{"type":"string"},"domain":{"type":"string"}},"required":["seller"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/ebay/v1/deals":{"post":{"operationId":"ebay_deals","summary":"eBay Daily Deals grid (/deals) -> results[]{item_id,title,price{value,currency},was_price{value,currency},shipping,deal_badge,image,url}. Current promoted discounts site-wide for the marketplace. No query needed.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"max_results":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/ebay/v1/categories":{"post":{"operationId":"ebay_categories","summary":"eBay category tree / ID lookup (/n/all-categories) -> categories[]{category_id,name,slug} + groups[] (top-level departments). Pass `query` to filter by name so you can resolve a category name (e.g. 'cell phones') to the numeric ID used by search's `category` param — no need to know '9355' in advance.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"domain":{"type":"string"},"max_results":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/edx/v1/search":{"post":{"operationId":"edx_search","summary":"Search the edX catalogue by keyword (any topic, skill, tool or course/program title — 'python', 'machine learning', 'data science', 'cybersecurity', 'finance'). Returns a paginated list of result cards: name, url, type (course / program / executive education / degree), partner, level, languages, subjects, duration, effort, price, skills and enrollment. Optional filters: level, type, program_type, language, subject, partner, availability. Page with `page` (20 per page); meta.has_more / meta.total_count tell you how many. Feed a result's slug/url into the detail action.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"level":{"type":"string"},"type":{"type":"string"},"program_type":{"type":"string"},"language":{"type":"string"},"subject":{"type":"string"},"partner":{"type":"string"},"availability":{"type":"string"},"page":{"type":"string"}},"required":["query"]},"example":{"query":"python"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/edx/v1/detail":{"post":{"operationId":"edx_detail","summary":"Full detail for one edX course OR program by slug or URL. For a course: level, languages, duration, effort, price, enrollment count, full description, what-you'll-learn, overview, prerequisites, syllabus, skills, subjects, partners, instructors (faculty) and course runs (sessions). For a program (professional certificate / MicroMasters / XSeries / degree): the same plus the list of courses inside it. Pass a search result's url or slug.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"url":{"type":"string"}}},"example":{"slug":"learn/python/harvard-university-cs50-s-introduction-to-programming-with-python"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/edx/v1/partners":{"post":{"operationId":"edx_partners","summary":"Browse every school, university and company that publishes on edX (Harvard, MIT, IBM, Google Cloud, Stanford, Delft, …) with the number of courses/programs each offers. Use a partner name as the search `partner` filter.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/edx/v1/subjects":{"post":{"operationId":"edx_subjects","summary":"Browse edX's subject areas (Computer Science, Business & Management, Data Analysis & Statistics, Engineering, Economics & Finance, …) with the number of courses in each. Use a subject name as the search `subject` filter.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/elcorteingles/v1/search":{"post":{"operationId":"elcorteingles_search","summary":"Search or browse elcorteingles.es. Give a Spanish free-text `query` ('zapatillas running', 'movil samsung', 'lavadora'), an El Corte Inglés product code or a bare EAN-13, or a `category` path to browse ('electronica/moviles-y-smartphones', 'moda-mujer/zapatos'). Every row carries El Corte Inglés' own product code, the product URL to feed straight into `product_detail`, the name, brand, EAN-13, price range across colours, the colour list, the variant count, how many of those variants are actually buyable, the image, the category hierarchy and whether the listing is a marketplace seller's. Sort by price, discount, rating, newness, name or stock; page through the whole result set. `category` browsing is the route El Corte Inglés' robots.txt allows and `meta.robots` reports which route answered.","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"category":{"type":"string"},"page":{"type":"string"},"max_results":{"type":"string"},"sort":{"type":"string"}}},"example":{"query":"zapatillas running","max_results":12}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/elcorteingles/v1/product_detail":{"post":{"operationId":"elcorteingles_product_detail","summary":"Get one El Corte Inglés product in full, by URL, product code or EAN-13. ONE call returns the complete image gallery, the full colour x size variant matrix with a stable native variant id, an EAN-13, a price, a strike-through price and a live buyable flag on EVERY row, the specification table as El Corte Inglés publishes it (grouped, with their own glossary text), the brand, the availability, the star rating and the top customer reviews inline, plus the seller behind each variant (El Corte Inglés itself or a marketplace merchant), the active promotions and the EU-Omnibus 30-day lowest price. Supermarket products are supported too and return their EAN, gallery and full nutrition panel instead of a size matrix. A product El Corte Inglés has WITHDRAWN answers `NOT_FOUND` with `meta.withdrawn: true` and `meta.withdrawn_product` naming the product it was — their server keeps the page online for search engines but pulls every price, so there is no offer left to return. That verdict is permanent and `retryable: false`: it is the signal to drop the SKU from a monitoring list, not a transient failure to retry.","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"product_id":{"type":"string"},"ean":{"type":"string"},"include_reviews":{"type":"string"},"max_reviews":{"type":"string"}}},"example":{"ean":"8806097643135","include_reviews":true}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/email-health/v1/check":{"post":{"operationId":"email_health_check","summary":"Full email-health audit: SPF + DKIM + DMARC + MX + BIMI + MTA-STS + TLS-RPT + DNSSEC + blacklist, plus a 0-100 deliverability score and letter grade.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"selector":{"type":"string"},"selectors":{"type":"string"},"bimi_selector":{"type":"string"},"skip_blacklist":{"type":"string"}},"required":["domain"]},"example":{"domain":"google.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/email-health/v1/spf":{"post":{"operationId":"email_health_spf","summary":"Parse + validate the SPF record: follow include:/redirect=, count the ≤10 DNS-lookup mechanisms, flag +all and void lookups, report the all-qualifier policy.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]},"example":{"domain":"google.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/email-health/v1/dmarc":{"post":{"operationId":"email_health_dmarc","summary":"Parse the DMARC policy at _dmarc.: p/sp/pct/rua/ruf/adkim/aspf/fo + enforcement verdict.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]},"example":{"domain":"paypal.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/email-health/v1/dkim":{"post":{"operationId":"email_health_dkim","summary":"DKIM selector lookup (._domainkey.): key type, public-key presence, RSA key-bit estimate, revocation. Autoscans ~30 common selectors if none given.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"selector":{"type":"string"},"selectors":{"type":"string"}},"required":["domain"]},"example":{"domain":"paypal.com","selector":"pp2"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/email-health/v1/mx":{"post":{"operationId":"email_health_mx","summary":"MX records (sorted by preference) + a mail-provider guess from the exchange hostnames.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]},"example":{"domain":"github.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/email-health/v1/blacklist":{"post":{"operationId":"email_health_blacklist","summary":"DNSBL reputation: reverse the domain's A + MX-host IPs against live-proven public DNSBLs (SpamCop, Barracuda, UCEPROTECT, PSBL, Mailspike, GBUdb, DroneBL, s5h). Spamhaus/CBL are flagged as paid-key-required (public-resolver refused), not queried.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"ips":{"type":"string"}},"required":["domain"]},"example":{"domain":"github.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/email-health/v1/mta_sts":{"post":{"operationId":"email_health_mta_sts","summary":"MTA-STS: the _mta-sts. TXT (id) plus the fetched https://mta-sts./.well-known/mta-sts.txt policy (mode, mx[], max_age).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]},"example":{"domain":"google.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/email-health/v1/bimi":{"post":{"operationId":"email_health_bimi","summary":"BIMI brand-logo record at ._bimi.: the published logo (SVG) URL and the VMC (Verified Mark Certificate) URL, plus whether a VMC is present. Standalone lookup (MXToolbox SuperTool exposes BIMI on its own — no full audit needed).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"selector":{"type":"string"}},"required":["domain"]},"example":{"domain":"cnn.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/email-health/v1/tls_rpt":{"post":{"operationId":"email_health_tls_rpt","summary":"SMTP TLS Reporting (RFC 8460) record at _smtp._tls.: the rua= report destination(s) that receive aggregate TLS-negotiation failure reports. Standalone lookup.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]},"example":{"domain":"google.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/email-health/v1/dnssec":{"post":{"operationId":"email_health_dnssec","summary":"DNSSEC signing status: the DoH AD (Authenticated-Data) flag = the resolver cryptographically validated the answer, plus a DS record at the parent = the delegation is signed. Standalone lookup.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]},"example":{"domain":"cloudflare.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/email-health/v1/dane":{"post":{"operationId":"email_health_dane","summary":"DANE for SMTP (RFC 7672): TLSA records at _25._tcp. for every MX host, with per-host DNSSEC validation (DANE is only effective on a signed TLSA RRset). Value-add: MXToolbox has NO TLSA/DANE lookup.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]},"example":{"domain":"internet.nl"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/email-health/v1/batch":{"post":{"operationId":"email_health_batch","summary":"Run the full 'check' audit on up to 25 domains in one call (each with score + grade).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domains":{"type":"string"},"skip_blacklist":{"type":"string"}},"required":["domains"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/email-preflight/v1/audit_html":{"post":{"operationId":"email_preflight_audit_html","summary":"Full pre-send structure + accessibility + deliverability lint of an HTML email: missing alt text, broken structure, mobile-width risks, dark-mode hints, tracking pixels, external assets, List-Unsubscribe check, Gmail-clip size budget, and prioritized recommendations. Pure local compute (no network).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"html":{"type":"string"},"text_part":{"type":"string"},"base_url":{"type":"string"},"subject":{"type":"string"},"check_links":{"type":"string"}},"required":["html"]},"example":{"html":"hi"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/email-preflight/v1/css_support":{"post":{"operationId":"email_preflight_css_support","summary":"Email-client CSS/HTML compatibility map for the template (Can-I-Email data, MIT): which CSS features used in the HTML break or degrade in Outlook/Gmail/Apple Mail/Yahoo and friends. Pure local compute (offline snapshot).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"html":{"type":"string"}},"required":["html"]},"example":{"html":"
x
"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/email-preflight/v1/spam_score":{"post":{"operationId":"email_preflight_spam_score","summary":"Deterministic spam-SIGNAL score for the email content (caps ratio, image-to-text ratio, spam phrases, missing unsubscribe, raw-IP links…). HONEST: a content signal score, NOT an inbox-placement prediction; SpamAssassin/Rspamd sidecar = the calibrated upgrade (see docs). Pure local compute.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"html":{"type":"string"},"subject":{"type":"string"},"text_part":{"type":"string"}},"required":["html"]},"example":{"html":"

100% FREE!!! ACT NOW — WIN CASH PRIZE

","subject":"FREE MONEY"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/email-preflight/v1/check_links":{"post":{"operationId":"email_preflight_check_links","summary":"Resolve every link in the email through url-resolver (SSRF-guarded): final URL, redirect chain, status, final domain. Bot-403/429 = `unverifiable` (honest — not marked broken). Inner-calls url-resolver per link.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"html":{"type":"string"},"base_url":{"type":"string"}},"required":["html"]},"example":{"html":"ab"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/email-preflight/v1/check_images":{"post":{"operationId":"email_preflight_check_images","summary":"Audit every in the email: alt text presence, dimensions declared, src scheme/format, http-vs-https, and (best-effort) reachability via url-resolver. Pure-compute by default; reachability adds sub-calls.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"html":{"type":"string"},"base_url":{"type":"string"},"check_reachable":{"type":"string"}},"required":["html"]},"example":{"html":"ok"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/email-preflight/v1/dns_auth":{"post":{"operationId":"email_preflight_dns_auth","summary":"Sender-domain email-authentication summary (SPF/DKIM/DMARC/MX + deliverability grade) via an inner-call to the email-health engine — REUSE, not re-implemented here (email-health owns DNS auth; this is a thin preflight wrapper).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"dkim_selector":{"type":"string"},"include_blacklist":{"type":"string"}},"required":["domain"]},"example":{"domain":"github.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/email-preflight/v1/preview_basic":{"post":{"operationId":"email_preflight_preview_basic","summary":"Basic visual preview: render the HTML to a PNG via web-capture's browser sandbox. HONEST: a browser render, NOT a real email-client render (no Outlook/Word engine). Degrades gracefully if web-capture is not deployed.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"html":{"type":"string"},"width":{"type":"string"}},"required":["html"]},"example":{"html":"

hi

"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/encar/v1/search":{"post":{"operationId":"encar_search","summary":"Search live Encar used-car listings by structured filters: make, model, trim, car_type (domestic/imported), fuel, transmission, region, price_min/max (in 만원 = 10,000 KRW), year_min/max and mileage_min/max. Sortable + paginated. Returns rich cards with price (native 만원 + KRW), year, mileage, fuel, transmission, region, trust/condition flags, thumbnail and photos.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"make":{"type":"string"},"model":{"type":"string"},"trim":{"type":"string"},"car_type":{"type":"string"},"fuel":{"type":"string"},"transmission":{"type":"string"},"region":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"year_min":{"type":"string"},"year_max":{"type":"string"},"mileage_min":{"type":"string"},"mileage_max":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"},"size":{"type":"string"}}},"example":{"make":"Hyundai","size":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/encar/v1/detail":{"post":{"operationId":"encar_detail","summary":"Full detail for one car by `id`: price (만원 + KRW), make/model/grade (Korean + English), year, mileage, displacement, transmission, fuel, color, seats, body type, options, warranty, inspection & accident-record availability, seizing/pledge counts, VIN (when public), all photos, view count, free-text description and the selling dealer's firm. Dealer personal data (name/phone/id/address) is redacted unless include_pii is set.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/encar/v1/makes":{"post":{"operationId":"encar_makes","summary":"Browse all Korean (domestic) and imported makes available on Encar, each with its live listing count. Use a returned make name with `search`'s `make` filter. Counts are pulled live from the search API (not a stale list).","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"car_type":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-app/v1/app_reputation":{"post":{"operationId":"enrich_app_app_reputation","summary":"name|store-URL|domain → entity-resolved app/SaaS reputation: store ratings + Trustpilot + GitHub + Product Hunt (basic) — see app_reputation_rich for the full fan-out (review samples + TrustRadius + status + news)","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"country":{"type":"string"},"stores":{"type":"string"},"include":{"type":"string"},"exclude":{"type":"string"},"trustradius_slug":{"type":"string"}},"required":["query"]},"example":{"query":"https://apps.apple.com/us/app/notion/id1232780281","include":["stores"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-app/v1/app_reputation_rich":{"post":{"operationId":"enrich_app_app_reputation_rich","summary":"everything in app_reputation + a recent store-review sample + TrustRadius B2B reviews + vendor live status/incidents + recent news mentions","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"country":{"type":"string"},"stores":{"type":"string"},"include":{"type":"string"},"exclude":{"type":"string"},"trustradius_slug":{"type":"string"}},"required":["query"]},"example":{"query":"https://apps.apple.com/us/app/notion/id1232780281"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-app/v1/batch":{"post":{"operationId":"enrich_app_batch","summary":"reputation for up to 10 apps/domains in one call (basic groups, cache-first, per-item ok/error)","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string"},"country":{"type":"string"},"stores":{"type":"string"},"include":{"type":"string"},"exclude":{"type":"string"}},"required":["queries"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-company/v1/company_domain":{"post":{"operationId":"enrich_company_company_domain","summary":"domain → entity-resolved company profile (core groups) with per-field provenance","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"include":{"type":"string"},"exclude":{"type":"string"}},"required":["domain"]},"example":{"domain":"github.com","include":["domain","presence"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-company/v1/company_domain_rich":{"post":{"operationId":"enrich_company_company_domain_rich","summary":"everything in company_domain + firmographics (LinkedIn/Indeed/Glassdoor), review depth, local/maps match, brand trends, app/package presence, registry funding signals (Wikidata), traffic rank","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"include":{"type":"string"},"exclude":{"type":"string"}},"required":["domain"]},"example":{"domain":"github.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-company/v1/batch":{"post":{"operationId":"enrich_company_batch","summary":"enrich up to 10 domains in one call (core groups, cache-first, per-domain ok/error)","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domains":{"type":"string"},"include":{"type":"string"},"exclude":{"type":"string"}},"required":["domains"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-hiring/v1/hiring_signal":{"post":{"operationId":"enrich_hiring_hiring_signal","summary":"domain → company hiring snapshot: ATS provider + direct open-roles count, per-source counts (deduped), departments/seniority/remote-ratio/tech-signals, entity-confirm, honest snapshot intensity","tags":["Jobs & Hiring"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"company_name":{"type":"string"},"ats_slug":{"type":"string"},"ats_provider":{"type":"string"},"countries":{"type":"string"}}},"example":{"domain":"stripe.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-hiring/v1/hiring_signal_rich":{"post":{"operationId":"enrich_hiring_hiring_signal_rich","summary":"everything in hiring_signal + employer firmographics (linkedin company / glassdoor employer: industry, employee_count, HQ, founded, rating) which anchor a headcount-relative intensity (open-roles-to-headcount ratio)","tags":["Jobs & Hiring"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"company_name":{"type":"string"},"ats_slug":{"type":"string"},"ats_provider":{"type":"string"},"countries":{"type":"string"}}},"example":{"domain":"stripe.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-hiring/v1/batch":{"post":{"operationId":"enrich_hiring_batch","summary":"hiring_signal for up to 10 domains in one call (cache-first, per-item ok/error)","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domains":{"type":"string"}},"required":["domains"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-local/v1/business_lookup":{"post":{"operationId":"enrich_local_business_lookup","summary":"name+location ‖ place_query → matched place (Google Maps) + multi-source review presence + website health + indexed presence + negative-news + legitimacy signal list, with an honest coverage_note + per-group provenance.","tags":["Reputation & Reviews"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"location":{"type":"string"},"place_query":{"type":"string"},"lat":{"type":"string"},"lng":{"type":"string"},"country":{"type":"string"},"yelp_enc_biz_id":{"type":"string"},"include":{"type":"string"},"exclude":{"type":"string"}}},"example":{"name":"Katz's Delicatessen","location":"Manhattan","lat":40.7223,"lng":-73.9874,"include":["website"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-local/v1/batch":{"post":{"operationId":"enrich_local_batch","summary":"enrich up to 10 businesses in one call (lead-list use-case; per-item ok/error, cache-first).","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"businesses":{"type":"string"},"include":{"type":"string"},"exclude":{"type":"string"}},"required":["businesses"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-package/v1/package_trust":{"post":{"operationId":"enrich_package_package_trust","summary":"ecosystem+package → registry metadata + downloads + maintainers + license + resolved repository health + vulnerabilities + partial trust score (with per-sub-score inputs)","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ecosystem":{"type":"string"},"package":{"type":"string"},"version":{"type":"string"},"mode":{"type":"string"}},"required":["ecosystem","package"]},"example":{"ecosystem":"npm","package":"lodash","version":"4.17.15","mode":"rich"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-package/v1/repo_trust":{"post":{"operationId":"enrich_package_repo_trust","summary":"owner/repo → repository health + release cadence + bus-factor signal + repo-anchored trust sub-scores (popularity/maintenance), independent of any registry","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-package/v1/lockfile_scan":{"post":{"operationId":"enrich_package_lockfile_scan","summary":"manifest/lockfile text → dependency list + each dep's vuln/risk summary via one batched vuln scan (BOUNDED: direct + lockfile-pinned deps, max 100; truncated:true when capped). package.json/lock, requirements.txt, go.sum/mod, Cargo.lock, Gemfile.lock","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string"},"filename":{"type":"string"},"ecosystem":{"type":"string"}},"required":["content"]},"example":{"content":"lodash\nflask==2.0.0\nrequests==2.20.0","filename":"requirements.txt"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-package/v1/batch":{"post":{"operationId":"enrich_package_batch","summary":"trust-score up to 10 packages in one call (basic depth, per-item ok/error)","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"string"}},"required":["items"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-property/v1/snapshot":{"post":{"operationId":"enrich_property_snapshot","summary":"address OR listing_url → one normalized property snapshot: status, price, sold-history, core facts, valuation (where available), per-field provenance + a match block (how the address was resolved + match_confidence).","tags":["Real Estate"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string"},"listing_url":{"type":"string"},"country":{"type":"string"},"mode":{"type":"string"}}},"example":{"listing_url":"https://www.zillow.com/homedetails/x/117892026_zpid/"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-property/v1/resolve":{"post":{"operationId":"enrich_property_resolve","summary":"address → ranked candidate listings[] (id + source + match_confidence) so the customer picks the exact property (apartment-unit / stale-listing disambiguation). The false-match-reducing flow — call this when a snapshot returns low confidence.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string"},"country":{"type":"string"},"limit":{"type":"string"}},"required":["address"]},"example":{"address":"137 Mellison Road, Tooting, London, SW17"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-property/v1/batch":{"post":{"operationId":"enrich_property_batch","summary":"snapshot up to 10 addresses/listing-URLs in one call (standard mode, cache-first, per-item ok/error).","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"string"},"country":{"type":"string"}},"required":["items"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-property/v1/coverage":{"post":{"operationId":"enrich_property_coverage","summary":"Static capability map: which countries/sources are supported, per-country source set, and the documented gaps (UK has no AVM; JP only 4 prefectures). No sub-calls.","tags":["Real Estate"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-recall/v1/product_match":{"post":{"operationId":"enrich_recall_product_match","summary":"Resolve a product (GTIN ‖ title+brand ‖ listing_url) and match it against FDA + EU recalls with transparent confidence. recalls[] = high-confidence (brand independently matched); possible[] = lower-confidence candidates.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"gtin":{"type":"string"},"title":{"type":"string"},"brand":{"type":"string"},"category":{"type":"string"},"listing_url":{"type":"string"},"max_results":{"type":"string"}}},"example":{"gtin":"0860007279478"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-recall/v1/brand_check":{"post":{"operationId":"enrich_recall_brand_check","summary":"All recalls for a brand / recalling-firm (normalized passthrough of the recall engine's by_company), newest first — the seller-watch / due-diligence use case.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brand":{"type":"string"},"category":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"limit":{"type":"string"}},"required":["brand"]},"example":{"brand":"Pfizer","category":"drug","limit":3}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-recall/v1/batch":{"post":{"operationId":"enrich_recall_batch","summary":"Scan up to 25 catalog products in one call (seller pre-listing audit). Each item is product_match'd; per-item ok/error + a roll-up summary.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"string"},"max_results":{"type":"string"}},"required":["items"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-store/v1/store_lookup":{"post":{"operationId":"enrich_store_store_lookup","summary":"store domain → platform verdict + store metadata + tech-stack + catalog sample (price/discount/stock signals) + reputation (mode-scaled depth)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"store":{"type":"string"},"mode":{"type":"string"},"max_items":{"type":"string"},"include_marketplace":{"type":"string"}},"required":["store"]},"example":{"store":"allbirds.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-store/v1/platform_detect":{"post":{"operationId":"enrich_store_platform_detect","summary":"store domain → ecommerce platform verdict (shopify|woocommerce|magento|bigcommerce|prestashop|custom_or_unknown) from the store's own public JSON capability test + technographic fingerprint — fast, no catalog fetch","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"store":{"type":"string"}},"required":["store"]},"example":{"store":"allbirds.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-store/v1/batch":{"post":{"operationId":"enrich_store_batch","summary":"look up to 5 stores in one call (basic mode, cache-first, per-store ok/error)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"stores":{"type":"string"}},"required":["stores"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-trust/v1/business_trust":{"post":{"operationId":"enrich_trust_business_trust","summary":"domain‖company_name → entity-resolved PUBLIC trust signals: positive_signals[], risk_signals[], unknowns[] + a respectful heuristic recommendation. NOT KYB/AML.","tags":["Reputation & Reviews"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"company_name":{"type":"string"},"country":{"type":"string"},"business_type":{"type":"string"},"depth":{"type":"string"}}},"example":{"domain":"stripe.com","depth":"basic"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-trust/v1/batch":{"post":{"operationId":"enrich_trust_batch","summary":"assess up to 10 domains in one call (core signals, cache-first, per-item ok/error)","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domains":{"type":"string"},"country":{"type":"string"},"business_type":{"type":"string"}},"required":["domains"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-url/v1/classify":{"post":{"operationId":"enrich_url_classify","summary":"Any URL → final_url, cleaned_url (tracking stripped), domain, entity_type{value,confidence,source}, platform, recommended{engine,action,params} (the Reef deep-fetch card; web-extract fallback for unknown hosts), tracking{affiliate,stripped_params}.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"deep":{"type":"string"}},"required":["url"]},"example":{"url":"https://www.amazon.com/dp/B08N5WRWNW?tag=aff-20&utm_source=x"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-url/v1/extract_entity":{"post":{"operationId":"enrich_url_extract_entity","summary":"Any URL → a lightweight entity card with title, image, description, price, author and publication date — great for link previews and deciding which Reef engine to call next. Use the recommended{} field from classify for the full deep-fetch.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]},"example":{"url":"https://github.com/torvalds/linux"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-url/v1/batch":{"post":{"operationId":"enrich_url_batch","summary":"Classify up to 20 URLs in one call (the link-list cleanup + routing use-case): per-URL ok/error, each independently resolved + classified.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string"}},"required":["urls"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/enrich-url/v1/catalog_resolve":{"post":{"operationId":"enrich_url_catalog_resolve","summary":"META (no network): given a known platform name OR a URL's host, return which Reef engine+action handles it and the param key it needs — the routing table itself (url-resolver marketplace engine_hints + the non-marketplace platform map). For agents discovering 'which engine for X'.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"platform":{"type":"string"},"url":{"type":"string"}}},"example":{"platform":"instagram"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/etsy/v1/listings/search":{"post":{"operationId":"etsy_listings_search","summary":"Search Etsy handmade/vintage listings by keyword — returns listing cards with id, title, price, sale price, shop, image and listing URL. Supports category, price range, sort and pagination filters.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"max_pages":{"type":"string"},"sort":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"category":{"type":"string"},"free_shipping":{"type":"string"}},"required":["query"]},"example":{"query":"silver ring"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/etsy/v1/listings/detail":{"post":{"operationId":"etsy_listings_detail","summary":"Full Etsy listing detail by listing ID or URL — title, price, sale price, currency, rating, review count, favorites (demand signal), stock-left, variations, gallery images, description, tags, materials, category and shipping estimate.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"listing_url":{"type":"string"},"listing_id":{"type":"string"},"url":{"type":"string"}}},"example":{"listing_id":"1509738931"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/etsy/v1/shops/detail":{"post":{"operationId":"etsy_shops_detail","summary":"Etsy shop profile by shop slug or URL — name, total lifetime sales, location, star rating, review count, admirers (followers), active-listings count, year opened and the shop's featured listings (deduped, with title/price/image).","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"shop_url":{"type":"string"},"shop_slug":{"type":"string"},"url":{"type":"string"}}},"example":{"shop_slug":"SilverRainSilver"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/etsy/v1/shops/listings":{"post":{"operationId":"etsy_shops_listings","summary":"Browse a shop's full active catalog, paginated — every product the shop sells (not just the featured handful), with id, title, price, sale price, image and listing URL. Page through with max_pages to pull the whole inventory.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"shop_url":{"type":"string"},"shop_slug":{"type":"string"},"url":{"type":"string"},"max_pages":{"type":"string"},"sort":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/etsy/v1/listings/category":{"post":{"operationId":"etsy_listings_category","summary":"Browse Etsy by category (the /c/ grid) — discover trending/popular listings in a category without a keyword. Supports sub-categories, price range, sort and pagination.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"max_pages":{"type":"string"},"sort":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"free_shipping":{"type":"string"}},"required":["category"]},"example":{"category":"jewelry/rings"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/etsy/v1/reviews/shop":{"post":{"operationId":"etsy_reviews_shop","summary":"Customer reviews for an Etsy shop — star rating, review text, reviewer, date, the shop's reply, buyer photos and the listing each review is about. Pass shop_slug for the full paginated review stream (about 14 reviews per page). Passing only the numeric shop_id uses Etsy's compact shop-summary feed, which returns at most 6 reviews no matter what limit you ask for.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"shop_slug":{"type":"string"},"shop_url":{"type":"string"},"url":{"type":"string"},"shop_id":{"type":"string"},"limit":{"type":"string"},"max_pages":{"type":"string"},"exclude_listing_id":{"type":"string"}}},"example":{"shop_id":"7357402","limit":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/etsy/v1/reviews/listing":{"post":{"operationId":"etsy_reviews_listing","summary":"Customer reviews for a single Etsy listing — star rating, review text, reviewer, date, the shop's reply and buyer photos, plus the item's overall rating and total review count. Page 1 is the review panel Etsy shows on the item page (up to 4 reviews); raise max_pages to pull further reviews of this item out of the shop's review stream.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"listing_url":{"type":"string"},"listing_id":{"type":"string"},"url":{"type":"string"},"max_pages":{"type":"string"}}},"example":{"listing_id":"1509738931","max_pages":1}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/etsy/v1/search/suggest":{"post":{"operationId":"etsy_search_suggest","summary":"Etsy search autocomplete — keyword suggestions for a partial query (no account required).","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"}},"required":["query"]},"example":{"query":"silver ring"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/eventbrite/v1/search":{"post":{"operationId":"eventbrite_search","summary":"Search Eventbrite for events by keyword in a city, with optional category, date and free-only filters. Paginated (~20 events/page). Returns each event's name, date, venue with coordinates, image and link.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"location":{"type":"string"},"category":{"type":"string"},"date":{"type":"string"},"free":{"type":"string"},"page":{"type":"string"}}},"example":{"query":"music","location":"united-states--new-york"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/eventbrite/v1/detail":{"post":{"operationId":"eventbrite_detail","summary":"Full detail for one event by id or url: name, description, start/end datetime, venue with full address and coordinates, organizer, ticket price range (low/high + currency), availability, language, status and image.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"event_id":{"type":"string"},"url":{"type":"string"}}},"example":{"event_id":"1989917921069"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/eventbrite/v1/organizer":{"post":{"operationId":"eventbrite_organizer","summary":"Profile for an event organizer by id or url: name, bio, verification, avatar, follower count, website and social links, and how many upcoming events they have.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"organizer_id":{"type":"string"},"url":{"type":"string"}}},"example":{"organizer_id":"105655500371"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/eventbrite/v1/organizer_events":{"post":{"operationId":"eventbrite_organizer_events","summary":"An organizer's events, paginated (30/page). Choose upcoming (default) or past. Returns each event with name, start/end datetime, venue, category, price range and link.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizer_id":{"type":"string"},"type":{"type":"string"},"page":{"type":"string"}},"required":["organizer_id"]},"example":{"organizer_id":"105655500371"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/eventbrite/v1/browse":{"post":{"operationId":"eventbrite_browse","summary":"Browse Eventbrite's curated event listings for a city and/or category (the discovery shelf). Returns the featured events for that location/category — same event shape as search. This surface is a single curated page (not paginated); use `search` with a query for paginated results.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"},"category":{"type":"string"}}},"example":{"location":"united-states--new-york"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/feed-gateway/v1/fetch":{"post":{"operationId":"feed_gateway_fetch","summary":"Fetch ONE feed URL (RSS 2.0/0.9x, RSS 1.0/RDF, Atom, JSON-Feed 1.1 — auto-detected) and normalise it into one clean JSON schema. Broken XML, HTML entities, encoding mess and truncated feeds are repaired automatically (recovery step reported in meta).","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"limit":{"type":"string"},"sort_by":{"type":"string"},"sort_dir":{"type":"string"},"include_content":{"type":"string"},"since":{"type":"string"},"until":{"type":"string"}},"required":["url"]},"example":{"url":"https://feeds.bbci.co.uk/news/world/rss.xml","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/feed-gateway/v1/discover":{"post":{"operationId":"feed_gateway_discover","summary":"Find the feeds of ANY website: parses tags + visible anchor hints, then probes common feed paths at BOTH the host root (/feed, /rss.xml, /atom.xml, /index.xml, …) AND under the given path (e.g. /r/programming/.rss). Every candidate is fetched and VERIFIED as a real parseable feed before being returned — so it works even on sites that don't declare a feed link-tag.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"probe":{"type":"string"},"limit":{"type":"string"}},"required":["url"]},"example":{"url":"https://www.theverge.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/feed-gateway/v1/merge":{"post":{"operationId":"feed_gateway_merge","summary":"Merge up to 10 feeds into ONE de-duplicated, date-sorted stream. Duplicates are detected on a canonical link key (tracking params stripped) falling back to guid/title. Each item carries its source_feed.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string"},"limit":{"type":"string"},"sort_dir":{"type":"string"},"dedup":{"type":"string"},"since":{"type":"string"},"until":{"type":"string"},"include_content":{"type":"string"}},"required":["urls"]},"example":{"urls":["https://feeds.bbci.co.uk/news/world/rss.xml","https://feeds.bbci.co.uk/news/technology/rss.xml"],"limit":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/feed-gateway/v1/search":{"post":{"operationId":"feed_gateway_search","summary":"Keyword-filter feed items (like RSSHub filter / Feedly search, but no account). Searches title/summary/author/categories (and content_html when include_content=true); multi-word queries match any or all terms; exclude= drops unwanted items.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"urls":{"type":"string"},"query":{"type":"string"},"exclude":{"type":"string"},"fields":{"type":"string"},"match":{"type":"string"},"limit":{"type":"string"},"sort_by":{"type":"string"},"sort_dir":{"type":"string"},"include_content":{"type":"string"},"since":{"type":"string"},"until":{"type":"string"}}},"example":{"url":"https://feeds.bbci.co.uk/news/world/rss.xml","query":"a e i o u","match":"any"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/feed-gateway/v1/batch":{"post":{"operationId":"feed_gateway_batch","summary":"Fetch up to 20 feeds in ONE call (concurrent, fault-isolated): each feed returns independently with its own ok/error — one dead feed never fails the batch.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string"},"limit":{"type":"string"},"include_content":{"type":"string"},"sort_by":{"type":"string"},"sort_dir":{"type":"string"}},"required":["urls"]},"example":{"urls":["https://feeds.bbci.co.uk/news/world/rss.xml","https://hnrss.org/frontpage"],"limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/pdf_extract_text":{"post":{"operationId":"file_convert_pdf_extract_text","summary":"Extract text from a PDF (per page). mode=layout preserves visual alignment (pdfplumber); mode=plain is fastest. Flags likely-scanned PDFs.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"file_b64":"JVBERi0xLjQKMSAwIG9iajw8L1R5cGUvQ2F0YWxvZy9QYWdlcyAyIDAgUj4+ZW5kb2JqCjIgMCBvYmo8PC9UeXBlL1BhZ2VzL0tpZHNbMyAwIFJdL0NvdW50IDE+PmVuZG9iagozIDAgb2JqPDwvVHlwZS9QYWdlL1BhcmVudCAyIDAgUi9NZWRpYUJveFswIDAgNjEyIDc5Ml0vQ29udGVudHMgNCAwIFIvUmVzb3VyY2VzPDwvRm9udDw8L0YxIDUgMCBSPj4+Pj4+ZW5kb2JqCjQgMCBvYmo8PC9MZW5ndGggNTQ+PnN0cmVhbQpCVCAvRjEgMTggVGYgNzIgNzIwIFRkIChSZWVmQVBJIGdvbGRlbiB0ZXN0IFBERikgVGogRVQKZW5kc3RyZWFtZW5kb2JqCjUgMCBvYmo8PC9UeXBlL0ZvbnQvU3VidHlwZS9UeXBlMS9CYXNlRm9udC9IZWx2ZXRpY2E+PmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1MiAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAyMTEgMDAwMDAgbiAKMDAwMDAwMDMxMCAwMDAwMCBuIAp0cmFpbGVyPDwvU2l6ZSA2L1Jvb3QgMSAwIFI+PgpzdGFydHhyZWYKMzcxCiUlRU9GCg=="}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/pdf_metadata":{"post":{"operationId":"file_convert_pdf_metadata","summary":"PDF document properties: title/author/dates/producer, page count & size, encryption flag, AcroForm field count.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"file_b64":"JVBERi0xLjQKMSAwIG9iajw8L1R5cGUvQ2F0YWxvZy9QYWdlcyAyIDAgUj4+ZW5kb2JqCjIgMCBvYmo8PC9UeXBlL1BhZ2VzL0tpZHNbMyAwIFJdL0NvdW50IDE+PmVuZG9iagozIDAgb2JqPDwvVHlwZS9QYWdlL1BhcmVudCAyIDAgUi9NZWRpYUJveFswIDAgNjEyIDc5Ml0vQ29udGVudHMgNCAwIFIvUmVzb3VyY2VzPDwvRm9udDw8L0YxIDUgMCBSPj4+Pj4+ZW5kb2JqCjQgMCBvYmo8PC9MZW5ndGggNTQ+PnN0cmVhbQpCVCAvRjEgMTggVGYgNzIgNzIwIFRkIChSZWVmQVBJIGdvbGRlbiB0ZXN0IFBERikgVGogRVQKZW5kc3RyZWFtZW5kb2JqCjUgMCBvYmo8PC9UeXBlL0ZvbnQvU3VidHlwZS9UeXBlMS9CYXNlRm9udC9IZWx2ZXRpY2E+PmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1MiAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAyMTEgMDAwMDAgbiAKMDAwMDAwMDMxMCAwMDAwMCBuIAp0cmFpbGVyPDwvU2l6ZSA2L1Jvb3QgMSAwIFI+PgpzdGFydHhyZWYKMzcxCiUlRU9GCg=="}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/pdf_merge":{"post":{"operationId":"file_convert_pdf_merge","summary":"Merge 2-20 PDFs into one (input order preserved). Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"files_b64":["JVBERi0xLjQKMSAwIG9iajw8L1R5cGUvQ2F0YWxvZy9QYWdlcyAyIDAgUj4+ZW5kb2JqCjIgMCBvYmo8PC9UeXBlL1BhZ2VzL0tpZHNbMyAwIFJdL0NvdW50IDE+PmVuZG9iagozIDAgb2JqPDwvVHlwZS9QYWdlL1BhcmVudCAyIDAgUi9NZWRpYUJveFswIDAgNjEyIDc5Ml0vQ29udGVudHMgNCAwIFIvUmVzb3VyY2VzPDwvRm9udDw8L0YxIDUgMCBSPj4+Pj4+ZW5kb2JqCjQgMCBvYmo8PC9MZW5ndGggNTQ+PnN0cmVhbQpCVCAvRjEgMTggVGYgNzIgNzIwIFRkIChSZWVmQVBJIGdvbGRlbiB0ZXN0IFBERikgVGogRVQKZW5kc3RyZWFtZW5kb2JqCjUgMCBvYmo8PC9UeXBlL0ZvbnQvU3VidHlwZS9UeXBlMS9CYXNlRm9udC9IZWx2ZXRpY2E+PmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1MiAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAyMTEgMDAwMDAgbiAKMDAwMDAwMDMxMCAwMDAwMCBuIAp0cmFpbGVyPDwvU2l6ZSA2L1Jvb3QgMSAwIFI+PgpzdGFydHhyZWYKMzcxCiUlRU9GCg==","JVBERi0xLjQKMSAwIG9iajw8L1R5cGUvQ2F0YWxvZy9QYWdlcyAyIDAgUj4+ZW5kb2JqCjIgMCBvYmo8PC9UeXBlL1BhZ2VzL0tpZHNbMyAwIFJdL0NvdW50IDE+PmVuZG9iagozIDAgb2JqPDwvVHlwZS9QYWdlL1BhcmVudCAyIDAgUi9NZWRpYUJveFswIDAgNjEyIDc5Ml0vQ29udGVudHMgNCAwIFIvUmVzb3VyY2VzPDwvRm9udDw8L0YxIDUgMCBSPj4+Pj4+ZW5kb2JqCjQgMCBvYmo8PC9MZW5ndGggNTQ+PnN0cmVhbQpCVCAvRjEgMTggVGYgNzIgNzIwIFRkIChSZWVmQVBJIGdvbGRlbiB0ZXN0IFBERikgVGogRVQKZW5kc3RyZWFtZW5kb2JqCjUgMCBvYmo8PC9UeXBlL0ZvbnQvU3VidHlwZS9UeXBlMS9CYXNlRm9udC9IZWx2ZXRpY2E+PmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1MiAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAyMTEgMDAwMDAgbiAKMDAwMDAwMDMxMCAwMDAwMCBuIAp0cmFpbGVyPDwvU2l6ZSA2L1Jvb3QgMSAwIFI+PgpzdGFydHhyZWYKMzcxCiUlRU9GCg=="]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/pdf_split":{"post":{"operationId":"file_convert_pdf_split","summary":"Split a PDF: pages='2-5,8' extracts those pages into one PDF; chunk_size=N splits the whole document into N-page parts (max 100 parts). Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"file_b64":"JVBERi0xLjQKMSAwIG9iajw8L1R5cGUvQ2F0YWxvZy9QYWdlcyAyIDAgUj4+ZW5kb2JqCjIgMCBvYmo8PC9UeXBlL1BhZ2VzL0tpZHNbMyAwIFJdL0NvdW50IDE+PmVuZG9iagozIDAgb2JqPDwvVHlwZS9QYWdlL1BhcmVudCAyIDAgUi9NZWRpYUJveFswIDAgNjEyIDc5Ml0vQ29udGVudHMgNCAwIFIvUmVzb3VyY2VzPDwvRm9udDw8L0YxIDUgMCBSPj4+Pj4+ZW5kb2JqCjQgMCBvYmo8PC9MZW5ndGggNTQ+PnN0cmVhbQpCVCAvRjEgMTggVGYgNzIgNzIwIFRkIChSZWVmQVBJIGdvbGRlbiB0ZXN0IFBERikgVGogRVQKZW5kc3RyZWFtZW5kb2JqCjUgMCBvYmo8PC9UeXBlL0ZvbnQvU3VidHlwZS9UeXBlMS9CYXNlRm9udC9IZWx2ZXRpY2E+PmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1MiAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAyMTEgMDAwMDAgbiAKMDAwMDAwMDMxMCAwMDAwMCBuIAp0cmFpbGVyPDwvU2l6ZSA2L1Jvb3QgMSAwIFI+PgpzdGFydHhyZWYKMzcxCiUlRU9GCg==","chunk_size":1}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/pdf_rotate":{"post":{"operationId":"file_convert_pdf_rotate","summary":"Rotate pages clockwise by 90/180/270° (all pages or a range). Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"file_b64":"JVBERi0xLjQKMSAwIG9iajw8L1R5cGUvQ2F0YWxvZy9QYWdlcyAyIDAgUj4+ZW5kb2JqCjIgMCBvYmo8PC9UeXBlL1BhZ2VzL0tpZHNbMyAwIFJdL0NvdW50IDE+PmVuZG9iagozIDAgb2JqPDwvVHlwZS9QYWdlL1BhcmVudCAyIDAgUi9NZWRpYUJveFswIDAgNjEyIDc5Ml0vQ29udGVudHMgNCAwIFIvUmVzb3VyY2VzPDwvRm9udDw8L0YxIDUgMCBSPj4+Pj4+ZW5kb2JqCjQgMCBvYmo8PC9MZW5ndGggNTQ+PnN0cmVhbQpCVCAvRjEgMTggVGYgNzIgNzIwIFRkIChSZWVmQVBJIGdvbGRlbiB0ZXN0IFBERikgVGogRVQKZW5kc3RyZWFtZW5kb2JqCjUgMCBvYmo8PC9UeXBlL0ZvbnQvU3VidHlwZS9UeXBlMS9CYXNlRm9udC9IZWx2ZXRpY2E+PmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1MiAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAyMTEgMDAwMDAgbiAKMDAwMDAwMDMxMCAwMDAwMCBuIAp0cmFpbGVyPDwvU2l6ZSA2L1Jvb3QgMSAwIFI+PgpzdGFydHhyZWYKMzcxCiUlRU9GCg==","angle":90}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/pdf_to_images":{"post":{"operationId":"file_convert_pdf_to_images","summary":"Render PDF pages to PNG/JPG/WebP (pypdfium2). Max 20 pages per call, dpi ≤ 300. Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"file_b64":"JVBERi0xLjQKMSAwIG9iajw8L1R5cGUvQ2F0YWxvZy9QYWdlcyAyIDAgUj4+ZW5kb2JqCjIgMCBvYmo8PC9UeXBlL1BhZ2VzL0tpZHNbMyAwIFJdL0NvdW50IDE+PmVuZG9iagozIDAgb2JqPDwvVHlwZS9QYWdlL1BhcmVudCAyIDAgUi9NZWRpYUJveFswIDAgNjEyIDc5Ml0vQ29udGVudHMgNCAwIFIvUmVzb3VyY2VzPDwvRm9udDw8L0YxIDUgMCBSPj4+Pj4+ZW5kb2JqCjQgMCBvYmo8PC9MZW5ndGggNTQ+PnN0cmVhbQpCVCAvRjEgMTggVGYgNzIgNzIwIFRkIChSZWVmQVBJIGdvbGRlbiB0ZXN0IFBERikgVGogRVQKZW5kc3RyZWFtZW5kb2JqCjUgMCBvYmo8PC9UeXBlL0ZvbnQvU3VidHlwZS9UeXBlMS9CYXNlRm9udC9IZWx2ZXRpY2E+PmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1MiAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAyMTEgMDAwMDAgbiAKMDAwMDAwMDMxMCAwMDAwMCBuIAp0cmFpbGVyPDwvU2l6ZSA2L1Jvb3QgMSAwIFI+PgpzdGFydHhyZWYKMzcxCiUlRU9GCg==","dpi":72}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/images_to_pdf":{"post":{"operationId":"file_convert_images_to_pdf","summary":"Combine 1-20 images into a single PDF (one page per image; page_size=a4/letter centers each image on a standard page). Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"files_b64":["iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAIAAABvFaqvAAAAH0lEQVR42mN4l+VFFcQwatCoQaMGjRo0atCoQQNvEAB6hKyuf+L5NQAAAABJRU5ErkJggg=="]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/pdf_watermark":{"post":{"operationId":"file_convert_pdf_watermark","summary":"Stamp a text or image watermark over pages (true alpha overlay; diagonal or centred). Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"file_b64":"JVBERi0xLjQKMSAwIG9iajw8L1R5cGUvQ2F0YWxvZy9QYWdlcyAyIDAgUj4+ZW5kb2JqCjIgMCBvYmo8PC9UeXBlL1BhZ2VzL0tpZHNbMyAwIFJdL0NvdW50IDE+PmVuZG9iagozIDAgb2JqPDwvVHlwZS9QYWdlL1BhcmVudCAyIDAgUi9NZWRpYUJveFswIDAgNjEyIDc5Ml0vQ29udGVudHMgNCAwIFIvUmVzb3VyY2VzPDwvRm9udDw8L0YxIDUgMCBSPj4+Pj4+ZW5kb2JqCjQgMCBvYmo8PC9MZW5ndGggNTQ+PnN0cmVhbQpCVCAvRjEgMTggVGYgNzIgNzIwIFRkIChSZWVmQVBJIGdvbGRlbiB0ZXN0IFBERikgVGogRVQKZW5kc3RyZWFtZW5kb2JqCjUgMCBvYmo8PC9UeXBlL0ZvbnQvU3VidHlwZS9UeXBlMS9CYXNlRm9udC9IZWx2ZXRpY2E+PmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1MiAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAyMTEgMDAwMDAgbiAKMDAwMDAwMDMxMCAwMDAwMCBuIAp0cmFpbGVyPDwvU2l6ZSA2L1Jvb3QgMSAwIFI+PgpzdGFydHhyZWYKMzcxCiUlRU9GCg==","text":"CANARY"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/pdf_fill_form":{"post":{"operationId":"file_convert_pdf_fill_form","summary":"AcroForm filling. Without 'fields' → lists the form fields (discovery). With 'fields' → fills and returns the PDF (NeedAppearances set). Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"file_b64":"JVBERi0xLjQKMSAwIG9iajw8L1R5cGUvQ2F0YWxvZy9QYWdlcyAyIDAgUi9BY3JvRm9ybTw8L0ZpZWxkc1s2IDAgUiA3IDAgUl0vREEoL0hlbHYgMCBUZiAwIGcpL0RSPDwvRm9udDw8L0hlbHYgNSAwIFIvWmFEYiA4IDAgUj4+Pj4vTmVlZEFwcGVhcmFuY2VzIHRydWU+Pj4+ZW5kb2JqCjIgMCBvYmo8PC9UeXBlL1BhZ2VzL0tpZHNbMyAwIFJdL0NvdW50IDE+PmVuZG9iagozIDAgb2JqPDwvVHlwZS9QYWdlL1BhcmVudCAyIDAgUi9NZWRpYUJveFswIDAgNjEyIDc5Ml0vQ29udGVudHMgNCAwIFIvUmVzb3VyY2VzPDwvRm9udDw8L0hlbHYgNSAwIFIvWmFEYiA4IDAgUj4+Pj4vQW5ub3RzWzYgMCBSIDcgMCBSXT4+ZW5kb2JqCjQgMCBvYmo8PC9MZW5ndGggNjU+PnN0cmVhbQpCVCAvSGVsdiAxNCBUZiA3MiA3NDAgVGQgKFJlZWZBUEkgZ29sZGVuIEFjcm9Gb3JtIHRlc3QgUERGKSBUaiBFVAplbmRzdHJlYW1lbmRvYmoKNSAwIG9iajw8L1R5cGUvRm9udC9TdWJ0eXBlL1R5cGUxL0Jhc2VGb250L0hlbHZldGljYS9FbmNvZGluZy9XaW5BbnNpRW5jb2Rpbmc+PmVuZG9iago2IDAgb2JqPDwvVHlwZS9Bbm5vdC9TdWJ0eXBlL1dpZGdldC9GVC9UeC9UKG5hbWUpL1RVKEZ1bGwgbmFtZSkvRmYgMC9WKCkvUmVjdFs3MiA2NjAgMzcyIDY5MF0vREEoL0hlbHYgMTIgVGYgMCBnKS9GIDQvUCAzIDAgUi9NSzw8L0JDWzAgMCAwXS9CR1sxIDEgMV0+Pj4+ZW5kb2JqCjcgMCBvYmo8PC9UeXBlL0Fubm90L1N1YnR5cGUvV2lkZ2V0L0ZUL0J0bi9UKGFncmVlKS9UVShJIGFncmVlKS9WL09mZi9BUy9PZmYvUmVjdFs3MiA2MjAgOTIgNjQwXS9EQSgvWmFEYiAwIFRmIDAgZykvRiA0L1AgMyAwIFIvTUs8PC9CQ1swIDAgMF0vQkdbMSAxIDFdL0NBKDQpPj4vQVA8PC9OPDwvWWVzIDkgMCBSL09mZiAxMCAwIFI+Pj4+Pj5lbmRvYmoKOCAwIG9iajw8L1R5cGUvRm9udC9TdWJ0eXBlL1R5cGUxL0Jhc2VGb250L1phcGZEaW5nYmF0cz4+ZW5kb2JqCjkgMCBvYmo8PC9UeXBlL1hPYmplY3QvU3VidHlwZS9Gb3JtL0JCb3hbMCAwIDIwIDIwXS9SZXNvdXJjZXM8PC9Gb250PDwvWmFEYiA4IDAgUj4+Pj4vTGVuZ3RoIDQ2Pj5zdHJlYW0KcSBCVCAvWmFEYiAxNCBUZiAwIGcgNCA0IFRkICg0KSBUaiBFVCBRCmVuZHN0cmVhbWVuZG9iagoxMCAwIG9iajw8L1R5cGUvWE9iamVjdC9TdWJ0eXBlL0Zvcm0vQkJveFswIDAgMjAgMjBdL1Jlc291cmNlczw8Pj4vTGVuZ3RoIDg+PnN0cmVhbQpxICBRCmVuZHN0cmVhbWVuZG9iagp4cmVmCjAgMTEKMDAwMDAwMDAwMCA2NTUzNSBmIAowMDAwMDAwMDA5IDAwMDAwIG4gCjAwMDAwMDAxNjMgMDAwMDAgbiAKMDAwMDAwMDIxMiAwMDAwMCBuIAowMDAwMDAwMzU1IDAwMDAwIG4gCjAwMDAwMDA0NjUgMDAwMDAgbiAKMDAwMDAwMDU1MSAwMDAwMCBuIAowMDAwMDAwNzEyIDAwMDAwIG4gCjAwMDAwMDA5MTUgMDAwMDAgbiAKMDAwMDAwMDk3OSAwMDAwMCBuIAowMDAwMDAxMTM5IDAwMDAwIG4gCnRyYWlsZXI8PC9TaXplIDExL1Jvb3QgMSAwIFI+PgpzdGFydHhyZWYKMTI0NAolJUVPRgo="}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/pdf_redact":{"post":{"operationId":"file_convert_pdf_redact","summary":"TRUE redaction: target pages are re-rendered with the matches blacked out and REBUILT — original text/fonts/layers destroyed, then verified by re-extraction (output withheld if any remnant). Redacted pages lose selectable text. Find by 'terms' and/or explicit 'areas'. Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"file_b64":"JVBERi0xLjQKMSAwIG9iajw8L1R5cGUvQ2F0YWxvZy9QYWdlcyAyIDAgUj4+ZW5kb2JqCjIgMCBvYmo8PC9UeXBlL1BhZ2VzL0tpZHNbMyAwIFJdL0NvdW50IDE+PmVuZG9iagozIDAgb2JqPDwvVHlwZS9QYWdlL1BhcmVudCAyIDAgUi9NZWRpYUJveFswIDAgNjEyIDc5Ml0vQ29udGVudHMgNCAwIFIvUmVzb3VyY2VzPDwvRm9udDw8L0YxIDUgMCBSPj4+Pj4+ZW5kb2JqCjQgMCBvYmo8PC9MZW5ndGggNTQ+PnN0cmVhbQpCVCAvRjEgMTggVGYgNzIgNzIwIFRkIChSZWVmQVBJIGdvbGRlbiB0ZXN0IFBERikgVGogRVQKZW5kc3RyZWFtZW5kb2JqCjUgMCBvYmo8PC9UeXBlL0ZvbnQvU3VidHlwZS9UeXBlMS9CYXNlRm9udC9IZWx2ZXRpY2E+PmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1MiAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAyMTEgMDAwMDAgbiAKMDAwMDAwMDMxMCAwMDAwMCBuIAp0cmFpbGVyPDwvU2l6ZSA2L1Jvb3QgMSAwIFI+PgpzdGFydHhyZWYKMzcxCiUlRU9GCg==","terms":["golden"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/pdf_compress":{"post":{"operationId":"file_convert_pdf_compress","summary":"Shrink a PDF: stream recompression + embedded-image re-encode (level=low/balanced/strong; strong also caps image resolution). Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"file_b64":"JVBERi0xLjQKMSAwIG9iajw8L1R5cGUvQ2F0YWxvZy9QYWdlcyAyIDAgUj4+ZW5kb2JqCjIgMCBvYmo8PC9UeXBlL1BhZ2VzL0tpZHNbMyAwIFJdL0NvdW50IDE+PmVuZG9iagozIDAgb2JqPDwvVHlwZS9QYWdlL1BhcmVudCAyIDAgUi9NZWRpYUJveFswIDAgNjEyIDc5Ml0vQ29udGVudHMgNCAwIFIvUmVzb3VyY2VzPDwvRm9udDw8L0YxIDUgMCBSPj4+Pj4+ZW5kb2JqCjQgMCBvYmo8PC9MZW5ndGggNTQ+PnN0cmVhbQpCVCAvRjEgMTggVGYgNzIgNzIwIFRkIChSZWVmQVBJIGdvbGRlbiB0ZXN0IFBERikgVGogRVQKZW5kc3RyZWFtZW5kb2JqCjUgMCBvYmo8PC9UeXBlL0ZvbnQvU3VidHlwZS9UeXBlMS9CYXNlRm9udC9IZWx2ZXRpY2E+PmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1MiAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAyMTEgMDAwMDAgbiAKMDAwMDAwMDMxMCAwMDAwMCBuIAp0cmFpbGVyPDwvU2l6ZSA2L1Jvb3QgMSAwIFI+PgpzdGFydHhyZWYKMzcxCiUlRU9GCg=="}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/pdf_protect":{"post":{"operationId":"file_convert_pdf_protect","summary":"Encrypt a PDF with AES-256 (user password to open; optional owner password). Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_password":{"type":"string"}},"required":["user_password"]},"example":{"file_b64":"JVBERi0xLjQKMSAwIG9iajw8L1R5cGUvQ2F0YWxvZy9QYWdlcyAyIDAgUj4+ZW5kb2JqCjIgMCBvYmo8PC9UeXBlL1BhZ2VzL0tpZHNbMyAwIFJdL0NvdW50IDE+PmVuZG9iagozIDAgb2JqPDwvVHlwZS9QYWdlL1BhcmVudCAyIDAgUi9NZWRpYUJveFswIDAgNjEyIDc5Ml0vQ29udGVudHMgNCAwIFIvUmVzb3VyY2VzPDwvRm9udDw8L0YxIDUgMCBSPj4+Pj4+ZW5kb2JqCjQgMCBvYmo8PC9MZW5ndGggNTQ+PnN0cmVhbQpCVCAvRjEgMTggVGYgNzIgNzIwIFRkIChSZWVmQVBJIGdvbGRlbiB0ZXN0IFBERikgVGogRVQKZW5kc3RyZWFtZW5kb2JqCjUgMCBvYmo8PC9UeXBlL0ZvbnQvU3VidHlwZS9UeXBlMS9CYXNlRm9udC9IZWx2ZXRpY2E+PmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1MiAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAyMTEgMDAwMDAgbiAKMDAwMDAwMDMxMCAwMDAwMCBuIAp0cmFpbGVyPDwvU2l6ZSA2L1Jvb3QgMSAwIFI+PgpzdGFydHhyZWYKMzcxCiUlRU9GCg==","user_password":"canary123"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/pdf_unlock":{"post":{"operationId":"file_convert_pdf_unlock","summary":"Remove encryption from a PDF — REQUIRES the correct password (we never crack or bypass protection). Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"password":{"type":"string"}},"required":["password"]},"example":{"file_b64":"JVBERi0xLjQKMSAwIG9iajw8L1R5cGUvQ2F0YWxvZy9QYWdlcyAyIDAgUj4+ZW5kb2JqCjIgMCBvYmo8PC9UeXBlL1BhZ2VzL0tpZHNbMyAwIFJdL0NvdW50IDE+PmVuZG9iagozIDAgb2JqPDwvVHlwZS9QYWdlL1BhcmVudCAyIDAgUi9NZWRpYUJveFswIDAgNjEyIDc5Ml0vQ29udGVudHMgNCAwIFIvUmVzb3VyY2VzPDwvRm9udDw8L0YxIDUgMCBSPj4+Pj4+ZW5kb2JqCjQgMCBvYmo8PC9MZW5ndGggNjQ+PnN0cmVhbQrpKGDFfcWpNJhwgBvsFFzVQL9DwsFTy36zcGXftL4ci6vYoPE1iyw1XypQVtobWFkJn8eA0q4g8jlAQouAqf7mCmVuZHN0cmVhbWVuZG9iago1IDAgb2JqPDwvVHlwZS9Gb250L1N1YnR5cGUvVHlwZTEvQmFzZUZvbnQvSGVsdmV0aWNhPj5lbmRvYmoKNiAwIG9iajw8L0ZpbHRlci9TdGFuZGFyZC9WIDEvUiAyL088MjRlODI1ODljYTJhMzBiMWM4MTczZmZjY2Y0YTRmYTc2YWYyZThkMWVjZThiODJmMzY1MzBjYTllNmJmNmZiOT4vVTxhZmM4MTZlZmExYzJhYjAyMGQ4ZGYwYmZjOGY5MmM4YTM4OGIyNjZlNzk5Mzc1MTY4NmQwZjliMjIxZDQxZDI4Pi9QIC0xPj5lbmRvYmoKeHJlZgowIDcKMDAwMDAwMDAwMCA2NTUzNSBmIAowMDAwMDAwMDA5IDAwMDAwIG4gCjAwMDAwMDAwNTIgMDAwMDAgbiAKMDAwMDAwMDEwMSAwMDAwMCBuIAowMDAwMDAwMjExIDAwMDAwIG4gCjAwMDAwMDAzMjAgMDAwMDAgbiAKMDAwMDAwMDM4MSAwMDAwMCBuIAp0cmFpbGVyPDwvU2l6ZSA3L1Jvb3QgMSAwIFIvRW5jcnlwdCA2IDAgUi9JRFs8NTI2NTY1NjY0MTUwNDk2NzZmNmM2NDY1NmUzMDMwMzAzMT48NTI2NTY1NjY0MTUwNDk2NzZmNmM2NDY1NmUzMDMwMzAzMT5dPj4Kc3RhcnR4cmVmCjU2NAolJUVPRgo=","password":"reefapi"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/pdf_repair":{"post":{"operationId":"file_convert_pdf_repair","summary":"Best-effort structural repair (broken xref/trailer/stream lengths) via a tolerant qpdf parse + clean rewrite. Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"file_b64":"JVBERi0xLjQKMSAwIG9iajw8L1R5cGUvQ2F0YWxvZy9QYWdlcyAyIDAgUj4+ZW5kb2JqCjIgMCBvYmo8PC9UeXBlL1BhZ2VzL0tpZHNbMyAwIFJdL0NvdW50IDE+PmVuZG9iagozIDAgb2JqPDwvVHlwZS9QYWdlL1BhcmVudCAyIDAgUi9NZWRpYUJveFswIDAgNjEyIDc5Ml0vQ29udGVudHMgNCAwIFIvUmVzb3VyY2VzPDwvRm9udDw8L0YxIDUgMCBSPj4+Pj4+ZW5kb2JqCjQgMCBvYmo8PC9MZW5ndGggNTQ+PnN0cmVhbQpCVCAvRjEgMTggVGYgNzIgNzIwIFRkIChSZWVmQVBJIGdvbGRlbiB0ZXN0IFBERikgVGogRVQKZW5kc3RyZWFtZW5kb2JqCjUgMCBvYmo8PC9UeXBlL0ZvbnQvU3VidHlwZS9UeXBlMS9CYXNlRm9udC9IZWx2ZXRpY2E+PmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1MiAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAyMTEgMDAwMDAgbiAKMDAwMDAwMDMxMCAwMDAwMCBuIAp0cmFpbGVyPDwvU2l6ZSA2L1Jvb3QgMSAwIFI+PgpzdGFydHhyZWYKMzcxCiUlRU9GCg=="}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/image_convert":{"post":{"operationId":"file_convert_image_convert","summary":"Convert between raster formats (jpg/png/webp/tiff/bmp/gif/avif; animated gif/webp preserved where the target supports it). Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"to":{"type":"string"}},"required":["to"]},"example":{"file_b64":"iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAIAAABvFaqvAAAAH0lEQVR42mN4l+VFFcQwatCoQaMGjRo0atCoQQNvEAB6hKyuf+L5NQAAAABJRU5ErkJggg==","to":"webp"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/image_resize":{"post":{"operationId":"file_convert_image_resize","summary":"Resize with fit=contain (aspect kept, fits inside box) / cover (fills+crops) / stretch. No upscaling unless upscale=true. Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"file_b64":"iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAIAAABvFaqvAAAAH0lEQVR42mN4l+VFFcQwatCoQaMGjRo0atCoQQNvEAB6hKyuf+L5NQAAAABJRU5ErkJggg==","width":64}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/image_optimize":{"post":{"operationId":"file_convert_image_optimize","summary":"Smart perceptual compression (TinyPNG-style): binary-searches the lowest quality whose decoded result stays visually equal to the source, per a per-channel error budget (effort=low/balanced/strong). Optionally convert to webp/avif while optimizing. Never returns a bigger file. Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"file_b64":"iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAIAAABvFaqvAAAAH0lEQVR42mN4l+VFFcQwatCoQaMGjRo0atCoQQNvEAB6hKyuf+L5NQAAAABJRU5ErkJggg=="}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/image_thumbnail":{"post":{"operationId":"file_convert_image_thumbnail","summary":"Fast thumbnail (16-2048px box; square=true centre-crops to a square). Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"file_b64":"iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAIAAABvFaqvAAAAH0lEQVR42mN4l+VFFcQwatCoQaMGjRo0atCoQQNvEAB6hKyuf+L5NQAAAABJRU5ErkJggg==","size":64}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/image_metadata":{"post":{"operationId":"file_convert_image_metadata","summary":"Read image facts + EXIF (+GPS) — and with strip=true return a copy with ALL metadata removed (EXIF/GPS/XMP/ICC).","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"file_b64":"iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAIAAABvFaqvAAAAH0lEQVR42mN4l+VFFcQwatCoQaMGjRo0atCoQQNvEAB6hKyuf+L5NQAAAABJRU5ErkJggg=="}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/image_rotate":{"post":{"operationId":"file_convert_image_rotate","summary":"Rotate (90/180/270 clockwise) and/or flip (horizontal/vertical). Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"file_b64":"iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAIAAABvFaqvAAAAH0lEQVR42mN4l+VFFcQwatCoQaMGjRo0atCoQQNvEAB6hKyuf+L5NQAAAABJRU5ErkJggg==","angle":90}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/image_crop":{"post":{"operationId":"file_convert_image_crop","summary":"Crop a pixel box (x, y from top-left + width × height). Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"width":{"type":"string"},"height":{"type":"string"}},"required":["width","height"]},"example":{"file_b64":"iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAIAAABvFaqvAAAAH0lEQVR42mN4l+VFFcQwatCoQaMGjRo0atCoQQNvEAB6hKyuf+L5NQAAAABJRU5ErkJggg==","width":8,"height":8}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/doc_to_markdown":{"post":{"operationId":"file_convert_doc_to_markdown","summary":"Document → clean markdown for RAG/agents. PDF uses a layout engine (headings from font sizes, real pipe-tables, reading order); docx/pptx/xlsx/html via MarkItDown. mode=fast trades structure for speed. Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"file_b64":"PCFET0NUWVBFIGh0bWw+PGh0bWw+PGhlYWQ+PG1ldGEgY2hhcnNldD0ndXRmLTgnPjx0aXRsZT5Hb2xkZW48L3RpdGxlPjwvaGVhZD48Ym9keT48aDE+UmVlZkFQSSBnb2xkZW4gdGVzdCBwYWdlPC9oMT48cD5BIHRpbnkgZG9jdW1lbnQgZm9yIGNhbmFyeSBydW5zLjwvcD48dGFibGU+PHRyPjx0aD5lbmdpbmU8L3RoPjx0aD50aWVyPC90aD48L3RyPjx0cj48dGQ+ZmlsZS1jb252ZXJ0PC90ZD48dGQ+dXRpbGl0aWVzPC90ZD48L3RyPjx0cj48dGQ+d2ViLWV4dHJhY3Q8L3RkPjx0ZD5kYXRhPC90ZD48L3RyPjwvdGFibGU+PC9ib2R5PjwvaHRtbD4="}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/extract_tables":{"post":{"operationId":"file_convert_extract_tables","summary":"Pull every table out of a PDF / xlsx / docx / html as JSON rows (+optional CSV files). Max 50 tables.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"file_b64":"PCFET0NUWVBFIGh0bWw+PGh0bWw+PGhlYWQ+PG1ldGEgY2hhcnNldD0ndXRmLTgnPjx0aXRsZT5Hb2xkZW48L3RpdGxlPjwvaGVhZD48Ym9keT48aDE+UmVlZkFQSSBnb2xkZW4gdGVzdCBwYWdlPC9oMT48cD5BIHRpbnkgZG9jdW1lbnQgZm9yIGNhbmFyeSBydW5zLjwvcD48dGFibGU+PHRyPjx0aD5lbmdpbmU8L3RoPjx0aD50aWVyPC90aD48L3RyPjx0cj48dGQ+ZmlsZS1jb252ZXJ0PC90ZD48dGQ+dXRpbGl0aWVzPC90ZD48L3RyPjx0cj48dGQ+d2ViLWV4dHJhY3Q8L3RkPjx0ZD5kYXRhPC90ZD48L3RyPjwvdGFibGU+PC9ib2R5PjwvaHRtbD4="}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/ocr_image":{"post":{"operationId":"file_convert_ocr_image","summary":"OCR an image → text + word count + confidence (tesseract 5, printed text; languages: eng/deu/fra/spa/tur, combinable).","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"file_b64":"iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAIAAABvFaqvAAAAH0lEQVR42mN4l+VFFcQwatCoQaMGjRo0atCoQQNvEAB6hKyuf+L5NQAAAABJRU5ErkJggg=="}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/ocr_pdf":{"post":{"operationId":"file_convert_ocr_pdf","summary":"OCR a scanned PDF: output=text → per-page text+confidence; output=searchable_pdf → image+invisible-text-layer PDF. OCR-light: max 10 pages per call (use 'pages' to window). Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"file_b64":"JVBERi0xLjQKMSAwIG9iajw8L1R5cGUvQ2F0YWxvZy9QYWdlcyAyIDAgUj4+ZW5kb2JqCjIgMCBvYmo8PC9UeXBlL1BhZ2VzL0tpZHNbMyAwIFJdL0NvdW50IDE+PmVuZG9iagozIDAgb2JqPDwvVHlwZS9QYWdlL1BhcmVudCAyIDAgUi9NZWRpYUJveFswIDAgNjEyIDc5Ml0vQ29udGVudHMgNCAwIFIvUmVzb3VyY2VzPDwvRm9udDw8L0YxIDUgMCBSPj4+Pj4+ZW5kb2JqCjQgMCBvYmo8PC9MZW5ndGggNTQ+PnN0cmVhbQpCVCAvRjEgMTggVGYgNzIgNzIwIFRkIChSZWVmQVBJIGdvbGRlbiB0ZXN0IFBERikgVGogRVQKZW5kc3RyZWFtZW5kb2JqCjUgMCBvYmo8PC9UeXBlL0ZvbnQvU3VidHlwZS9UeXBlMS9CYXNlRm9udC9IZWx2ZXRpY2E+PmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1MiAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAyMTEgMDAwMDAgbiAKMDAwMDAwMDMxMCAwMDAwMCBuIAp0cmFpbGVyPDwvU2l6ZSA2L1Jvb3QgMSAwIFI+PgpzdGFydHhyZWYKMzcxCiUlRU9GCg==","pages":"1"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/office_convert":{"post":{"operationId":"file_convert_office_convert","summary":"Office → PDF (and html/txt; spreadsheets also → csv; text docs also → docx) via LibreOffice headless — docx/doc/odt/rtf/pptx/ppt/odp/xlsx/xls/ods/html/markdown/txt/csv in. Fonts: Noto (CJK/RTL) + Liberation (Arial/Times metrics). Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"file_b64":"PCFET0NUWVBFIGh0bWw+PGh0bWw+PGhlYWQ+PG1ldGEgY2hhcnNldD0ndXRmLTgnPjx0aXRsZT5Hb2xkZW48L3RpdGxlPjwvaGVhZD48Ym9keT48aDE+UmVlZkFQSSBnb2xkZW4gdGVzdCBwYWdlPC9oMT48cD5BIHRpbnkgZG9jdW1lbnQgZm9yIGNhbmFyeSBydW5zLjwvcD48dGFibGU+PHRyPjx0aD5lbmdpbmU8L3RoPjx0aD50aWVyPC90aD48L3RyPjx0cj48dGQ+ZmlsZS1jb252ZXJ0PC90ZD48dGQ+dXRpbGl0aWVzPC90ZD48L3RyPjx0cj48dGQ+d2ViLWV4dHJhY3Q8L3RkPjx0ZD5kYXRhPC90ZD48L3RyPjwvdGFibGU+PC9ib2R5PjwvaHRtbD4=","to":"pdf"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/audio_extract":{"post":{"operationId":"file_convert_audio_extract","summary":"Extract the audio track from a video (mp4/webm/mkv/avi) → mp3 (default) / m4a / wav / flac / ogg / opus. Stream-copies losslessly when the codec already matches the target. NOT a video transcoder (phase-2). Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/audio_convert":{"post":{"operationId":"file_convert_audio_convert","summary":"Convert between audio formats (mp3/wav/flac/ogg/m4a in → mp3/m4a/wav/flac/ogg/opus out; ffmpeg LGPL build). Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"to":{"type":"string"}},"required":["to"]},"example":{"file_b64":"UklGRsQPAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YaAPAAAAAOAP4R1YKAsuTC4TKf8eQRF4AYTxRuNt2EHSf9E81urfY+0P/RMNjRvEJmYtqi5pKiUh9RNpBFj0p+UU2v3SONH71NXdueoh+jkKHRkJJZQs2i6VKykjlRZVBzj3JOji2+bTINHm0+LbJOg491UHlRYpI5Ur2i6ULAklHRk5CiH6uerV3fvUONH90hTap+VY9GkE9RMlIWkqqi5mLcQmjRsTDQ/9Y+3q3zzWf9FB0m3YRuOE8XgBQRH/HhMpTC4LLlgo4R3gDwAAIPAf4qjX9dG00e3WAeG/7oj+fA66HJMnvy2BLsQpFiCdEvEC7fJz5DzZmtJW0ZfV294L7Jf7qAtZGuwlAy3ILgUrKyJHFd8Fx/Xj5vfabNMm0WvU19xr6av4yAjcFx4kGizgLhosHiTcF8gIq/hr6dfca9Qm0WzT99rj5sf13wVHFSsiBSvILgMt7CVZGqgLl/sL7Nvel9VW0ZrSPNlz5O3y8QKdEhYgxCmBLr8tkye6HHwOiP6/7gHh7da00fXRqNcf4iDwAADgD+EdWCgLLkwuEyn/HkEReAGE8UbjbdhB0n/RPNbq32PtD/0TDY0bxCZmLaouaSolIfUTaQRY9KflFNr90jjR+9TV3bnqIfo5Ch0ZCSWULNoulSspI5UWVQc49yTo4tvm0yDR5tPi2yToOPdVB5UWKSOVK9oulCwJJR0ZOQoh+rnq1d371DjR/dIU2qflWPRpBPUTJSFpKqouZi3EJo0bEw0P/WPt6t881n/RQdJt2EbjhPF4AUER/x4TKUwuCy5YKOEd4A8AACDwH+Ko1/XRtNHt1gHhv+6I/nwOuhyTJ78tgS7EKRYgnRLxAu3yc+Q82ZrSVtGX1dveC+yX+6gLWRrsJQMtyC4FKysiRxXfBcf14+b32mzTJtFr1Nfca+mr+MgI3BceJBos4C4aLB4k3BfICKv4a+nX3GvUJtFs0/fa4+bH9d8FRxUrIgUryC4DLewlWRqoC5f7C+zb3pfVVtGa0jzZc+Tt8vECnRIWIMQpgS6/LZMnuhx8Doj+v+4B4e3WtNH10ajXH+Ig8AAA4A/hHVgoCy5MLhMp/x5BEXgBhPFG423YQdJ/0TzW6t9j7Q/9Ew2NG8QmZi2qLmkqJSH1E2kEWPSn5RTa/dI40fvU1d256iH6OQodGQkllCzaLpUrKSOVFlUHOPck6OLb5tMg0ebT4tsk6Dj3VQeVFikjlSvaLpQsCSUdGTkKIfq56tXd+9Q40f3SFNqn5Vj0aQT1EyUhaSqqLmYtxCaNGxMND/1j7erfPNZ/0UHSbdhG44TxeAFBEf8eEylMLgsuWCjhHeAPAAAg8B/iqNf10bTR7dYB4b/uiP58Drockye/LYEuxCkWIJ0S8QLt8nPkPNma0lbRl9Xb3gvsl/uoC1ka7CUDLcguBSsrIkcV3wXH9ePm99ps0ybRa9TX3Gvpq/jICNwXHiQaLOAuGiweJNwXyAir+Gvp19xr1CbRbNP32uPmx/XfBUcVKyIFK8guAy3sJVkaqAuX+wvs296X1VbRmtI82XPk7fLxAp0SFiDEKYEuvy2TJ7ocfA6I/r/uAeHt1rTR9dGo1x/iIPAAAOAP4R1YKAsuTC4TKf8eQRF4AYTxRuNt2EHSf9E81urfY+0P/RMNjRvEJmYtqi5pKiUh9RNpBFj0p+UU2v3SONH71NXdueoh+jkKHRkJJZQs2i6VKykjlRZVBzj3JOji2+bTINHm0+LbJOg491UHlRYpI5Ur2i6ULAklHRk5CiH6uerV3fvUONH90hTap+VY9GkE9RMlIWkqqi5mLcQmjRsTDQ/9Y+3q3zzWf9FB0m3YRuOE8XgBQRH/HhMpTC4LLlgo4R3gDwAAIPAf4qjX9dG00e3WAeG/7oj+fA66HJMnvy2BLsQpFiCdEvEC7fJz5DzZmtJW0ZfV294L7Jf7qAtZGuwlAy3ILgUrKyJHFd8Fx/Xj5vfabNMm0WvU19xr6av4yAjcFx4kGizgLhosHiTcF8gIq/hr6dfca9Qm0WzT99rj5sf13wVHFSsiBSvILgMt7CVZGqgLl/sL7Nvel9VW0ZrSPNlz5O3y8QKdEhYgxCmBLr8tkye6HHwOiP6/7gHh7da00fXRqNcf4iDwAADgD+EdWCgLLkwuEyn/HkEReAGE8UbjbdhB0n/RPNbq32PtD/0TDY0bxCZmLaouaSolIfUTaQRY9KflFNr90jjR+9TV3bnqIfo5Ch0ZCSWULNoulSspI5UWVQc49yTo4tvm0yDR5tPi2yToOPdVB5UWKSOVK9oulCwJJR0ZOQoh+rnq1d371DjR/dIU2qflWPRpBPUTJSFpKqouZi3EJo0bEw0P/WPt6t881n/RQdJt2EbjhPF4AUER/x4TKUwuCy5YKOEd4A8AACDwH+Ko1/XRtNHt1gHhv+6I/nwOuhyTJ78tgS7EKRYgnRLxAu3yc+Q82ZrSVtGX1dveC+yX+6gLWRrsJQMtyC4FKysiRxXfBcf14+b32mzTJtFr1Nfca+mr+MgI3BceJBos4C4aLB4k3BfICKv4a+nX3GvUJtFs0/fa4+bH9d8FRxUrIgUryC4DLewlWRqoC5f7C+zb3pfVVtGa0jzZc+Tt8vECnRIWIMQpgS6/LZMnuhx8Doj+v+4B4e3WtNH10ajXH+Ig8AAA4A/hHVgoCy5MLhMp/x5BEXgBhPFG423YQdJ/0TzW6t9j7Q/9Ew2NG8QmZi2qLmkqJSH1E2kEWPSn5RTa/dI40fvU1d256iH6OQodGQkllCzaLpUrKSOVFlUHOPck6OLb5tMg0ebT4tsk6Dj3VQeVFikjlSvaLpQsCSUdGTkKIfq56tXd+9Q40f3SFNqn5Vj0aQT1EyUhaSqqLmYtxCaNGxMND/1j7erfPNZ/0UHSbdhG44TxeAFBEf8eEylMLgsuWCjhHeAPAAAg8B/iqNf10bTR7dYB4b/uiP58Drockye/LYEuxCkWIJ0S8QLt8nPkPNma0lbRl9Xb3gvsl/uoC1ka7CUDLcguBSsrIkcV3wXH9ePm99ps0ybRa9TX3Gvpq/jICNwXHiQaLOAuGiweJNwXyAir+Gvp19xr1CbRbNP32uPmx/XfBUcVKyIFK8guAy3sJVkaqAuX+wvs296X1VbRmtI82XPk7fLxAp0SFiDEKYEuvy2TJ7ocfA6I/r/uAeHt1rTR9dGo1x/iIPAAAOAP4R1YKAsuTC4TKf8eQRF4AYTxRuNt2EHSf9E81urfY+0P/RMNjRvEJmYtqi5pKiUh9RNpBFj0p+UU2v3SONH71NXdueoh+jkKHRkJJZQs2i6VKykjlRZVBzj3JOji2+bTINHm0+LbJOg491UHlRYpI5Ur2i6ULAklHRk5CiH6uerV3fvUONH90hTap+VY9GkE9RMlIWkqqi5mLcQmjRsTDQ/9Y+3q3zzWf9FB0m3YRuOE8XgBQRH/HhMpTC4LLlgo4R3gDwAAIPAf4qjX9dG00e3WAeG/7oj+fA66HJMnvy2BLsQpFiCdEvEC7fJz5DzZmtJW0ZfV294L7Jf7qAtZGuwlAy3ILgUrKyJHFd8Fx/Xj5vfabNMm0WvU19xr6av4yAjcFx4kGizgLhosHiTcF8gIq/hr6dfca9Qm0WzT99rj5sf13wVHFSsiBSvILgMt7CVZGqgLl/sL7Nvel9VW0ZrSPNlz5O3y8QKdEhYgxCmBLr8tkye6HHwOiP6/7gHh7da00fXRqNcf4iDwAADgD+EdWCgLLkwuEyn/HkEReAGE8UbjbdhB0n/RPNbq32PtD/0TDY0bxCZmLaouaSolIfUTaQRY9KflFNr90jjR+9TV3bnqIfo5Ch0ZCSWULNoulSspI5UWVQc49yTo4tvm0yDR5tPi2yToOPdVB5UWKSOVK9oulCwJJR0ZOQoh+rnq1d371DjR/dIU2qflWPRpBPUTJSFpKqouZi3EJo0bEw0P/WPt6t881n/RQdJt2EbjhPF4AUER/x4TKUwuCy5YKOEd4A8AACDwH+Ko1/XRtNHt1gHhv+6I/nwOuhyTJ78tgS7EKRYgnRLxAu3yc+Q82ZrSVtGX1dveC+yX+6gLWRrsJQMtyC4FKysiRxXfBcf14+b32mzTJtFr1Nfca+mr+MgI3BceJBos4C4aLB4k3BfICKv4a+nX3GvUJtFs0/fa4+bH9d8FRxUrIgUryC4DLewlWRqoC5f7C+zb3pfVVtGa0jzZc+Tt8vECnRIWIMQpgS6/LZMnuhx8Doj+v+4B4e3WtNH10ajXH+Ig8AAA4A/hHVgoCy5MLhMp/x5BEXgBhPFG423YQdJ/0TzW6t9j7Q/9Ew2NG8QmZi2qLmkqJSH1E2kEWPSn5RTa/dI40fvU1d256iH6OQodGQkllCzaLpUrKSOVFlUHOPck6OLb5tMg0ebT4tsk6Dj3VQeVFikjlSvaLpQsCSUdGTkKIfq56tXd+9Q40f3SFNqn5Vj0aQT1EyUhaSqqLmYtxCaNGxMND/1j7erfPNZ/0UHSbdhG44TxeAFBEf8eEylMLgsuWCjhHeAPAAAg8B/iqNf10bTR7dYB4b/uiP58Drockye/LYEuxCkWIJ0S8QLt8nPkPNma0lbRl9Xb3gvsl/uoC1ka7CUDLcguBSsrIkcV3wXH9ePm99ps0ybRa9TX3Gvpq/jICNwXHiQaLOAuGiweJNwXyAir+Gvp19xr1CbRbNP32uPmx/XfBUcVKyIFK8guAy3sJVkaqAuX+wvs296X1VbRmtI82XPk7fLxAp0SFiDEKYEuvy2TJ7ocfA6I/r/uAeHt1rTR9dGo1x/iIPAAAOAP4R1YKAsuTC4TKf8eQRF4AYTxRuNt2EHSf9E81urfY+0P/RMNjRvEJmYtqi5pKiUh9RNpBFj0p+UU2v3SONH71NXdueoh+jkKHRkJJZQs2i6VKykjlRZVBzj3JOji2+bTINHm0+LbJOg491UHlRYpI5Ur2i6ULAklHRk5CiH6uerV3fvUONH90hTap+VY9GkE9RMlIWkqqi5mLcQmjRsTDQ/9Y+3q3zzWf9FB0m3YRuOE8XgBQRH/HhMpTC4LLlgo4R3gDwAAIPAf4qjX9dG00e3WAeG/7oj+fA66HJMnvy2BLsQpFiCdEvEC7fJz5DzZmtJW0ZfV294L7Jf7qAtZGuwlAy3ILgUrKyJHFd8Fx/Xj5vfabNMm0WvU19xr6av4yAjcFx4kGizgLhosHiTcF8gIq/hr6dfca9Qm0WzT99rj5sf13wVHFSsiBSvILgMt7CVZGqgLl/sL7Nvel9VW0ZrSPNlz5O3y8QKdEhYgxCmBLr8tkye6HHwOiP6/7gHh7da00fXRqNcf4iDw","to":"mp3"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/media_probe":{"post":{"operationId":"file_convert_media_probe","summary":"ffprobe metadata for any audio/video file: container, duration, bitrate, per-stream codec/sample-rate/resolution, curated tags.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{"file_b64":"UklGRsQPAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YaAPAAAAAOAP4R1YKAsuTC4TKf8eQRF4AYTxRuNt2EHSf9E81urfY+0P/RMNjRvEJmYtqi5pKiUh9RNpBFj0p+UU2v3SONH71NXdueoh+jkKHRkJJZQs2i6VKykjlRZVBzj3JOji2+bTINHm0+LbJOg491UHlRYpI5Ur2i6ULAklHRk5CiH6uerV3fvUONH90hTap+VY9GkE9RMlIWkqqi5mLcQmjRsTDQ/9Y+3q3zzWf9FB0m3YRuOE8XgBQRH/HhMpTC4LLlgo4R3gDwAAIPAf4qjX9dG00e3WAeG/7oj+fA66HJMnvy2BLsQpFiCdEvEC7fJz5DzZmtJW0ZfV294L7Jf7qAtZGuwlAy3ILgUrKyJHFd8Fx/Xj5vfabNMm0WvU19xr6av4yAjcFx4kGizgLhosHiTcF8gIq/hr6dfca9Qm0WzT99rj5sf13wVHFSsiBSvILgMt7CVZGqgLl/sL7Nvel9VW0ZrSPNlz5O3y8QKdEhYgxCmBLr8tkye6HHwOiP6/7gHh7da00fXRqNcf4iDwAADgD+EdWCgLLkwuEyn/HkEReAGE8UbjbdhB0n/RPNbq32PtD/0TDY0bxCZmLaouaSolIfUTaQRY9KflFNr90jjR+9TV3bnqIfo5Ch0ZCSWULNoulSspI5UWVQc49yTo4tvm0yDR5tPi2yToOPdVB5UWKSOVK9oulCwJJR0ZOQoh+rnq1d371DjR/dIU2qflWPRpBPUTJSFpKqouZi3EJo0bEw0P/WPt6t881n/RQdJt2EbjhPF4AUER/x4TKUwuCy5YKOEd4A8AACDwH+Ko1/XRtNHt1gHhv+6I/nwOuhyTJ78tgS7EKRYgnRLxAu3yc+Q82ZrSVtGX1dveC+yX+6gLWRrsJQMtyC4FKysiRxXfBcf14+b32mzTJtFr1Nfca+mr+MgI3BceJBos4C4aLB4k3BfICKv4a+nX3GvUJtFs0/fa4+bH9d8FRxUrIgUryC4DLewlWRqoC5f7C+zb3pfVVtGa0jzZc+Tt8vECnRIWIMQpgS6/LZMnuhx8Doj+v+4B4e3WtNH10ajXH+Ig8AAA4A/hHVgoCy5MLhMp/x5BEXgBhPFG423YQdJ/0TzW6t9j7Q/9Ew2NG8QmZi2qLmkqJSH1E2kEWPSn5RTa/dI40fvU1d256iH6OQodGQkllCzaLpUrKSOVFlUHOPck6OLb5tMg0ebT4tsk6Dj3VQeVFikjlSvaLpQsCSUdGTkKIfq56tXd+9Q40f3SFNqn5Vj0aQT1EyUhaSqqLmYtxCaNGxMND/1j7erfPNZ/0UHSbdhG44TxeAFBEf8eEylMLgsuWCjhHeAPAAAg8B/iqNf10bTR7dYB4b/uiP58Drockye/LYEuxCkWIJ0S8QLt8nPkPNma0lbRl9Xb3gvsl/uoC1ka7CUDLcguBSsrIkcV3wXH9ePm99ps0ybRa9TX3Gvpq/jICNwXHiQaLOAuGiweJNwXyAir+Gvp19xr1CbRbNP32uPmx/XfBUcVKyIFK8guAy3sJVkaqAuX+wvs296X1VbRmtI82XPk7fLxAp0SFiDEKYEuvy2TJ7ocfA6I/r/uAeHt1rTR9dGo1x/iIPAAAOAP4R1YKAsuTC4TKf8eQRF4AYTxRuNt2EHSf9E81urfY+0P/RMNjRvEJmYtqi5pKiUh9RNpBFj0p+UU2v3SONH71NXdueoh+jkKHRkJJZQs2i6VKykjlRZVBzj3JOji2+bTINHm0+LbJOg491UHlRYpI5Ur2i6ULAklHRk5CiH6uerV3fvUONH90hTap+VY9GkE9RMlIWkqqi5mLcQmjRsTDQ/9Y+3q3zzWf9FB0m3YRuOE8XgBQRH/HhMpTC4LLlgo4R3gDwAAIPAf4qjX9dG00e3WAeG/7oj+fA66HJMnvy2BLsQpFiCdEvEC7fJz5DzZmtJW0ZfV294L7Jf7qAtZGuwlAy3ILgUrKyJHFd8Fx/Xj5vfabNMm0WvU19xr6av4yAjcFx4kGizgLhosHiTcF8gIq/hr6dfca9Qm0WzT99rj5sf13wVHFSsiBSvILgMt7CVZGqgLl/sL7Nvel9VW0ZrSPNlz5O3y8QKdEhYgxCmBLr8tkye6HHwOiP6/7gHh7da00fXRqNcf4iDwAADgD+EdWCgLLkwuEyn/HkEReAGE8UbjbdhB0n/RPNbq32PtD/0TDY0bxCZmLaouaSolIfUTaQRY9KflFNr90jjR+9TV3bnqIfo5Ch0ZCSWULNoulSspI5UWVQc49yTo4tvm0yDR5tPi2yToOPdVB5UWKSOVK9oulCwJJR0ZOQoh+rnq1d371DjR/dIU2qflWPRpBPUTJSFpKqouZi3EJo0bEw0P/WPt6t881n/RQdJt2EbjhPF4AUER/x4TKUwuCy5YKOEd4A8AACDwH+Ko1/XRtNHt1gHhv+6I/nwOuhyTJ78tgS7EKRYgnRLxAu3yc+Q82ZrSVtGX1dveC+yX+6gLWRrsJQMtyC4FKysiRxXfBcf14+b32mzTJtFr1Nfca+mr+MgI3BceJBos4C4aLB4k3BfICKv4a+nX3GvUJtFs0/fa4+bH9d8FRxUrIgUryC4DLewlWRqoC5f7C+zb3pfVVtGa0jzZc+Tt8vECnRIWIMQpgS6/LZMnuhx8Doj+v+4B4e3WtNH10ajXH+Ig8AAA4A/hHVgoCy5MLhMp/x5BEXgBhPFG423YQdJ/0TzW6t9j7Q/9Ew2NG8QmZi2qLmkqJSH1E2kEWPSn5RTa/dI40fvU1d256iH6OQodGQkllCzaLpUrKSOVFlUHOPck6OLb5tMg0ebT4tsk6Dj3VQeVFikjlSvaLpQsCSUdGTkKIfq56tXd+9Q40f3SFNqn5Vj0aQT1EyUhaSqqLmYtxCaNGxMND/1j7erfPNZ/0UHSbdhG44TxeAFBEf8eEylMLgsuWCjhHeAPAAAg8B/iqNf10bTR7dYB4b/uiP58Drockye/LYEuxCkWIJ0S8QLt8nPkPNma0lbRl9Xb3gvsl/uoC1ka7CUDLcguBSsrIkcV3wXH9ePm99ps0ybRa9TX3Gvpq/jICNwXHiQaLOAuGiweJNwXyAir+Gvp19xr1CbRbNP32uPmx/XfBUcVKyIFK8guAy3sJVkaqAuX+wvs296X1VbRmtI82XPk7fLxAp0SFiDEKYEuvy2TJ7ocfA6I/r/uAeHt1rTR9dGo1x/iIPAAAOAP4R1YKAsuTC4TKf8eQRF4AYTxRuNt2EHSf9E81urfY+0P/RMNjRvEJmYtqi5pKiUh9RNpBFj0p+UU2v3SONH71NXdueoh+jkKHRkJJZQs2i6VKykjlRZVBzj3JOji2+bTINHm0+LbJOg491UHlRYpI5Ur2i6ULAklHRk5CiH6uerV3fvUONH90hTap+VY9GkE9RMlIWkqqi5mLcQmjRsTDQ/9Y+3q3zzWf9FB0m3YRuOE8XgBQRH/HhMpTC4LLlgo4R3gDwAAIPAf4qjX9dG00e3WAeG/7oj+fA66HJMnvy2BLsQpFiCdEvEC7fJz5DzZmtJW0ZfV294L7Jf7qAtZGuwlAy3ILgUrKyJHFd8Fx/Xj5vfabNMm0WvU19xr6av4yAjcFx4kGizgLhosHiTcF8gIq/hr6dfca9Qm0WzT99rj5sf13wVHFSsiBSvILgMt7CVZGqgLl/sL7Nvel9VW0ZrSPNlz5O3y8QKdEhYgxCmBLr8tkye6HHwOiP6/7gHh7da00fXRqNcf4iDwAADgD+EdWCgLLkwuEyn/HkEReAGE8UbjbdhB0n/RPNbq32PtD/0TDY0bxCZmLaouaSolIfUTaQRY9KflFNr90jjR+9TV3bnqIfo5Ch0ZCSWULNoulSspI5UWVQc49yTo4tvm0yDR5tPi2yToOPdVB5UWKSOVK9oulCwJJR0ZOQoh+rnq1d371DjR/dIU2qflWPRpBPUTJSFpKqouZi3EJo0bEw0P/WPt6t881n/RQdJt2EbjhPF4AUER/x4TKUwuCy5YKOEd4A8AACDwH+Ko1/XRtNHt1gHhv+6I/nwOuhyTJ78tgS7EKRYgnRLxAu3yc+Q82ZrSVtGX1dveC+yX+6gLWRrsJQMtyC4FKysiRxXfBcf14+b32mzTJtFr1Nfca+mr+MgI3BceJBos4C4aLB4k3BfICKv4a+nX3GvUJtFs0/fa4+bH9d8FRxUrIgUryC4DLewlWRqoC5f7C+zb3pfVVtGa0jzZc+Tt8vECnRIWIMQpgS6/LZMnuhx8Doj+v+4B4e3WtNH10ajXH+Ig8AAA4A/hHVgoCy5MLhMp/x5BEXgBhPFG423YQdJ/0TzW6t9j7Q/9Ew2NG8QmZi2qLmkqJSH1E2kEWPSn5RTa/dI40fvU1d256iH6OQodGQkllCzaLpUrKSOVFlUHOPck6OLb5tMg0ebT4tsk6Dj3VQeVFikjlSvaLpQsCSUdGTkKIfq56tXd+9Q40f3SFNqn5Vj0aQT1EyUhaSqqLmYtxCaNGxMND/1j7erfPNZ/0UHSbdhG44TxeAFBEf8eEylMLgsuWCjhHeAPAAAg8B/iqNf10bTR7dYB4b/uiP58Drockye/LYEuxCkWIJ0S8QLt8nPkPNma0lbRl9Xb3gvsl/uoC1ka7CUDLcguBSsrIkcV3wXH9ePm99ps0ybRa9TX3Gvpq/jICNwXHiQaLOAuGiweJNwXyAir+Gvp19xr1CbRbNP32uPmx/XfBUcVKyIFK8guAy3sJVkaqAuX+wvs296X1VbRmtI82XPk7fLxAp0SFiDEKYEuvy2TJ7ocfA6I/r/uAeHt1rTR9dGo1x/iIPAAAOAP4R1YKAsuTC4TKf8eQRF4AYTxRuNt2EHSf9E81urfY+0P/RMNjRvEJmYtqi5pKiUh9RNpBFj0p+UU2v3SONH71NXdueoh+jkKHRkJJZQs2i6VKykjlRZVBzj3JOji2+bTINHm0+LbJOg491UHlRYpI5Ur2i6ULAklHRk5CiH6uerV3fvUONH90hTap+VY9GkE9RMlIWkqqi5mLcQmjRsTDQ/9Y+3q3zzWf9FB0m3YRuOE8XgBQRH/HhMpTC4LLlgo4R3gDwAAIPAf4qjX9dG00e3WAeG/7oj+fA66HJMnvy2BLsQpFiCdEvEC7fJz5DzZmtJW0ZfV294L7Jf7qAtZGuwlAy3ILgUrKyJHFd8Fx/Xj5vfabNMm0WvU19xr6av4yAjcFx4kGizgLhosHiTcF8gIq/hr6dfca9Qm0WzT99rj5sf13wVHFSsiBSvILgMt7CVZGqgLl/sL7Nvel9VW0ZrSPNlz5O3y8QKdEhYgxCmBLr8tkye6HHwOiP6/7gHh7da00fXRqNcf4iDw"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/data_convert":{"post":{"operationId":"file_convert_data_convert","summary":"Deterministic data-format conversion: CSV ↔ JSON ↔ XML ↔ YAML ↔ Excel(xlsx) (any direction; tabular targets need tabular-shaped input — clean error otherwise). 200k-row cap. Output delivery: each produced file ≤10MB comes inline as base64 (files[].file_b64); 10-50MB comes as a one-time download token (files[].download_path, 30min TTL); >50MB total is rejected.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"to":{"type":"string"}},"required":["to"]},"example":{"file_b64":"bmFtZSxjcmVkaXRzLGNhdGVnb3J5CnBkZl9tZXJnZSwxLHBkZgppbWFnZV9vcHRpbWl6ZSwyLGltYWdlCm9jcl9wZGYsMixvY3IK","to":"json"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/file-convert/v1/formats":{"post":{"operationId":"file_convert_formats","summary":"Capability matrix: every action with its accepted input formats, targets and caps — machine-readable (the Zamzar /formats equivalent).","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/quote":{"post":{"operationId":"finance_quote","summary":"single or multi-symbol quote","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"symbols":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/chart":{"post":{"operationId":"finance_chart","summary":"OHLCV chart data","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"range":{"type":"string"},"interval":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/search":{"post":{"operationId":"finance_search","summary":"symbol search","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"quotesCount":{"type":"string"}},"required":["query"]},"example":{"query":"apple"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/fundamentals":{"post":{"operationId":"finance_fundamentals","summary":"quoteSummary modules","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"modules":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/analyst":{"post":{"operationId":"finance_analyst","summary":"recommendations, upgrades/downgrades, price targets","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/holders":{"post":{"operationId":"finance_holders","summary":"insider/institution/fund ownership and holder activity","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/news":{"post":{"operationId":"finance_news","summary":"Yahoo Finance news search","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"count":{"type":"string"},"symbol":{"type":"string"}},"required":["query"]},"example":{"query":"apple"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/options":{"post":{"operationId":"finance_options","summary":"option chain","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"date":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/calendar":{"post":{"operationId":"finance_calendar","summary":"earnings/calendar quoteSummary modules","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/events":{"post":{"operationId":"finance_events","summary":"dividends and splits from chart events","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/screener_predefined":{"post":{"operationId":"finance_screener_predefined","summary":"Yahoo saved screeners","tags":["Finance & Data"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"scrIds":{"type":"string"},"count":{"type":"string"},"start":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/screener":{"post":{"operationId":"finance_screener","summary":"Yahoo custom screener POST","tags":["Finance & Data"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"criteria":{"type":"string"},"size":{"type":"string"},"offset":{"type":"string"},"sortField":{"type":"string"},"sortType":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/market_summary":{"post":{"operationId":"finance_market_summary","summary":"market summary indices","tags":["Finance & Data"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/trending":{"post":{"operationId":"finance_trending","summary":"trending symbols","tags":["Finance & Data"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"string"},"count":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/lookup":{"post":{"operationId":"finance_lookup","summary":"Yahoo symbol universe lookup","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"count":{"type":"string"}},"required":["query"]},"example":{"query":"apple"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/technicals":{"post":{"operationId":"finance_technicals","summary":"local technical indicators from chart OHLCV","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"range":{"type":"string"},"interval":{"type":"string"},"periods":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL","range":"6mo","interval":"1d"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/economic":{"post":{"operationId":"finance_economic","summary":"FRED economic series via official API","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"type":"string"},"fred_api_key":{"type":"string"},"limit":{"type":"string"},"sort_order":{"type":"string"}},"required":["series","fred_api_key"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/market/tickers":{"post":{"operationId":"finance_v1_market_tickers","summary":"public NASDAQ/NYSE/AMEX ticker universe","tags":["Finance & Data"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"string"}}},"example":{"limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/search":{"post":{"operationId":"finance_v1_search","summary":"RapidAPI-compatible alias for search","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"example":{"query":"apple"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/market/quotes":{"post":{"operationId":"finance_v1_market_quotes","summary":"RapidAPI-compatible alias for quote","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"symbols":{"type":"string"}},"required":["symbol"]},"example":{"symbols":["AAPL","MSFT"],"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/stock/history":{"post":{"operationId":"finance_v1_stock_history","summary":"RapidAPI-compatible alias for chart","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL","range":"1mo","interval":"1d"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v2/stock/history":{"post":{"operationId":"finance_v2_stock_history","summary":"RapidAPI-compatible alias for chart","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL","range":"1mo","interval":"1d"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/market/screener":{"post":{"operationId":"finance_v1_market_screener","summary":"RapidAPI-compatible alias for screener","tags":["Finance & Data"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"criteria":{"type":"string"},"scrIds":{"type":"string"}}},"example":{"scrIds":"most_actives","count":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/stock/modules":{"post":{"operationId":"finance_v1_stock_modules","summary":"RapidAPI-compatible alias for quoteSummary modules","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/market/news":{"post":{"operationId":"finance_v1_market_news","summary":"RapidAPI-compatible alias for news","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"symbol":{"type":"string"}},"required":["query"]},"example":{"symbol":"AAPL","count":5,"query":"apple"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v2/market/news":{"post":{"operationId":"finance_v2_market_news","summary":"RapidAPI-compatible alias for news","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"symbol":{"type":"string"}},"required":["query"]},"example":{"symbol":"AAPL","count":5,"query":"apple"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/options":{"post":{"operationId":"finance_v1_options","summary":"RapidAPI-compatible alias for options","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/most-active":{"post":{"operationId":"finance_v1_most_active","summary":"options most-active contracts derived from Yahoo option chains","tags":["Finance & Data"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"symbols":{"type":"string"},"count":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/unusual-options-activity":{"post":{"operationId":"finance_v1_unusual_options_activity","summary":"unusual options activity derived from Yahoo option chain volume/open-interest","tags":["Finance & Data"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"symbols":{"type":"string"},"count":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/calendar/earnings":{"post":{"operationId":"finance_calendar_earnings","summary":"symbol earnings calendar via quoteSummary","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/calendar/earnings_market":{"post":{"operationId":"finance_calendar_earnings_market","summary":"market-wide upcoming earnings calendar (all symbols) via Yahoo visualization","tags":["Finance & Data"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"start":{"type":"string"},"end":{"type":"string"},"date":{"type":"string"},"count":{"type":"string"},"offset":{"type":"string"},"region":{"type":"string"},"lang":{"type":"string"}}},"example":{"count":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/calendar/dividends":{"post":{"operationId":"finance_calendar_dividends","summary":"symbol dividends via chart events","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/calendar/economic_events":{"post":{"operationId":"finance_calendar_economic_events","summary":"global economic events via Yahoo visualization calendar","tags":["Finance & Data"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"start":{"type":"string"},"end":{"type":"string"},"count":{"type":"string"},"offset":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/calendar/public_offerings":{"post":{"operationId":"finance_calendar_public_offerings","summary":"public offerings derived from Yahoo IPO calendar deal types","tags":["Finance & Data"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"start":{"type":"string"},"end":{"type":"string"},"count":{"type":"string"},"offset":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/calendar/ipo":{"post":{"operationId":"finance_calendar_ipo","summary":"IPO calendar via Yahoo visualization calendar","tags":["Finance & Data"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"start":{"type":"string"},"end":{"type":"string"},"count":{"type":"string"},"offset":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/calendar/stock-splits":{"post":{"operationId":"finance_calendar_stock_splits","summary":"symbol stock splits via chart events","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/calendar/count":{"post":{"operationId":"finance_calendar_count","summary":"count of calendar events in a window (economic/ipo)","tags":["Finance & Data"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"calendar_type":{"type":"string"},"type":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/futures":{"post":{"operationId":"finance_futures","summary":"futures chain: related contract months via Yahoo futuresChain","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"ES=F"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/insights":{"post":{"operationId":"finance_insights","summary":"trading insights: technical events, key technicals, valuation, recommendation, significant developments","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"reportsCount":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/research":{"post":{"operationId":"finance_research","summary":"what analysts are saying: research-report metadata via Yahoo insights","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"reportsCount":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/fund/fees":{"post":{"operationId":"finance_fund_fees","summary":"ETF/mutual-fund fees and expenses via Yahoo fundProfile","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"SPY"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/fund/holdings":{"post":{"operationId":"finance_fund_holdings","summary":"ETF/mutual-fund top holdings, sector weightings, asset allocation via Yahoo topHoldings","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"SPY"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/recommendations":{"post":{"operationId":"finance_recommendations","summary":"peer/similar symbols via Yahoo recommendationsbysymbol","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/news/details":{"post":{"operationId":"finance_news_details","summary":"full news article content by uuid via Yahoo caas","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uuid":{"type":"string"}},"required":["uuid"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/screener/fields":{"post":{"operationId":"finance_screener_fields","summary":"queryable screener field catalog (filters) via Yahoo screeners","tags":["Finance & Data"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"}}},"example":{"type":"equity"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/market/tickers-by-type":{"post":{"operationId":"finance_market_tickers_by_type","summary":"symbol lookup filtered by quote type (equity/etf/mutualfund/future/index/currency)","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"type":{"type":"string"},"count":{"type":"string"}},"required":["query"]},"example":{"query":"apple"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/stock/profile":{"post":{"operationId":"finance_v1_stock_profile","summary":"quoteSummary alias for assetProfile,summaryProfile","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/stock/statistics":{"post":{"operationId":"finance_v1_stock_statistics","summary":"quoteSummary alias for defaultKeyStatistics","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/stock/financial-data":{"post":{"operationId":"finance_v1_stock_financial_data","summary":"quoteSummary alias for financialData","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/stock/sec-filings":{"post":{"operationId":"finance_v1_stock_sec_filings","summary":"quoteSummary alias for secFilings,assetProfile","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/stock/earnings":{"post":{"operationId":"finance_v1_stock_earnings","summary":"quoteSummary alias for earnings,earningsTrend,earningsHistory","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/stock/calendar-events":{"post":{"operationId":"finance_v1_stock_calendar_events","summary":"quoteSummary alias for calendarEvents","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/stock/insider-holders":{"post":{"operationId":"finance_v1_stock_insider_holders","summary":"quoteSummary alias for insiderHolders","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/stock/balance-sheet":{"post":{"operationId":"finance_v1_stock_balance_sheet","summary":"quoteSummary alias for balanceSheetHistory","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v2/stock/balance-sheet":{"post":{"operationId":"finance_v2_stock_balance_sheet","summary":"quoteSummary alias for balanceSheetHistory,balanceSheetHistoryQuarterly","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/stock/institution-ownership":{"post":{"operationId":"finance_v1_stock_institution_ownership","summary":"quoteSummary alias for institutionOwnership","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/stock/insider-transactions":{"post":{"operationId":"finance_v1_stock_insider_transactions","summary":"quoteSummary alias for insiderTransactions","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/stock/index-trend":{"post":{"operationId":"finance_v1_stock_index_trend","summary":"quoteSummary alias for indexTrend","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/stock/income-statement":{"post":{"operationId":"finance_v1_stock_income_statement","summary":"quoteSummary alias for incomeStatementHistory,incomeStatementHistoryQuarterly","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/stock/cashflow-statement":{"post":{"operationId":"finance_v1_stock_cashflow_statement","summary":"quoteSummary alias for cashflowStatementHistory,cashflowStatementHistoryQuarterly","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/stock/recommendation-trend":{"post":{"operationId":"finance_v1_stock_recommendation_trend","summary":"quoteSummary alias for recommendationTrend","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/stock/net-share-purchase-activity":{"post":{"operationId":"finance_v1_stock_net_share_purchase_activity","summary":"quoteSummary alias for netSharePurchaseActivity","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/stock/upgrade-downgrade-history":{"post":{"operationId":"finance_v1_stock_upgrade_downgrade_history","summary":"quoteSummary alias for upgradeDowngradeHistory","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/insider-trades":{"post":{"operationId":"finance_v1_insider_trades","summary":"quoteSummary alias for insiderTransactions,insiderHolders,netSharePurchaseActivity","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/indicators/sma":{"post":{"operationId":"finance_v1_indicators_sma","summary":"local SMA indicator from chart OHLCV","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/indicators/rsi":{"post":{"operationId":"finance_v1_indicators_rsi","summary":"local RSI indicator from chart OHLCV","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/indicators/macd":{"post":{"operationId":"finance_v1_indicators_macd","summary":"local MACD indicator from chart OHLCV","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/v1/indicators/adx":{"post":{"operationId":"finance_v1_indicators_adx","summary":"local ADX indicator from chart OHLCV","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/stock/get-futures-chain":{"post":{"operationId":"finance_stock_get_futures_chain","summary":"apidojo-compatible alias for futures","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/stock/get-insights":{"post":{"operationId":"finance_stock_get_insights","summary":"apidojo-compatible alias for insights","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/stock/v3/get-insights":{"post":{"operationId":"finance_stock_v3_get_insights","summary":"apidojo-compatible alias for insights","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/stock/get-what-analysts-are-saying":{"post":{"operationId":"finance_stock_get_what_analysts_are_saying","summary":"apidojo-compatible alias for research","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/stock/get-fees-and-expenses":{"post":{"operationId":"finance_stock_get_fees_and_expenses","summary":"apidojo-compatible alias for fund/fees","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/stock/get-top-holdings":{"post":{"operationId":"finance_stock_get_top_holdings","summary":"apidojo-compatible alias for fund/holdings","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/stock/v2/get-recommendations":{"post":{"operationId":"finance_stock_v2_get_recommendations","summary":"apidojo-compatible alias for recommendations","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"AAPL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/news/v2/get-details":{"post":{"operationId":"finance_news_v2_get_details","summary":"apidojo-compatible alias for news/details","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uuid":{"type":"string"}},"required":["uuid"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/screeners/get-filters":{"post":{"operationId":"finance_screeners_get_filters","summary":"apidojo-compatible alias for screener/fields","tags":["Finance & Data"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/finance/v1/market/get-tickers-by-quote-type":{"post":{"operationId":"finance_market_get_tickers_by_quote_type","summary":"apidojo-compatible alias for market/tickers-by-type","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"example":{"query":"apple"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/fitness/v1/exercises":{"post":{"operationId":"fitness_exercises","summary":"Browse or search the full exercise library (800+ exercises from wger.de). Filter by name keyword; returns each exercise's name, body part, target muscle, equipment, step-by-step instructions, and animation URL.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"term":{"type":"string"},"limit":{"type":"string"},"offset":{"type":"string"},"language":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/fitness/v1/by_bodypart":{"post":{"operationId":"fitness_by_bodypart","summary":"All exercises targeting a specific body part — e.g. 'chest', 'back', 'shoulders', 'upper arms', 'waist'. Returns name, target muscle, equipment, and instructions for each.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"bodypart":{"type":"string"},"bodyPart":{"type":"string"},"limit":{"type":"string"},"offset":{"type":"string"},"language":{"type":"string"}},"required":["bodypart"]},"example":{"bodypart":"chest","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/fitness/v1/by_equipment":{"post":{"operationId":"fitness_by_equipment","summary":"All exercises that use a specific piece of equipment — e.g. 'barbell', 'dumbbell', 'kettlebell', 'none' (bodyweight). Returns name, target muscle, body part, and instructions.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"equipment":{"type":"string"},"limit":{"type":"string"},"offset":{"type":"string"},"language":{"type":"string"}},"required":["equipment"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/fitness/v1/by_target":{"post":{"operationId":"fitness_by_target","summary":"All exercises that target a specific muscle — e.g. 'biceps', 'triceps', 'quads', 'glutes', 'lats'. Returns name, equipment, body part, and step-by-step instructions.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"string"},"limit":{"type":"string"},"offset":{"type":"string"},"language":{"type":"string"}},"required":["target"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/fitness/v1/exercise_detail":{"post":{"operationId":"fitness_exercise_detail","summary":"Full detail for a single exercise by its id — name, body part, primary and secondary muscles, equipment, step-by-step instructions, animation URL, and license.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"exercise_id":{"type":"string"},"language":{"type":"string"}},"required":["id"]},"example":{"id":1962}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/fitness/v1/bodypart_list":{"post":{"operationId":"fitness_bodypart_list","summary":"List all available body part categories (e.g. chest, back, shoulders, waist, cardio). Use these values with the by_bodypart action.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/fitness/v1/equipment_list":{"post":{"operationId":"fitness_equipment_list","summary":"List all available equipment types (e.g. barbell, dumbbell, kettlebell, none). Use these values with the by_equipment action.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/fitness/v1/target_list":{"post":{"operationId":"fitness_target_list","summary":"List all available target muscles (e.g. biceps, triceps, quads, glutes, lats). Use these values with the by_target action.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/fiverr/v1/search":{"post":{"operationId":"fiverr_search","summary":"Search live Fiverr GIGS by keyword. Returns title, starting price + delivery days, package count, rating, review count, category, gig attributes (style/format/…), images, and the seller's handle, level, country, languages and rating. Paid 'promoted' gigs are dropped by default and flagged when kept.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"},"offset":{"type":"string"},"include_promoted":{"type":"string"}},"required":["query"]},"example":{"query":"logo design","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/fiverr/v1/category":{"post":{"operationId":"fiverr_category","summary":"Browse a Fiverr CATEGORY without a keyword — same gig rows as `search`, taken from the category landing page. Use when you want the market for a whole sub-category (e.g. website development) rather than a search term.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"limit":{"type":"string"},"offset":{"type":"string"},"include_promoted":{"type":"string"}},"required":["category"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/fiverr/v1/gig":{"post":{"operationId":"fiverr_gig","summary":"Full detail for ONE Fiverr gig by URL or '/': description, every pricing package (title, price, delivery hours, revisions), FAQ, review summary and the most recent reviews with their order price band, plus the seller block.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/fiverr/v1/seller":{"post":{"operationId":"fiverr_seller","summary":"PUBLIC business profile of a Fiverr seller by handle or profile URL: display name, headline, bio, country, timezone, join date, languages, skills, seller level, Pro/verified flags, response time, hourly rate, rating, review count and the gigs they list.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"}},"required":["username"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flightaware/v1/flight_status":{"post":{"operationId":"flightaware_flight_status","summary":"Live status for one flight by ident or flight number. Returns origin/destination (airport name, IATA/ICAO, gate, terminal, timezone, coordinates), scheduled / estimated / actual times for gate-out, take-off, landing and gate-in, aircraft type, airline, trip progress (percent complete, miles flown/remaining), the live position (altitude, groundspeed, heading) when airborne, and the filed flight plan.","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ident":{"type":"string"}},"required":["ident"]},"example":{"ident":"UAL100"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flightaware/v1/live_position":{"post":{"operationId":"flightaware_live_position","summary":"Live ADS-B track for one airborne flight: current position plus the full position history (lat/lon/altitude/groundspeed per timestamp) FlightAware has logged for this leg. Use flight_status first to confirm the flight is airborne. For grounded / arrived flights `position` is null and `track` is whatever was logged on the ground.","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ident":{"type":"string"}},"required":["ident"]},"example":{"ident":"UAL100"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flightaware/v1/airport_board":{"post":{"operationId":"flightaware_airport_board","summary":"Live activity board for an airport: the arrivals, departures, en-route or scheduled flights FlightAware shows for that airport. Each row gives the flight ident, aircraft type, the other airport (IATA), and the scheduled/estimated times. Feed an ident back into flight_status for full detail.","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"airport":{"type":"string"},"board":{"type":"string"},"limit":{"type":"string"}},"required":["airport"]},"example":{"airport":"KJFK","board":"arrivals"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flights/v1/search_flights":{"post":{"operationId":"flights_search_flights","summary":"Search flights from origin to destination for a given date. Returns ranked itineraries with price, all flight segments (carrier, flight number, departure/arrival times), total journey duration and a direct booking link. Supports one-way and return trips.","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"origin":{"type":"string"},"destination":{"type":"string"},"depart_date":{"type":"string"},"return_date":{"type":"string"},"depart_date_end":{"type":"string"},"return_date_end":{"type":"string"},"adults":{"type":"string"},"children":{"type":"string"},"infants":{"type":"string"},"cabin_class":{"type":"string"},"currency":{"type":"string"},"max_stops":{"type":"string"},"sort":{"type":"string"},"limit":{"type":"string"}},"required":["origin","destination","depart_date"]},"example":{"origin":"London","destination":"New York","depart_date":"2026-09-29","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flights/v1/search_places":{"post":{"operationId":"flights_search_places","summary":"Resolve a city or airport name to location IDs used in flight search — useful when you want to pin an exact airport rather than a city (e.g. 'Heathrow' → LHR).","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"}},"required":["query"]},"example":{"query":"London"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flights/v1/airport_info":{"post":{"operationId":"flights_airport_info","summary":"Look up airports and cities by name or IATA code. Returns full reference data: IATA + ICAO codes, GPS coordinates, timezone, country, and — for a city — the list of all its airports. Useful to validate a code, geolocate an airport, or map a city to its airports.","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"}},"required":["query"]},"example":{"query":"Heathrow"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flights/v1/price_graph":{"post":{"operationId":"flights_price_graph","summary":"Find the cheapest day to fly. Returns the lowest price for each departure date across a date range, each tagged CHEAP / AVERAGE / EXPENSIVE, plus the single cheapest option. Set nights_min/nights_max for a return trip; omit them for one-way. One fast call.","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"origin":{"type":"string"},"destination":{"type":"string"},"depart_date":{"type":"string"},"depart_date_end":{"type":"string"},"nights_min":{"type":"string"},"nights_max":{"type":"string"},"adults":{"type":"string"},"children":{"type":"string"},"infants":{"type":"string"},"cabin_class":{"type":"string"},"currency":{"type":"string"}},"required":["origin","destination","depart_date"]},"example":{"origin":"London","destination":"New York","depart_date":"2026-09-29","depart_date_end":"2026-10-06"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flights/v1/seat_info":{"post":{"operationId":"flights_seat_info","summary":"Get the seat specs and amenities for a specific flight: seat pitch, width and recline (legroom/comfort), plus power, Wi-Fi and in-flight entertainment availability. Look up by airline + flight number + route + date. Returns honest empty when the flight is unknown.","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"carrier":{"type":"string"},"flight_number":{"type":"string"},"source":{"type":"string"},"destination":{"type":"string"},"date":{"type":"string"},"cabin_class":{"type":"string"}},"required":["carrier","flight_number","source","destination","date"]},"example":{"carrier":"BA","flight_number":"177","source":"LHR","destination":"JFK","date":"2026-09-29"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flipkart/v1/search":{"post":{"operationId":"flipkart_search","summary":"Flipkart product search with filters — keyword search returning product cards (title/price/mrp/discount/rating/image/url) plus the total result count, paginated. Filter by brand, price range, minimum rating, minimum discount, F-Assured and any category facet (use the `filters` action to discover what a query supports).","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"page":{"type":"string"},"sort":{"type":"string"},"brand":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"min_rating":{"type":"string"},"min_discount":{"type":"string"},"f_assured":{"type":"string"},"no_cost_emi":{"type":"string"},"include_out_of_stock":{"type":"string"},"facets":{"type":"string"}},"required":["q"]},"example":{"q":"laptop"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flipkart/v1/product":{"post":{"operationId":"flipkart_product","summary":"full product page facts (title/price/mrp/rating/specs/highlights/images/seller/similar)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"itm_id":{"type":"string"}}},"example":{"itm_id":"itm5a14f3731bf15"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flipkart/v1/reviews":{"post":{"operationId":"flipkart_reviews","summary":"Flipkart buyer reviews for a product, paginated — each review has rating, title, body, reviewer name, location, certified-buyer badge, helpful/up/down votes and date, plus the product's total review count. Page through with meta.next_page to collect them all.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string"},"itm_id":{"type":"string"},"page":{"type":"string"},"sort":{"type":"string"}}},"example":{"itm_id":"itm5a14f3731bf15"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flipkart/v1/category":{"post":{"operationId":"flipkart_category","summary":"category/browse listing cards from a Flipkart category URL/path","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"path":{"type":"string"},"page":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flipkart/v1/browse":{"post":{"operationId":"flipkart_browse","summary":"Alias of the `category` action — browse/listing cards from a Flipkart category URL or site-relative path. (browse needs url OR path.)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"path":{"type":"string"},"page":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flipkart/v1/similar":{"post":{"operationId":"flipkart_similar","summary":"similar/related products from a product page reco widgets","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"itm_id":{"type":"string"},"product_id":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flipkart/v1/seller":{"post":{"operationId":"flipkart_seller","summary":"Who sells a product: seller id, fulfilment and availability, resolved from a product URL — plus storefront catalog cards when a storefront path is supplied. Start with `product_url` (the live-verified route); Flipkart has no public /seller/ storefront, so a bare `seller_id` returns metadata only.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"product_url":{"type":"string"},"url":{"type":"string"},"seller_id":{"type":"string"},"seller_path":{"type":"string"},"seller_url":{"type":"string"},"product_id":{"type":"string"},"page":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flipkart/v1/autocomplete":{"post":{"operationId":"flipkart_autocomplete","summary":"search autosuggest suggestions for a partial query","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"}},"required":["q"]},"example":{"q":"laptop"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flipkart/v1/categories":{"post":{"operationId":"flipkart_categories","summary":"top-level navigation/category links from homepage state","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flipkart/v1/variants":{"post":{"operationId":"flipkart_variants","summary":"Product variants (the sibling SKUs — color/storage/size) each with its OWN price, stock status and product URL, from the product page.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"itm_id":{"type":"string"},"product_id":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flipkart/v1/filters":{"post":{"operationId":"flipkart_filters","summary":"Available search filters (facets) for a query — every filter Flipkart offers for these results: brand, price, rating, discount, offers, availability and category-specific facets (processor, RAM, screen size, etc.), each value carrying a count and a ready-to-use filter `param`. Feed a value's `param` back into search's `facets` argument.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"brand":{"type":"string"}},"required":["q"]},"example":{"q":"laptop"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flipkart/v1/offers":{"post":{"operationId":"flipkart_offers","summary":"Bank, EMI, exchange and cashback offers for a product (the offer strip on the product page): e.g. 'Flipkart Axis Bank Card 5% cashback', 'Exchange offer up to ₹X off', 'No Cost EMI'. Honest-empty when a product has no active offers.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"itm_id":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flo/v1/search":{"post":{"operationId":"flo_search","summary":"Search FLO by keyword (`query`), paginated. Every card carries product_id, title, brand, price, special_price (discount), sizes[] (with per-size stock), colors[], image, url, seller_type (flo|marketplace).","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"page":{"type":"string"},"sort":{"type":"string"},"max_rotations":{"type":"string"}},"required":["query"]},"example":{"query":"nike"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flo/v1/category/products":{"post":{"operationId":"flo_category_products","summary":"Browse a FLO category (`category` slug + optional `cinsiyet` gender), paginated — the deep shoe-enumeration workhorse. Same rich card shape as search (sizes, colors, discount, stock).","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"cinsiyet":{"type":"string"},"page":{"type":"string"},"sort":{"type":"string"},"max_rotations":{"type":"string"}},"required":["category"]},"example":{"category":"spor-ayakkabi","cinsiyet":"erkek"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/flo/v1/product/detail":{"post":{"operationId":"flo_product_detail","summary":"Full FLO product by its page `url`: title, brand, price, original_price, discount_percent, currency=TRY, images[] (full gallery), sizes[] (per-size stock with a unit count and a barcode on every size), colors[], coupons[], badges (free-shipping/campaign), rating, seller, description, stock. Pass the url — FLO has no route that takes the product id by itself, and search and category rows already carry the url for exactly this call.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"max_rotations":{"type":"string"}},"required":["url"]},"example":{"url":"https://www.flo.com.tr/urun/nike-court-borough-low-recraft-beyaz-unisex-sneaker-101792825"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/forum/v1/latest":{"post":{"operationId":"forum_latest","summary":"Newest topics from one forum, each with its creation time. Ask for the last 24 hours and you get exactly what people opened today.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"limit":{"type":"string"},"since_hours":{"type":"string"},"order_by":{"type":"string"}},"required":["site"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/forum/v1/sites":{"post":{"operationId":"forum_sites","summary":"Every forum this API can read, with its platform and market.","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/forum/v1/topic":{"post":{"operationId":"forum_topic","summary":"The full text of one topic: the opening post and every reply.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/forum/v1/search":{"post":{"operationId":"forum_search","summary":"Search inside one forum. Results come back in the forum's own relevance order, not by date, so use latest when you need recency.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"query":{"type":"string"},"limit":{"type":"string"}},"required":["site","query"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/freelancer/v1/search":{"post":{"operationId":"freelancer_search","summary":"Search live freelance PROJECTS on Freelancer.com by keyword, skills, category, budget/hourly band, freshness, country, and language; sorted by recency, bids, or bid-deadline. Returns title, description, budget{type,min,max,currency}, skills[], bids_count (proposals), posted_at, client_country, and url. No client PII.","tags":["Jobs & Hiring"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"match":{"type":"string"},"skills":{"type":"string"},"category":{"type":"string"},"project_types":{"type":"string"},"budget_min":{"type":"string"},"budget_max":{"type":"string"},"posted_within":{"type":"string"},"countries":{"type":"string"},"languages":{"type":"string"},"sort":{"type":"string"},"limit":{"type":"string"},"offset":{"type":"string"}}},"example":{"query":"python","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/freelancer/v1/project":{"post":{"operationId":"freelancer_project","summary":"Full detail for one Freelancer.com project by numeric id, project URL, or SEO slug — everything from `search` plus hourly-commitment, timeframe, qualifications, escrow status and selected-bid count. No client PII.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]},"example":{"id":"40675266"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/freelancer/v1/user":{"post":{"operationId":"freelancer_user","summary":"PUBLIC business profile of a Freelancer.com freelancer or employer by username/handle or id: display name, country, role, hourly rate, reputation (rating/reviews/completion/repeat-hire), skills, membership, badges, portfolio and registration year. PII (email/phone/legal-name/address) is NEVER returned.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"}},"required":["username"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/freelancer/v1/contests":{"post":{"operationId":"freelancer_contests","summary":"Browse live OPEN Freelancer.com design/creative CONTESTS (accepting entries) — prize, currency, entry count, skills, and deadlines. Filter by keyword and skills.","tags":["Jobs & Hiring"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"skills":{"type":"string"},"limit":{"type":"string"},"offset":{"type":"string"}}},"example":{"limit":8}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/freelancer/v1/skills":{"post":{"operationId":"freelancer_skills","summary":"Resolve a skill name to Freelancer.com skill id(s) (for search's `skills` filter), or list the most-popular skills with their active-project counts — the marketplace's skill taxonomy.","tags":["Jobs & Hiring"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"}}},"example":{"query":"php","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/freelancer/v1/categories":{"post":{"operationId":"freelancer_categories","summary":"List the top-level Freelancer.com job categories (Websites/IT, Design, Writing, Mobile…) with their active-project counts — the browse taxonomy for scoping a search.","tags":["Jobs & Hiring"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/funda/v1/search":{"post":{"operationId":"funda_search","summary":"Search Funda.nl property listings by area (for sale or for rent), with structured filters: price (EUR), rooms, living surface (m²), plot size, property type and sort. Each result carries price, object type, surface, rooms, bedrooms, energy label, construction type, address, agent and the primary photo. Paginate with page.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"area":{"type":"string"},"contract":{"type":"string"},"home_type":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"rooms_min":{"type":"string"},"rooms_max":{"type":"string"},"surface_min":{"type":"string"},"surface_max":{"type":"string"},"plot_min":{"type":"string"},"plot_max":{"type":"string"}},"required":["area"]},"example":{"area":"amsterdam"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/funda/v1/detail":{"post":{"operationId":"funda_detail","summary":"Full record for a single listing by its Funda detail URL or path (funda.nl/detail/koop////). Returns price, address, description, every photo at full resolution, and the complete Kenmerken (specifications) table — surface, rooms, year built, energy label, heating, location and more.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]},"example":{"url":"https://www.funda.nl/detail/koop/amsterdam/appartement-albert-cuypstraat-94-3/44570149/"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/funda/v1/area":{"post":{"operationId":"funda_area","summary":"Area resolver — map a free-text Dutch place name to Funda's search area-slug and report the live listing count there. Use it to power a search box or to confirm the exact area the search will use (a city resolves to its slug, a province to its provincie- slug).","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"example":{"query":"Den Haag"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/generate/v1/pdf_render":{"post":{"operationId":"generate_pdf_render","summary":"Render a PDF from inline HTML/CSS (Jinja2) or a built-in template_name + data (invoice/receipt/certificate/report). WeasyPrint, fonts pinned, network-off. Output: inline base64 (≤8MB) or one-time download token.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"html":{"type":"string"},"template_name":{"type":"string"},"data":{"type":"string"},"paper":{"type":"string"},"filename":{"type":"string"},"allow_hosts":{"type":"string"}}},"example":{"template_name":"invoice","data":{"company":{"name":"Acme"},"items":[{"description":"Widget","qty":2,"unit_price":9.5}],"subtotal":19.0,"total":19.0}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/generate/v1/pdf_from_html":{"post":{"operationId":"generate_pdf_from_html","summary":"Shortcut for rendering inline HTML directly to PDF — the same WeasyPrint engine as pdf_render; `html` is required.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"html":{"type":"string"},"data":{"type":"string"},"paper":{"type":"string"},"filename":{"type":"string"},"allow_hosts":{"type":"string"}},"required":["html"]},"example":{"html":"

{{ t }}

","data":{"t":"Hello"}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/generate/v1/pdf_from_url":{"post":{"operationId":"generate_pdf_from_url","summary":"Render a built-in or inline template to PDF, populating it with data fetched live from a JSON URL you supply. Useful when your invoice or report data lives at a public API endpoint — no manual copy-paste needed.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data_url":{"type":"string"},"template_name":{"type":"string"},"html":{"type":"string"},"data_path":{"type":"string"},"paper":{"type":"string"},"filename":{"type":"string"}},"required":["data_url"]},"example":{"data_url":"https://api.github.com/repos/python/cpython"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/generate/v1/og_image":{"post":{"operationId":"generate_og_image","summary":"Render a social / Open Graph card image (1200×630 default) from a built-in template or an inline layout spec. Supports automatic text-wrap and font scaling for long titles, colour gradients and badge overlays.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"template_name":{"type":"string"},"layout":{"type":"string"},"vars":{"type":"string"},"width":{"type":"string"},"height":{"type":"string"},"format":{"type":"string"},"filename":{"type":"string"}}},"example":{"template_name":"og_basic","vars":{"title":"Launch day","subtitle":"v1.0 is live"}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/generate/v1/image_from_template":{"post":{"operationId":"generate_image_from_template","summary":"Alias of og_image (explicit Bannerbear 'create image from template' naming). template_name + vars → PNG.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"template_name":{"type":"string"},"vars":{"type":"string"},"width":{"type":"string"},"height":{"type":"string"},"format":{"type":"string"},"filename":{"type":"string"}},"required":["template_name"]},"example":{"template_name":"invoice"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/generate/v1/image_from_url":{"post":{"operationId":"generate_image_from_url","summary":"Render an image template with `vars` fetched from a JSON URL (proxy, SSRF-validated). Data-driven banner generation.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data_url":{"type":"string"},"template_name":{"type":"string"},"layout":{"type":"string"},"data_path":{"type":"string"},"width":{"type":"string"},"height":{"type":"string"},"format":{"type":"string"},"filename":{"type":"string"}},"required":["data_url"]},"example":{"data_url":"https://api.github.com/repos/python/cpython","template_name":"og_basic"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/generate/v1/chart":{"post":{"operationId":"generate_chart","summary":"Render a chart from a Chart.js-style spec — returns a PNG or SVG image. Supported chart types: bar, horizontal_bar, line, area, pie, doughnut, scatter and radar. Powered by a matplotlib backend.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"spec":{"type":"string"},"format":{"type":"string"},"filename":{"type":"string"}},"required":["spec"]},"example":{"spec":{"type":"bar","data":{"labels":["A","B","C"],"datasets":[{"label":"x","data":[1,2,3]}]}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/generate/v1/chart_types":{"post":{"operationId":"generate_chart_types","summary":"List all supported chart types with a description of each. No input required.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/generate/v1/batch_pdf":{"post":{"operationId":"generate_batch_pdf","summary":"Render up to 20 PDFs in one call. `jobs` = array of pdf_render param objects.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jobs":{"type":"string"}},"required":["jobs"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/generate/v1/batch_image":{"post":{"operationId":"generate_batch_image","summary":"Render up to 20 images in one call. `jobs` = array of og_image param objects.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jobs":{"type":"string"}},"required":["jobs"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/generate/v1/template_list":{"post":{"operationId":"generate_template_list","summary":"List built-in templates (PDF + image) with their data contracts. Stateless — there is NO stored-template management (create/upload/delete out of scope).","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/generate/v1/validate_html":{"post":{"operationId":"generate_validate_html","summary":"Lint HTML/CSS for the PDF path WITHOUT rendering: flags remote resources that the SSRF-safe renderer will block, size, and tag-balance hints. Deterministic.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"html":{"type":"string"}},"required":["html"]},"example":{"html":""}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/generate/v1/health":{"post":{"operationId":"generate_health","summary":"Renderer diagnostics — which backends (WeasyPrint/Pillow/matplotlib) are loadable and their versions. No input.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/generate/v1/qr":{"post":{"operationId":"generate_qr","summary":"Generate a QR code (PNG or SVG) with custom fg/bg color, error-correction, and an OPTIONAL center logo fetched from logo_url (SSRF-guarded, via proxy). Use error_correction=h when embedding a logo so it stays scannable.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"string"},"format":{"type":"string"},"error_correction":{"type":"string"},"scale":{"type":"string"},"border":{"type":"string"},"color":{"type":"string"},"background":{"type":"string"},"logo_url":{"type":"string"},"logo_size":{"type":"string"}},"required":["data"]},"example":{"data":"https://reefapi.com","format":"png"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/generate/v1/barcode":{"post":{"operationId":"generate_barcode","summary":"Generate a 1D barcode IMAGE (PNG or SVG) from data: EAN-13/8, UPC-A, Code-128, Code-39, ISBN-10/13, ITF, GS1-128, JAN, PZN, Codabar. Check digits are validated — a wrong EAN/UPC/ISBN check digit returns a structured error, not a silent fix.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"string"},"type":{"type":"string"},"format":{"type":"string"},"show_text":{"type":"string"},"module_height":{"type":"string"},"color":{"type":"string"},"background":{"type":"string"}},"required":["data","type"]},"example":{"data":"5901234123457","type":"ean13"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/generate/v1/code_image":{"post":{"operationId":"generate_code_image","summary":"Render a syntax-highlighted code snippet as a PNG with a carbon/ray.so-style window frame. 500+ languages (Pygments), 40+ themes, optional line numbers.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"language":{"type":"string"},"theme":{"type":"string"},"window_style":{"type":"string"},"line_numbers":{"type":"string"},"font_size":{"type":"string"}},"required":["code"]},"example":{"code":"print('hello')","language":"python"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/generate/v1/favicon":{"post":{"operationId":"generate_favicon","summary":"Turn one source image into a complete favicon bundle: multi-resolution favicon.ico, a named PNG set (16→512 incl. apple-touch-icon + android-chrome), site.webmanifest, and the ready-to-paste snippet. Source from image_url (SSRF-guarded) or a base64 upload.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"image_url":{"type":"string"},"image_base64":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/generate/v1/vcard":{"post":{"operationId":"generate_vcard","summary":"Build a vCard (.vcf) contact file from contact fields (vCard 3.0 or 4.0). Returns the raw .vcf text + a base64 data-URI you can download or encode into a QR.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"full_name":{"type":"string"},"first_name":{"type":"string"},"last_name":{"type":"string"},"organization":{"type":"string"},"title":{"type":"string"},"phone":{"type":"string"},"email":{"type":"string"},"url":{"type":"string"},"address":{"type":"string"},"note":{"type":"string"},"birthday":{"type":"string"},"version":{"type":"string"},"as_qr":{"type":"string"}}},"example":{"full_name":"Jane Doe","email":"jane@acme.com","phone":"+15550100"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/generate/v1/ical":{"post":{"operationId":"generate_ical","summary":"Build an iCalendar (.ics) event file from event fields (RFC 5545). Supports timed or all-day events, end-time or duration, location, description, organizer. Returns the raw .ics + a base64 data-URI.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"summary":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"duration_minutes":{"type":"string"},"location":{"type":"string"},"description":{"type":"string"},"url":{"type":"string"},"organizer_email":{"type":"string"},"uid":{"type":"string"},"as_qr":{"type":"string"}},"required":["summary","start"]},"example":{"summary":"Standup","start":"2026-07-01T15:00:00Z","duration_minutes":30}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/generate/v1/wifi":{"post":{"operationId":"generate_wifi","summary":"Generate a WiFi-join QR code (PNG/SVG) from network credentials — scan to connect, no typing. Encodes the standard WIFI: payload (WPA/WEP/open, hidden networks).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ssid":{"type":"string"},"password":{"type":"string"},"encryption":{"type":"string"},"hidden":{"type":"string"},"format":{"type":"string"},"scale":{"type":"string"},"error_correction":{"type":"string"}},"required":["ssid"]},"example":{"ssid":"MyNet","password":"pw12345","encryption":"WPA"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/generate/v1/batch":{"post":{"operationId":"generate_batch","summary":"Generate up to 50 small assets in one request. Items run independently — a bad item yields its own error entry, never fails the batch. NOTE: items that fetch a remote logo_url/image_url ARE supported and SSRF-guarded.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"string"}},"required":["items"]},"example":{"items":[{"action":"qr","params":{"data":"x"}},{"action":"barcode","params":{"data":"5901234123457","type":"ean13"}},{"action":"barcode","params":{"data":"bad","type":"ean13"}}]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/geo-intel/v1/check":{"post":{"operationId":"geo_intel_check","summary":"Full AI-readiness report for a URL: AI-crawler access map + llms.txt + schema + meta + 0-100 score + ranked fix recommendations. One call, everything.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"path":{"type":"string"},"bots":{"type":"string"},"follow_redirects":{"type":"string"}},"required":["url"]},"example":{"url":"https://docs.anthropic.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/geo-intel/v1/crawlers":{"post":{"operationId":"geo_intel_crawlers","summary":"AI-crawler access map from robots.txt: per-bot allow/block (Google longest-match), operator, AI engine, purpose (search/training/agent), crawl-delay, sitemaps.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"path":{"type":"string"},"bots":{"type":"string"}},"required":["url"]},"example":{"url":"https://www.nytimes.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/geo-intel/v1/llms_txt":{"post":{"operationId":"geo_intel_llms_txt","summary":"Detect + parse + validate /llms.txt (and /llms-full.txt) — the emerging AI-context standard. Content-type sniffed so an HTML 404 can't masquerade as a real file.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]},"example":{"url":"https://stripe.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/geo-intel/v1/schema":{"post":{"operationId":"geo_intel_schema","summary":"Extract and classify schema.org structured data (JSON-LD and @graph) for AI citability signals: Organization, Article, FAQ, BreadcrumbList, Product, Speakable — plus microdata and RDFa presence.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"follow_redirects":{"type":"string"}},"required":["url"]},"example":{"url":"https://www.nytimes.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/geo-intel/v1/score":{"post":{"operationId":"geo_intel_score","summary":"Composite AI-readiness score (0-100) + transparent per-pillar breakdown (crawler_access 40 / structured_data 25 / llms_txt 15 / meta 12 / crawlability 8) + ranked recommendations.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"path":{"type":"string"},"follow_redirects":{"type":"string"}},"required":["url"]},"example":{"url":"https://github.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/geo-intel/v1/batch":{"post":{"operationId":"geo_intel_batch","summary":"Score up to 20 sites concurrently in one call (each independently SSRF-guarded). Returns a compact score+grade per URL.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string"}},"required":["urls"]},"example":{"urls":["https://stripe.com","https://github.com"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/geo-postal/v1/eu_regions":{"post":{"operationId":"geo_postal_eu_regions","summary":"Coordinates OR postal code → EU/EFTA/candidate statistical regions: country, NUTS 0-3 hierarchy, LAU commune (GISCO NUTS-2024 + LAU-2024 + TERCET pc2025).","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"lat":{"type":"string"},"lon":{"type":"string"},"postal_code":{"type":"string"},"country":{"type":"string"},"include_geometry":{"type":"string"}}},"example":{"lat":52.52,"lon":13.405}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/geo-postal/v1/tr_regions":{"post":{"operationId":"geo_postal_tr_regions","summary":"Türkiye: koordinat, posta kodu VEYA il/ilçe/mahalle adı → resmî idari hiyerarşi (il+plaka, ilçe, mahalle/köy, posta kodları) + NUTS-TR istatistik kodları.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"lat":{"type":"string"},"lon":{"type":"string"},"postal_code":{"type":"string"},"province":{"type":"string"},"district":{"type":"string"},"neighborhood":{"type":"string"},"include_geometry":{"type":"string"}}},"example":{"lat":41.0082,"lon":28.9784}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/geo-postal/v1/in_postal":{"post":{"operationId":"geo_postal_in_postal","summary":"India: PIN code OR post-office name → post offices, district, state, lat/lon centroid (official All-India Pincode Directory).","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"pincode":{"type":"string"},"office":{"type":"string"},"state":{"type":"string"},"district":{"type":"string"}}},"example":{"pincode":"400001"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/geo-postal/v1/us_regions":{"post":{"operationId":"geo_postal_us_regions","summary":"United States: ZIP code OR coordinates → state, county + 5-digit county FIPS, place, ZIP centroid, and the CGAZ state/county boundary. Built WITHOUT census.gov (GeoNames ZIP directory carries county FIPS; ANSI state-FIPS is a public-domain constant). For census-grade ZCTA + tract/block GEOIDs use the `us_census` action (TIGER/ZCTA polygons + Census Geocoder, gov-pending/91).","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"postal_code":{"type":"string"},"lat":{"type":"string"},"lon":{"type":"string"},"include_geometry":{"type":"string"}}},"example":{"postal_code":"10001"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/geo-postal/v1/us_census":{"post":{"operationId":"geo_postal_us_census","summary":"United States census-grade geocode: street ADDRESS, ZIP, or coordinates → state, county (+5-digit FIPS), census TRACT GEOID, census BLOCK GEOID, ZCTA, and tract/ZCTA land-area — with match_type + confidence. Coordinates/ZIP resolve the ZCTA offline from pinned TIGER/ZCTA-2024 polygons (zero egress); the authoritative tract/block GEOID + address geocoding come from the US Census Geocoder, cached. US-Gov public domain (Title 17 §105).","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string"},"postal_code":{"type":"string"},"lat":{"type":"string"},"lon":{"type":"string"},"include_geometry":{"type":"string"},"live":{"type":"string"}}},"example":{"lat":40.7505,"lon":-73.9967,"live":true}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/geo-postal/v1/admin_boundary":{"post":{"operationId":"geo_postal_admin_boundary","summary":"GLOBAL coordinates → administrative boundary hierarchy ADM0/ADM1/ADM2 (geoBoundaries CGAZ composite, CC-BY 4.0).","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lat":{"type":"string"},"lon":{"type":"string"},"levels":{"type":"string"},"include_geometry":{"type":"string"}},"required":["lat","lon"]},"example":{"lat":35.6762,"lon":139.6503}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/geo-postal/v1/postal_lookup":{"post":{"operationId":"geo_postal_postal_lookup","summary":"country + postal code → region metadata for ~100 countries (GeoNames postal directory) with country-specific enrichment (EU→NUTS3, TR→mahalle, IN→offices).","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"postal_code":{"type":"string"}},"required":["country","postal_code"]},"example":{"country":"FR","postal_code":"75001"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/geo-postal/v1/postal_search":{"post":{"operationId":"geo_postal_postal_search","summary":"country + city/place → its postal codes (zip-by-city); country + admin1 only → that state's codes (zip-by-state); country only → the country's states/regions list (GeoNames directory).","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"place":{"type":"string"},"admin1":{"type":"string"},"limit":{"type":"string"}},"required":["country"]},"example":{"country":"DE","place":"München","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/geo-postal/v1/postal_distance":{"post":{"operationId":"geo_postal_postal_distance","summary":"Great-circle distance between two postal codes (same or different countries).","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"to_country":{"type":"string"},"unit":{"type":"string"}},"required":["country","from","to"]},"example":{"country":"US","from":"10001","to":"90210"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/geo-postal/v1/postal_radius":{"post":{"operationId":"geo_postal_postal_radius","summary":"All postal codes within a radius of a postal code (centroid-based).","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"postal_code":{"type":"string"},"radius_km":{"type":"string"},"limit":{"type":"string"}},"required":["country","postal_code","radius_km"]},"example":{"country":"DE","postal_code":"10115","radius_km":3}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/geo-postal/v1/batch":{"post":{"operationId":"geo_postal_batch","summary":"Resolve up to 50 mixed lookups in one call (cheap local queries).","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"string"}},"required":["items"]},"example":{"items":[{"action":"eu_regions","lat":48.8566,"lon":2.3522},{"action":"postal_lookup","country":"TR","postal_code":"34710"}]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/getyourguide/v1/search":{"post":{"operationId":"getyourguide_search","summary":"Search GetYourGuide for tours & activities by free-text keyword or destination ('Rome colosseum', 'Paris', 'wine tasting Tuscany'). Returns activity cards with title, activity_id, price and list price, rating, review count, photos, category, duration and a link to the activity. GetYourGuide answers a query it cannot match with recommended activities rather than an empty page, so compare the titles against your query when it is very specific.","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"currency":{"type":"string"},"language":{"type":"string"}},"required":["query"]},"example":{"query":"Rome colosseum","currency":"EUR"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/getyourguide/v1/browse":{"post":{"operationId":"getyourguide_browse","summary":"Browse the top tours & activities for a destination's landing page. Returns activities with title, price, rating, review count, photos and a link. Identify the destination by its slug (from search/destinations) or by location_id + city.","tags":["Travel & Lodging"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"location_id":{"type":"string"},"city":{"type":"string"},"destination":{"type":"string"},"url":{"type":"string"},"currency":{"type":"string"},"language":{"type":"string"}}},"example":{"slug":"paris-l16"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/getyourguide/v1/detail":{"post":{"operationId":"getyourguide_detail","summary":"Full record for one tour/activity: title, description, the company that operates it, price and list price, rating, review count and photos. Identify it by its activity url (from search/browse).","tags":["Travel & Lodging"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string"},"currency":{"type":"string"},"language":{"type":"string"}}},"example":{"url":"https://www.getyourguide.com/rome-l33/colosseum-roman-forum-palatine-hill-guided-tour-t195566/","currency":"EUR"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/getyourguide/v1/reviews":{"post":{"operationId":"getyourguide_reviews","summary":"The most-recent public traveler reviews for one activity (rating, text, author, date) plus the overall rating and total review count. Returns the 10 newest reviews — that is the full set GetYourGuide publishes on the activity page itself; read review_count for the total volume behind them.","tags":["Travel & Lodging"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string"},"language":{"type":"string"}}},"example":{"url":"https://www.getyourguide.com/rome-l33/colosseum-roman-forum-palatine-hill-guided-tour-t195566/"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/getyourguide/v1/destinations":{"post":{"operationId":"getyourguide_destinations","summary":"Destination metadata for a GetYourGuide location: id, name, type, country, the number of bookable activities, and its parent locations (region → country). Useful to confirm a destination and discover its hierarchy before browsing.","tags":["Travel & Lodging"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"location_id":{"type":"string"},"city":{"type":"string"},"destination":{"type":"string"},"url":{"type":"string"},"language":{"type":"string"}}},"example":{"slug":"paris-l16"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/user":{"post":{"operationId":"github_user","summary":"GitHub user profile","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"anon_tier":{"type":"string"}},"required":["username"]},"example":{"username":"torvalds"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/user_repos":{"post":{"operationId":"github_user_repos","summary":"repositories owned by a user","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"type":{"type":"string"},"sort":{"type":"string"},"direction":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}},"required":["username"]},"example":{"username":"torvalds"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/user_followers":{"post":{"operationId":"github_user_followers","summary":"followers for a user","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}},"required":["username"]},"example":{"username":"torvalds"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/user_following":{"post":{"operationId":"github_user_following","summary":"accounts followed by a user","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}},"required":["username"]},"example":{"username":"torvalds"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/user_gists":{"post":{"operationId":"github_user_gists","summary":"public gists for a user","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}},"required":["username"]},"example":{"username":"torvalds"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/repo":{"post":{"operationId":"github_repo","summary":"repository metadata","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/repo_issues":{"post":{"operationId":"github_repo_issues","summary":"repository issues","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"state":{"type":"string"},"since":{"type":"string"},"sort":{"type":"string"},"direction":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/repo_pulls":{"post":{"operationId":"github_repo_pulls","summary":"repository pull requests","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"state":{"type":"string"},"sort":{"type":"string"},"direction":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/repo_commits":{"post":{"operationId":"github_repo_commits","summary":"repository commits","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"sha":{"type":"string"},"path":{"type":"string"},"author":{"type":"string"},"since":{"type":"string"},"until":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/repo_contributors":{"post":{"operationId":"github_repo_contributors","summary":"repository contributors","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"anon":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/repo_releases":{"post":{"operationId":"github_repo_releases","summary":"repository releases","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/repo_stargazers":{"post":{"operationId":"github_repo_stargazers","summary":"recent stargazers of a repository","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/repo_forks":{"post":{"operationId":"github_repo_forks","summary":"repository forks","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/repo_languages":{"post":{"operationId":"github_repo_languages","summary":"repository language byte counts","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/repo_contents":{"post":{"operationId":"github_repo_contents","summary":"repository content metadata for a path","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"path":{"type":"string"},"ref":{"type":"string"}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/repo_readme":{"post":{"operationId":"github_repo_readme","summary":"repository README metadata/content URL","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"ref":{"type":"string"}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/org":{"post":{"operationId":"github_org","summary":"organization profile","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"org":{"type":"string"}},"required":["org"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/org_repos":{"post":{"operationId":"github_org_repos","summary":"organization repositories","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"org":{"type":"string"},"type":{"type":"string"},"sort":{"type":"string"},"direction":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}},"required":["org"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/org_members":{"post":{"operationId":"github_org_members","summary":"public organization members","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"org":{"type":"string"},"filter":{"type":"string"},"role":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}},"required":["org"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/search_repos":{"post":{"operationId":"github_search_repos","summary":"search repositories","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"sort":{"type":"string"},"order":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"}},"required":["q"]},"example":{"q":"fastapi","per_page":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/search_users":{"post":{"operationId":"github_search_users","summary":"search users","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"sort":{"type":"string"},"order":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"}},"required":["q"]},"example":{"q":"fastapi"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/search_code":{"post":{"operationId":"github_search_code","summary":"search code (token required by GitHub)","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"sort":{"type":"string"},"order":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"}},"required":["q"]},"example":{"q":"fastapi"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/search_issues":{"post":{"operationId":"github_search_issues","summary":"search issues and pull requests","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"sort":{"type":"string"},"order":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"}},"required":["q"]},"example":{"q":"fastapi"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/search_topics":{"post":{"operationId":"github_search_topics","summary":"search GitHub topics","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"}},"required":["q"]},"example":{"q":"fastapi"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/search_commits":{"post":{"operationId":"github_search_commits","summary":"search commits across GitHub","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"sort":{"type":"string"},"order":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"}},"required":["q"]},"example":{"q":"fastapi"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/repo_branches":{"post":{"operationId":"github_repo_branches","summary":"repository branches","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react","per_page":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/repo_tags":{"post":{"operationId":"github_repo_tags","summary":"repository tags","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react","per_page":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/repo_topics":{"post":{"operationId":"github_repo_topics","summary":"repository topics (labels)","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"}},"required":["owner","repo"]},"example":{"owner":"facebook","repo":"react"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/issue_detail":{"post":{"operationId":"github_issue_detail","summary":"single issue detail","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"number":{"type":"string"}},"required":["owner","repo","number"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/issue_comments":{"post":{"operationId":"github_issue_comments","summary":"comments on an issue or PR","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"number":{"type":"string"},"since":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}},"required":["owner","repo","number"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/pull_detail":{"post":{"operationId":"github_pull_detail","summary":"single pull request detail","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"number":{"type":"string"}},"required":["owner","repo","number"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/pull_reviews":{"post":{"operationId":"github_pull_reviews","summary":"reviews on a pull request","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"number":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}},"required":["owner","repo","number"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/pull_files":{"post":{"operationId":"github_pull_files","summary":"files changed in a pull request","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"number":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}},"required":["owner","repo","number"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/pull_commits":{"post":{"operationId":"github_pull_commits","summary":"commits in a pull request","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"number":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}},"required":["owner","repo","number"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/commit_detail":{"post":{"operationId":"github_commit_detail","summary":"single commit detail with diff stats and changed files","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"sha":{"type":"string"}},"required":["owner","repo","sha"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/user_events":{"post":{"operationId":"github_user_events","summary":"public activity events for a user","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}},"required":["username"]},"example":{"username":"torvalds"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/user_orgs":{"post":{"operationId":"github_user_orgs","summary":"organizations a user belongs to (public)","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}},"required":["username"]},"example":{"username":"torvalds"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/user_starred":{"post":{"operationId":"github_user_starred","summary":"repositories a user has starred","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"sort":{"type":"string"},"direction":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}},"required":["username"]},"example":{"username":"torvalds"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/github/v1/rate_limit":{"post":{"operationId":"github_rate_limit","summary":"current token/IP rate-limit status","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/glassdoor/v1/employer/search":{"post":{"operationId":"glassdoor_employer_search","summary":"Resolve a company name to its Glassdoor employer_id + basic profile. Start here — every other action needs the employer_id.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"example":{"query":"Google"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/glassdoor/v1/employer/detail":{"post":{"operationId":"glassdoor_employer_detail","summary":"Employer profile + ratings.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"employer_id":{"type":"string"},"dynamic_profile_id":{"type":"string"}},"required":["employer_id"]},"example":{"employer_id":9079}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/glassdoor/v1/employer/reviews":{"post":{"operationId":"glassdoor_employer_reviews","summary":"One page of employer reviews (rating, pros/cons, role).","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"employer_id":{"type":"string"},"page":{"type":"string"},"cursor":{"type":"string"},"page_size":{"type":"string"},"dynamic_profile_id":{"type":"string"}},"required":["employer_id"]},"example":{"employer_id":9079,"page_size":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/glassdoor/v1/employer/reviews-harvest":{"post":{"operationId":"glassdoor_employer_reviews_harvest","summary":"Fetch all available Glassdoor reviews across multiple pages — returns every unique review with rating, pros/cons and role.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"employer_id":{"type":"string"},"dynamic_profile_id":{"type":"string"},"page_size":{"type":"string"},"max_pages":{"type":"string"}},"required":["employer_id"]},"example":{"employer_id":9079}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/glassdoor/v1/employer/interviews":{"post":{"operationId":"glassdoor_employer_interviews","summary":"One page of interview reports (questions, difficulty, outcome).","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"employer_id":{"type":"string"},"page":{"type":"string"},"cursor":{"type":"string"},"items_per_page":{"type":"string"},"dynamic_profile_id":{"type":"string"}},"required":["employer_id"]},"example":{"employer_id":9079}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/glassdoor/v1/employer/interviews-harvest":{"post":{"operationId":"glassdoor_employer_interviews_harvest","summary":"Fetch all available Glassdoor interview reports across multiple pages.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"employer_id":{"type":"string"},"dynamic_profile_id":{"type":"string"},"items_per_page":{"type":"string"},"max_pages":{"type":"string"}},"required":["employer_id"]},"example":{"employer_id":9079}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/glassdoor/v1/employer/jobs":{"post":{"operationId":"glassdoor_employer_jobs","summary":"Employer job listings (one page; cursor pagination).","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"employer_id":{"type":"string"},"page":{"type":"string"},"cursor":{"type":"string"},"page_size":{"type":"string"},"page_cursor":{"type":"string"}},"required":["employer_id"]},"example":{"employer_id":9079,"page_size":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/glassdoor/v1/employer/jobs-harvest":{"post":{"operationId":"glassdoor_employer_jobs_harvest","summary":"Fetch all available Glassdoor job listings across multiple pages.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"employer_id":{"type":"string"},"dynamic_profile_id":{"type":"string"},"page_size":{"type":"string"},"max_pages":{"type":"string"}},"required":["employer_id"]},"example":{"employer_id":9079}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/glassdoor/v1/employer/salaries":{"post":{"operationId":"glassdoor_employer_salaries","summary":"Glassdoor salary estimates for this employer, broken down by job title. Each title returns the full pay distribution — base pay and total pay percentiles (P10/P25/P50/P75/P90), median base/total/additional pay, plus cash bonus, stock, profit sharing, sales commission and tips bands. Titles are ordered by number of reported salaries (most-reported first).","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"employer_id":{"type":"string"},"job_title":{"type":"string"},"page":{"type":"string"},"cursor":{"type":"string"},"page_size":{"type":"string"},"pay_period":{"type":"string"}},"required":["employer_id"]},"example":{"employer_id":9079}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/glassdoor/v1/employer/salaries-harvest":{"post":{"operationId":"glassdoor_employer_salaries_harvest","summary":"Fetch salary estimates for all job titles at this employer across multiple pages — every title with its full pay distribution.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"employer_id":{"type":"string"},"job_title":{"type":"string"},"page_size":{"type":"string"},"pay_period":{"type":"string"},"max_pages":{"type":"string"}},"required":["employer_id"]},"example":{"employer_id":9079}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/global-jobs/v1/jobs/search":{"post":{"operationId":"global_jobs_jobs_search","summary":"Search live job listings on Naukri (India), Gupy and Catho (Brazil), or StepStone (Germany & Europe) by job title, keyword and city. Returns each job's title, company, location and link.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"platform":{"type":"string"},"keyword":{"type":"string"},"query":{"type":"string"},"location":{"type":"string"},"max_pages":{"type":"string"},"max_results":{"type":"string"},"page_size":{"type":"string"}},"required":["platform"]},"example":{"platform":"catho","keyword":"analista","max_pages":1}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/global-jobs/v1/jobs/detail":{"post":{"operationId":"global_jobs_jobs_detail","summary":"Get the full details of a single job posting from Naukri, Gupy, Catho or StepStone — job title, company, full description, salary, location and how to apply.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"platform":{"type":"string"},"job_id":{"type":"string"},"job_url":{"type":"string"},"apply_url":{"type":"string"}},"required":["platform"]},"example":{"platform":"catho"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/goat/v1/search":{"post":{"operationId":"goat_search","summary":"Search GOAT for products by keyword. Returns matching products (name, slug, brand image, category) plus related curated collections. Resolves the `slug`/`product_id` you feed into product_detail and prices. `limit` caps results.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"}},"required":["query"]},"example":{"query":"air jordan 4"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/goat/v1/suggest":{"post":{"operationId":"goat_suggest","summary":"Autocomplete suggestions for a partial query — quick product + collection name matches as the customer types. Lighter than search.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"example":{"query":"jordan"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/goat/v1/product_detail":{"post":{"operationId":"goat_product_detail","summary":"Full catalogue record for one product by `slug` / `url` / `product_id`: name, nickname, brand, SKU, colorway, designer, gender, silhouette, release date, season, materials, size range, taxonomy, images, the GOAT display price and the offer floor/ceiling. Pair with `prices` for the live per-size resale grid.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"url":{"type":"string"},"product_id":{"type":"string"}}},"example":{"slug":"air-jordan-1-retro-high-og-chicago-555088-101"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/goat/v1/prices":{"post":{"operationId":"goat_prices","summary":"Live per-size resale price grid for a product (the market-data moat). For each size of the given `condition` it returns the lowest live ask + listing count, plus the cheapest listing overall. Accepts `slug`/`url`/`product_id`. `condition` (used/new_no_defects), `country` set the market. Optional `size` narrows to one size (returns every live listing for it). Honest-empty when nothing is listed.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"url":{"type":"string"},"product_id":{"type":"string"},"condition":{"type":"string"},"country":{"type":"string"},"size":{"type":"string"}}},"example":{"slug":"air-jordan-1-retro-high-og-chicago-555088-101","condition":"used"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/goat/v1/related":{"post":{"operationId":"goat_related","summary":"Products related to one product by `slug`/`url`: GOAT's recommended products plus the brand / category / silhouette grids GOAT surfaces on the page. Catalogue discovery from any starting product.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"url":{"type":"string"}}},"example":{"slug":"air-jordan-1-retro-high-og-chicago-555088-101"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/goodreads/v1/book_detail":{"post":{"operationId":"goodreads_book_detail","summary":"Full book record from Goodreads by book ID or URL: title, author(s), average rating, total ratings & text-reviews counts, 1-5 star distribution, genres, series, ISBN/ISBN-13/ASIN, publisher, publication year, page count, edition count, featured characters & settings, literary awards, retailer buy links, and up to 30 embedded reader reviews.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"reviews_limit":{"type":"string"},"include_pii":{"type":"string"}}},"example":{"id":"2767052"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/goodreads/v1/search":{"post":{"operationId":"goodreads_search","summary":"Search for books or authors on Goodreads by title, author name, or keyword → returns matching results with title, author, ISBN, book ID, average rating, and cover URL.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"example":{"query":"hunger games"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/goodreads/v1/author":{"post":{"operationId":"goodreads_author","summary":"Author profile from Goodreads by author ID or URL: name, average rating, total ratings, birth/death date & place, genres, biography, and a sample of their books.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"}}},"example":{"id":"153394"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/goodreads/v1/author_books":{"post":{"operationId":"goodreads_author_books","summary":"An author's complete bibliography on Goodreads (paginated) by author ID or URL → every book with its title, book ID, average rating, ratings count, cover, and publication year.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"page":{"type":"string"}}},"example":{"id":"153394"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/goodreads/v1/reviews":{"post":{"operationId":"goodreads_reviews","summary":"Fetch reader reviews for a book on Goodreads (by ID or URL) → each review includes the user, star rating, full review text, date, likes count, and spoiler flag. Returns up to 30 reviews per request.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"book_id":{"type":"string"},"include_pii":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/goodreads/v1/series":{"post":{"operationId":"goodreads_series","summary":"A Goodreads book series by series ID or URL → the ordered list of books in the series (title, book ID, URL) plus the primary/total work counts.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"}}},"example":{"id":"73758"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/goodreads/v1/list":{"post":{"operationId":"goodreads_list","summary":"A Goodreads Listopia list by list ID or URL (paginated) → its ranked books with the community score, vote count, and rating for each, plus the list title and total voters.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"page":{"type":"string"}}},"example":{"id":"1"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/goodreads/v1/lists_by_tag":{"post":{"operationId":"goodreads_lists_by_tag","summary":"Discover the most popular Goodreads Listopia lists for a topic tag (e.g. fantasy, romance, classics) — returns matching curated lists you can then pull with `list`.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tag":{"type":"string"},"page":{"type":"string"}},"required":["tag"]},"example":{"tag":"fantasy"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/goodreads/v1/genre":{"post":{"operationId":"goodreads_genre","summary":"The most-read books in a Goodreads genre / shelf this week (e.g. fantasy, mystery, romance, science-fiction, young-adult) → trending books with cover and link.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"genre":{"type":"string"}},"required":["genre"]},"example":{"genre":"fantasy"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/goodreads/v1/quotes":{"post":{"operationId":"goodreads_quotes","summary":"Quotes from Goodreads — either every quote BY an author (author_id) or every quote FROM a book (work_id, found in book_detail.book.work_id). Paginated; each quote has its text, source title, like count, and topic tags.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"author_id":{"type":"string"},"work_id":{"type":"string"},"book_id":{"type":"string"},"id":{"type":"string"},"url":{"type":"string"},"page":{"type":"string"},"include_pii":{"type":"string"}}},"example":{"author_id":"153394"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/google-maps/v1/place/search":{"post":{"operationId":"google_maps_place_search","summary":"Search places by text query with optional lat/lng geo-bias. Returns up to 200 places with name, address, rating, categories, phone, website, coordinates, photos.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"lat":{"type":"string"},"lng":{"type":"string"},"altitude":{"type":"string"},"maxResults":{"type":"string"},"lang":{"type":"string"},"region":{"type":"string"},"include_contacts":{"type":"string"}},"required":["query"]},"example":{"query":"specialty coffee Times Square","lat":40.7589,"lng":-73.9881,"maxResults":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/google-maps/v1/place/detail":{"post":{"operationId":"google_maps_place_detail","summary":"The single richest matching place: name, address, phone, website, rating, total review count, categories, coordinates, opening hours and photos.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"lat":{"type":"string"},"lng":{"type":"string"},"lang":{"type":"string"},"region":{"type":"string"},"include_contacts":{"type":"string"}},"required":["query"]},"example":{"query":"Katz's Delicatessen Manhattan","lat":40.7223,"lng":-73.9874}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/google-maps/v1/place/by-id":{"post":{"operationId":"google_maps_place_by_id","summary":"Fetch a place directly by its Google id — fid (0x…:0x…), place_id or numeric cid — no text query needed. Use the id returned by place/search.","tags":["Reputation & Reviews"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"fid":{"type":"string"},"place_id":{"type":"string"},"cid":{"type":"string"},"query":{"type":"string"},"lat":{"type":"string"},"lng":{"type":"string"},"lang":{"type":"string"},"region":{"type":"string"}}},"example":{"fid":"0x89c2598f7ff4aa09:0x313547e757cb8cea"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/google-maps/v1/place/nearby":{"post":{"operationId":"google_maps_place_nearby","summary":"Find places of a given type near coordinates (e.g. coffee shops, pharmacies, ATMs around a lat/lng). Returns up to 200 nearby places.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lat":{"type":"string"},"lng":{"type":"string"},"type":{"type":"string"},"radius":{"type":"string"},"maxResults":{"type":"string"},"lang":{"type":"string"},"region":{"type":"string"}},"required":["lat","lng","type"]},"example":{"type":"coffee shop","lat":40.7589,"lng":-73.9851,"maxResults":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/google-maps/v1/geocode":{"post":{"operationId":"google_maps_geocode","summary":"Turn an address or place name into coordinates: returns latitude, longitude and the formatted address of the best match.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string"},"lang":{"type":"string"},"region":{"type":"string"}},"required":["address"]},"example":{"address":"350 5th Ave, New York, NY 10118"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/google-maps/v1/place/reviews":{"post":{"operationId":"google_maps_place_reviews","summary":"Public Google reviews for a place — paginated to ALL reviews. Each review carries author name, rating, text, date, photos and the owner's response. Resolve a place by query, or pass its fid/cid/place_id from place/search.","tags":["Reputation & Reviews"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"fid":{"type":"string"},"cid":{"type":"string"},"place_id":{"type":"string"},"sort":{"type":"string"},"max_reviews":{"type":"string"},"cursor":{"type":"string"},"lat":{"type":"string"},"lng":{"type":"string"},"lang":{"type":"string"},"region":{"type":"string"}}},"example":{"query":"Katz's Delicatessen Manhattan","lat":40.7223,"lng":-73.9874,"max_reviews":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/google-maps/v1/place/photos":{"post":{"operationId":"google_maps_place_photos","summary":"Public photos for a place — the featured/hero gallery plus user-uploaded photos attached to reviews. Each is a stable image CDN URL (append '=s800' etc. for a sized variant). Resolve by query or pass an id.","tags":["Reputation & Reviews"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"fid":{"type":"string"},"cid":{"type":"string"},"place_id":{"type":"string"},"lat":{"type":"string"},"lng":{"type":"string"},"lang":{"type":"string"},"region":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/google-maps/v1/place/freshness":{"post":{"operationId":"google_maps_place_freshness","summary":"Monitor a place for changes: returns the current place plus a typed diff vs the snapshot you pass from a previous call (rating/review_count/phone/website/address changes).","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"lat":{"type":"string"},"lng":{"type":"string"},"previous":{"type":"string"},"lang":{"type":"string"},"region":{"type":"string"}},"required":["query"]},"example":{"query":"Katz's Delicatessen Manhattan","lat":40.7223,"lng":-73.9874}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/google-trends/v1/trending_now":{"post":{"operationId":"google_trends_trending_now","summary":"Currently trending searches for a geo (title + approx traffic + news articles)","tags":["Search & SEO"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"geo":{"type":"string"}}},"example":{"geo":"US"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/google-trends/v1/suggest":{"post":{"operationId":"google_trends_suggest","summary":"Keyword autocomplete — candidate topics/entities (the Google Trends suggestion list) so you can pick the right entity (e.g. the 'Apple Inc. — Technology company' topic mid vs the fruit) before querying interest_over_time/related.","tags":["Search & SEO"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string"},"hl":{"type":"string"}},"required":["keyword"]},"example":{"keyword":"bitcoin"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/google-trends/v1/categories":{"post":{"operationId":"google_trends_categories","summary":"List the Google Trends category taxonomy (id + name, hierarchical) so you can find the right `category` id to narrow interest_over_time / related_queries / interest_by_region (e.g. 7=Finance, 5=Computers & Electronics). Optionally filter by a name substring.","tags":["Search & SEO"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/google-trends/v1/realtime_trending":{"post":{"operationId":"google_trends_realtime_trending","summary":"Realtime trending story-clusters for a country (richer than trending_now): each cluster has a title, approximate search-traffic volume, the FULL related-query set, category ids, and an article count. Best for 'what is breaking right now' research.","tags":["Search & SEO"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"geo":{"type":"string"},"hours":{"type":"string"},"limit":{"type":"string"}}},"example":{"geo":"US"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/grailed/v1/search":{"post":{"operationId":"grailed_search","summary":"Search Grailed listings by keyword + filters (designer, category, size, color, condition, department, strata, location, price band) with sorting and pagination. Returns live listings with price, size, condition, designer, photos and a seller summary. The catalog-discovery surface.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"designer":{"type":"string"},"category":{"type":"string"},"category_path":{"type":"string"},"department":{"type":"string"},"size":{"type":"string"},"color":{"type":"string"},"condition":{"type":"string"},"strata":{"type":"string"},"location":{"type":"string"},"price_from":{"type":"string"},"price_to":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"}}},"example":{"query":"stone island","per_page":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/grailed/v1/listing_detail":{"post":{"operationId":"grailed_listing_detail","summary":"Full detail for one listing by `id` or `url`: title, description, price, size (pretty + exact), condition, color, category, all photos, measurements, traits, shipping table, designers, sold price, and a seller summary.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"}}},"example":{"id":"99122353"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/grailed/v1/sold_listings":{"post":{"operationId":"grailed_sold_listings","summary":"Search SOLD listings (resale comps) by keyword + the same filters as search. Each result carries its sold_price and sold_at — the price-history / market-value moat for valuing menswear, streetwear and archive pieces.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"designer":{"type":"string"},"category":{"type":"string"},"department":{"type":"string"},"size":{"type":"string"},"color":{"type":"string"},"condition":{"type":"string"},"strata":{"type":"string"},"price_from":{"type":"string"},"price_to":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"}}},"example":{"query":"supreme","per_page":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/grailed/v1/seller_listings":{"post":{"operationId":"grailed_seller_listings","summary":"All active listings from one seller's storefront by `seller_id`. Same listing shape as search; paginated. Resolve a seller_id from any search/detail result's seller.id.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"seller_id":{"type":"string"},"query":{"type":"string"},"category":{"type":"string"},"designer":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"}},"required":["seller_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/grailed/v1/designers":{"post":{"operationId":"grailed_designers","summary":"Search Grailed's designer/brand directory by name → id, slug, listings_count, logo and departments. Use the returned exact `name` to filter search/sold_listings by designer, and the `slug` for the `designer_detail` action.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"}},"required":["query"]},"example":{"query":"stone"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/grailed/v1/designer_detail":{"post":{"operationId":"grailed_designer_detail","summary":"Designer/brand profile by `slug`: id, title, description, follower count and the exact name to use as a designer filter.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"}},"required":["slug"]},"example":{"slug":"stone-island"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/gumtree/v1/search":{"post":{"operationId":"gumtree_search","summary":"Search Gumtree UK adverts and return paginated listing cards — title, price, location, posted date, images, seller type and attributes. Filter by keyword, area/postcode, category slug, price range, search radius and seller type; sort by newest, price or distance. Fetches up to 50 pages (~1,500 adverts) per call with automatic de-duplication, or pass a full Gumtree search URL.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"market":{"type":"string"},"query":{"type":"string"},"location":{"type":"string"},"category":{"type":"string"},"url":{"type":"string"},"sort":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"distance":{"type":"string"},"seller_type":{"type":"string"},"featured_only":{"type":"string"},"with_photos":{"type":"string"},"max_pages":{"type":"string"},"include_pii":{"type":"string"}}},"example":{"market":"uk","category":"cars-vans-motorbikes","location":"london","max_pages":1}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/gumtree/v1/listing_detail":{"post":{"operationId":"gumtree_listing_detail","summary":"Full advert detail by listing `url` OR numeric `id`: title, full description, price, all photos, every attribute (mileage, year, bedrooms, condition…), map coordinates, location/postcode, category breadcrumbs and the public seller profile (display name, rating, total adverts, ads per category, member-since).","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"market":{"type":"string"},"url":{"type":"string"},"id":{"type":"string"},"include_pii":{"type":"string"}}},"example":{"id":"1801400644"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/gumtree/v1/similar":{"post":{"operationId":"gumtree_similar","summary":"Related / similar adverts for a given listing (by `url` or `id`) — Gumtree's own 'you might also like' recommendations as clean listing cards.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"market":{"type":"string"},"url":{"type":"string"},"id":{"type":"string"},"include_pii":{"type":"string"}}},"example":{"id":"1801880826"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/gumtree/v1/categories":{"post":{"operationId":"gumtree_categories","summary":"Gumtree's full browse tree — the top-level categories (Motors, For Sale, Property, Jobs, Pets, Services, Community) and their sub-categories with slugs and paths. Use the slugs as the `category` parameter of search / filters.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"market":{"type":"string"}}},"example":{"market":"uk"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/gumtree/v1/filters":{"post":{"operationId":"gumtree_filters","summary":"Available filters & facets for a category and/or location: selectable sub-categories (with live advert counts), area / postcode facets (with counts), sort options, search-radius options and the price filter. Lets a caller discover valid category slugs, location values and result sizes before searching.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"market":{"type":"string"},"category":{"type":"string"},"location":{"type":"string"},"query":{"type":"string"}}},"example":{"market":"uk","category":"cars-vans-motorbikes","location":"london"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/gumtree/v1/suggestions":{"post":{"operationId":"gumtree_suggestions","summary":"Keyword suggestions & spelling corrections for a search term — Gumtree's 'did you mean' / related-keyword surface, useful for query expansion and autocomplete-style discovery.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"market":{"type":"string"},"location":{"type":"string"},"category":{"type":"string"}},"required":["query"]},"example":{"market":"uk","query":"sofa"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/guru/v1/search":{"post":{"operationId":"guru_search","summary":"Search live freelance JOBS across the whole Guru.com board. `query` is served SERVER-SIDE via Guru's own skill/keyword path — known skills are canonicalised from the shipped slug dictionary (`nodejs` → `node.js`), unknown terms use Guru's free-text match, and `data.match` reports which. Also browsable by `category`/`skills` and paginated by `offset`. Returns title, description, budget{type,min,max,currency}, skills[], quote count (bids_count), posted date, and url. No client PII.","tags":["Jobs & Hiring"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"category":{"type":"string"},"skills":{"type":"string"},"limit":{"type":"string"},"offset":{"type":"string"}}},"example":{"limit":8}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/guru/v1/project":{"post":{"operationId":"guru_project","summary":"Full detail for one Guru.com job by URL, slug, or numeric id — title, description, budget{type,min,max,currency}, skills[], employment type, posted date, valid-through, and the job's location requirement (country). No client PII.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]},"example":{"id":"https://www.guru.com/jobs/testing-our-cruise-control/2120425"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/guru/v1/user":{"post":{"operationId":"guru_user","summary":"PUBLIC business profile of a Guru.com freelancer/provider by profile URL or handle: display name, headline, country, skills, and rating summary. PII (email/phone/legal-name/address) is NEVER returned.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"}},"required":["username"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/guru/v1/categories":{"post":{"operationId":"guru_categories","summary":"List the top-level Guru.com freelance job categories (Programming, Design, Writing…) — the browse taxonomy for scoping a `search`.","tags":["Jobs & Hiring"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hackernews/v1/item":{"post":{"operationId":"hackernews_item","summary":"single item by id (story/comment/job/poll/pollopt) — all official fields + time_iso/kids_count/hn_url; hydrate_kids=resolve top-level comments","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"hydrate_kids":{"type":"string"},"kids_limit":{"type":"string"}},"required":["id"]},"example":{"id":8863}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hackernews/v1/item_tree":{"post":{"operationId":"hackernews_item_tree","summary":"full nested comment TREE for a story in ONE call; recursive children + descendants count","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]},"example":{"id":8863}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hackernews/v1/user":{"post":{"operationId":"hackernews_user","summary":"user profile by id: karma/created/about/submitted; hydrate_submitted=resolve recent submissions","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"hydrate_submitted":{"type":"string"},"submitted_limit":{"type":"string"}},"required":["id"]},"example":{"id":"pg"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hackernews/v1/stories":{"post":{"operationId":"hackernews_stories","summary":"story-list (list=top/new/best/ask/show/job) → ranked hydrated stories; offset/limit pagination, hydrate=false for ids only","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"list":{"type":"string"},"limit":{"type":"string"},"offset":{"type":"string"},"hydrate":{"type":"string"}}},"example":{"list":"top","limit":15}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hackernews/v1/search":{"post":{"operationId":"hackernews_search","summary":"Full-text search: query + tags(story/comment/ask_hn/show_hn/poll/front_page/author_X/story_X) + min_points/max_points/min_comments/before/after + sort(relevance|date), paginated","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"tags":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"},"hits_per_page":{"type":"string"},"min_points":{"type":"string"},"max_points":{"type":"string"},"min_comments":{"type":"string"},"max_comments":{"type":"string"},"before":{"type":"string"},"after":{"type":"string"},"numeric_filters":{"type":"string"},"restrict":{"type":"string"}}},"example":{"query":"python","tags":"story"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hackernews/v1/poll":{"post":{"operationId":"hackernews_poll","summary":"Poll detail by id: the question + every voting option resolved and ranked by votes, with total_votes and the comment count. (Find poll ids via search with tags=poll.)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]},"example":{"id":126809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hackernews/v1/front_page":{"post":{"operationId":"hackernews_front_page","summary":"Stories that recently made the Hacker News front page (newest-first), paginated. Optional after/before date window. NOTE: the front-page index only retains ~the last 7 days — it is 'what's on / recently hit the front page', not a historical archive.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"string"},"page":{"type":"string"},"after":{"type":"string"},"before":{"type":"string"}}},"example":{"limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hackernews/v1/updates":{"post":{"operationId":"hackernews_updates","summary":"live changefeed: recently changed item ids + profiles + max_item; hydrate=resolve changed items","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"hydrate":{"type":"string"},"limit":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hackernews/v1/max_item":{"post":{"operationId":"hackernews_max_item","summary":"the current largest item id on Hacker News — the newest id, useful for backfilling / id-range walks","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hemnet/v1/search":{"post":{"operationId":"hemnet_search","summary":"Search Hemnet.se for-sale property listings by location, with structured filters: price (SEK), rooms, living area (m²), plot, property type, price-per-m², construction year, keyword and sort. Each result carries asking price, fee, square-metre price, rooms, living area, housing form, coordinates, broker agency, address and photos. Paginate with page.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"},"home_type":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"rooms_min":{"type":"string"},"rooms_max":{"type":"string"},"living_area_min":{"type":"string"},"living_area_max":{"type":"string"},"land_area_min":{"type":"string"},"land_area_max":{"type":"string"},"price_per_m2_min":{"type":"string"},"price_per_m2_max":{"type":"string"},"year_min":{"type":"string"},"year_max":{"type":"string"},"keywords":{"type":"string"}},"required":["location"]},"example":{"location":"Stockholm"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hemnet/v1/sold":{"post":{"operationId":"hemnet_sold","summary":"Recently-SOLD property prices (slutpriser) by location, with the same filters as search — the comparable-sales / price-history surface. Each record carries asking price, FINAL sold price, sold date, price change (%) and square-metre price.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"},"home_type":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"rooms_min":{"type":"string"},"rooms_max":{"type":"string"},"living_area_min":{"type":"string"},"living_area_max":{"type":"string"},"land_area_min":{"type":"string"},"land_area_max":{"type":"string"},"price_per_m2_min":{"type":"string"},"price_per_m2_max":{"type":"string"},"year_min":{"type":"string"},"year_max":{"type":"string"},"keywords":{"type":"string"}},"required":["location"]},"example":{"location":"Malmö"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hemnet/v1/detail":{"post":{"operationId":"hemnet_detail","summary":"Full record for a single listing by its Hemnet listing URL, slug or id (hemnet.se/bostad/). Returns asking price, fee, rooms, living & plot area, construction year, energy class, tenure, the full description, every photo, amenities, days-on-market, view count and any sale history.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]},"example":{"url":"https://www.hemnet.se/bostad/lagenhet-3rum-segevang-malmo-kommun-kronetorpsgatan-52a-21744904"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hemnet/v1/location":{"post":{"operationId":"hemnet_location","summary":"Location resolver / autocomplete — map a free-text Swedish place name to Hemnet locations (city, municipality, county, district, postal area) with their ids. Use it to power a search box or to confirm the exact location a search will use.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"example":{"query":"Göteborg"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hepsiburada/v1/product/detail":{"post":{"operationId":"hepsiburada_product_detail","summary":"Full Hepsiburada product details by `url` or HB code (`sku`): title, brand, price, discount, images, rating, stock, seller (merchant), category, specifications, variants, top reviews, coupon/campaign badges, and all other_offers (every merchant selling the same product).","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"sku":{"type":"string"},"max_rotations":{"type":"string"}}},"example":{"url":"https://www.hepsiburada.com/-p-HBCV00004X9ZCK"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hepsiburada/v1/product/reviews":{"post":{"operationId":"hepsiburada_product_reviews","summary":"Paginated customer reviews for a product by `sku` or `url`. Walk every page with `page` to retrieve ALL reviews. Review authors are pre-masked by Hepsiburada (e.g. 'Ahmet K***') — no PII. ~10 reviews per page.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"sku":{"type":"string"},"url":{"type":"string"},"page":{"type":"string"},"max_rotations":{"type":"string"}}},"example":{"sku":"HBCV00004X9ZCK"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hepsiburada/v1/product/offers":{"post":{"operationId":"hepsiburada_product_offers","summary":"Every merchant listing (buybox + other sellers) for a product by `sku` or `url`: compare price, seller rating, shipping and stock across all sellers of the same item.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"sku":{"type":"string"},"url":{"type":"string"},"max_rotations":{"type":"string"}}},"example":{"sku":"HBCV00004X9ZCK"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hepsiburada/v1/search":{"post":{"operationId":"hepsiburada_search","summary":"Search Hepsiburada products by keyword with optional sort and price/brand filters — returns results with SKU, title, brand, price, list price, rating, image and merchant. Results may be empty for very niche queries; try a broader keyword.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"page":{"type":"string"},"sort":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"brand":{"type":"string"},"max_rotations":{"type":"string"}},"required":["query"]},"example":{"query":"laptop"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hepsiburada/v1/category":{"post":{"operationId":"hepsiburada_category","summary":"Browse a Hepsiburada category page by its path (`category` = '-c-', e.g. 'laptop-notebook-dizustu-bilgisayarlar-c-98') with optional sort/price filters and pagination. Use it to list everything in a category, not just a keyword match.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"page":{"type":"string"},"sort":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"brand":{"type":"string"},"max_rotations":{"type":"string"}},"required":["category"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hepsiburada/v1/seller":{"post":{"operationId":"hepsiburada_seller","summary":"Hepsiburada merchant (mağaza) profile + its product catalogue by store slug (`seller`, e.g. 'jollyshop') or full /magaza/ URL. Returns seller info (name, rating, total product count) and a paginated list of the seller's products.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"seller":{"type":"string"},"page":{"type":"string"},"sort":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"max_rotations":{"type":"string"}},"required":["seller"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/holidays/v1/holidays":{"post":{"operationId":"holidays_holidays","summary":"public holidays for a country + year (full Nager fields + derived year/weekday/nationwide)","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"year":{"type":"string"}},"required":["country","year"]},"example":{"country":"US","year":2026}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/holidays/v1/is_workday":{"post":{"operationId":"holidays_is_workday","summary":"is a given date a working day for a country? (weekend + public-holiday aware; reasons[] explain)","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"date":{"type":"string"},"weekend":{"type":"string"},"types":{"type":"string"},"subdivision":{"type":"string"}},"required":["country","date"]},"example":{"country":"US","date":"2026-01-01"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/holidays/v1/workday_count":{"post":{"operationId":"holidays_workday_count","summary":"business-day count over a date range: workdays/weekend_days/holiday_days + the holidays in range","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"weekend":{"type":"string"},"types":{"type":"string"},"subdivision":{"type":"string"}},"required":["country","start","end"]},"example":{"country":"US","start":"2026-01-01","end":"2026-01-31"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/holidays/v1/next_holidays":{"post":{"operationId":"holidays_next_holidays","summary":"upcoming public holidays (next ~365 days) with daysUntil","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"today":{"type":"string"}},"required":["country"]},"example":{"country":"US"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/holidays/v1/long_weekends":{"post":{"operationId":"holidays_long_weekends","summary":"long-weekend windows for a country + year (+ bridge-day suggestions)","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"year":{"type":"string"}},"required":["country","year"]},"example":{"country":"US","year":2026}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/holidays/v1/countries":{"post":{"operationId":"holidays_countries","summary":"the supported country set (code → name)","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hs-code/v1/hs_lookup":{"post":{"operationId":"hs_code_hs_lookup","summary":"One HS/HTS/commodity code + destination (US|UK) → the official tariff line: description, units, MFN duty rate (+ parsed % when ad-valorem), VAT/GST, special/preference programs, footnotes, schedule version. A 4/6-digit code resolves to its most specific rate-bearing line and lists context.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"destination":{"type":"string"}},"required":["code","destination"]},"example":{"code":"8471.30.0100","destination":"US"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hs-code/v1/classify":{"post":{"operationId":"hs_code_classify","summary":"Product description (+materials) + destination → ranked candidate HS codes with a confidence band, reason, and review_required. Candidates are SUGGESTIONS for a human/broker to confirm — low-confidence candidates are clearly marked, never shown as a settled code.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":"string"},"destination":{"type":"string"},"materials":{"type":"string"},"limit":{"type":"string"},"min_confidence":{"type":"string"}},"required":["description","destination"]},"example":{"description":"leather shoes for men","destination":"US"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hs-code/v1/landed_cost":{"post":{"operationId":"hs_code_landed_cost","summary":"HS code (or description → auto-classified) + destination + value (+origin, currency, shipping) → estimated duty + VAT/GST + total landed cost, with an explicit assumptions[] list and the disclaimer. A simple, honest estimate — NOT a customs quote.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"destination":{"type":"string"},"value":{"type":"string"},"code":{"type":"string"},"description":{"type":"string"},"origin":{"type":"string"},"currency":{"type":"string"},"shipping":{"type":"string"},"materials":{"type":"string"}},"required":["destination","value"]},"example":{"code":"8471300000","destination":"UK","value":1000,"currency":"GBP"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hs-code/v1/schedules_status":{"post":{"operationId":"hs_code_schedules_status","summary":"Freshness + coverage of the underlying official schedules (US HTS revision, UK tariff reachability) — so a caller knows how current the rates are and which markets are live.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hs-code/v1/batch_classify":{"post":{"operationId":"hs_code_batch_classify","summary":"Up to 25 products in one call (discounted). Each item is classified (or looked up if a code is given) independently; one bad item never fails the batch.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"string"},"destination":{"type":"string"},"limit":{"type":"string"},"min_confidence":{"type":"string"}},"required":["items","destination"]},"example":{"items":[{"description":"leather shoes"},{"description":"laptop"}],"destination":"US"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hs-code/v1/browse":{"post":{"operationId":"hs_code_browse","summary":"Navigate the tariff tree without knowing a keyword: list the 21 WCO sections, drill a section → chapters, a chapter (2-digit) → headings, a heading (4-digit) → subheadings/lines, a subheading (6-digit) → national lines. Each node returns its parent breadcrumb + children. The browse companion to keyword `classify`.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"destination":{"type":"string"},"node":{"type":"string"}},"required":["destination"]},"example":{"destination":"US"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hs-code/v1/validate":{"post":{"operationId":"hs_code_validate","summary":"Check whether a code is a real, current tariff code in the chosen market — structural check (4/6/8/10 digits) PLUS live existence in the schedule. A well-formed but unknown code returns valid=false with the nearest valid parent + sibling suggestions, so a caller can correct a typo'd or expired code before filing.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"destination":{"type":"string"}},"required":["code","destination"]},"example":{"code":"8471.30.0100","destination":"US"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/hs-code/v1/cross_country":{"post":{"operationId":"hs_code_cross_country","summary":"One 6-digit HS subheading (the WCO-international level shared by every member country) → the universal HS6 description plus the matching US (USITC HTS) and UK (HMRC) national lines side by side, with each market's duty rate. The same product, compared across the markets we cover — first 6 digits identical worldwide, national 8/10-digit detail differs.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hs6":{"type":"string"}},"required":["hs6"]},"example":{"hs6":"847130"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/idealista/v1/search":{"post":{"operationId":"idealista_search","summary":"Search Idealista property listings by location (Spain, Italy or Portugal; for sale or rent) with structured filters: price (EUR), bedrooms, surface (m²), property type and sort. Each result carries id, title, price, rooms, bathrooms, surface, floor, features and thumbnail. Paginate with page.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"},"country":{"type":"string"},"contract":{"type":"string"},"sort":{"type":"string"},"home_type":{"type":"string"},"page":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"rooms_min":{"type":"string"},"surface_min":{"type":"string"}},"required":["location"]},"example":{"location":"Madrid","country":"es"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/idealista/v1/detail":{"post":{"operationId":"idealista_detail","summary":"Full record for a single listing by its Idealista id (the number in an idealista.com/inmueble// URL, or a search result's `id`). Returns title, price, address, bedrooms, bathrooms, surface, year built, the full feature list, description and all gallery image URLs.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"country":{"type":"string"}},"required":["id"]},"example":{"id":"109592362"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/idealista/v1/geography":{"post":{"operationId":"idealista_geography","summary":"Resolve a free-text place name to the Idealista location slug + a ready-to-use search preview (the count of active listings there). Use it to confirm a location before searching, or to discover the exact slug a city resolves to.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"country":{"type":"string"},"contract":{"type":"string"}},"required":["query"]},"example":{"query":"Madrid","country":"es"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/imdb/v1/search":{"post":{"operationId":"imdb_search","summary":"Search IMDb for movies, TV shows and people by name. Uses IMDb's own type-ahead, so one query returns titles AND people mixed, each with its IMDb id (tt…/nm…), a subtitle, poster image, popularity rank and (for titles) type and year. Use the returned id with the `title`, `person` or `episodes` actions.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"kind":{"type":"string"}},"required":["query"]},"example":{"query":"the matrix"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/imdb/v1/title":{"post":{"operationId":"imdb_title","summary":"Full IMDb title card for one movie or TV show by its tt… id: IMDb user rating and vote count, year(s), runtime, genres, certificate, plot, countries, languages, directors, writers, top cast with character names, poster and popularity rank. For series it also returns the total episode count.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"imdb_id":{"type":"string"}},"required":["imdb_id"]},"example":{"imdb_id":"tt0133093"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/imdb/v1/person":{"post":{"operationId":"imdb_person","summary":"Full IMDb name card for one person by their nm… id: biography, birth/death dates, birthplace, professions, IMDb popularity rank, their best-known titles and a paginated filmography (each credit with the title, year, IMDb rating, the job and — for acting credits — the character played).","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"imdb_id":{"type":"string"},"role":{"type":"string"},"limit":{"type":"string"}},"required":["imdb_id"]},"example":{"imdb_id":"nm0000158"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/imdb/v1/episodes":{"post":{"operationId":"imdb_episodes","summary":"Episode list for a TV series by its tt… id, with each episode's IMDb rating, vote count, air date, season/episode number and plot. Page one season at a time with `season`; meta lists every available season number and the total episode count.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"imdb_id":{"type":"string"},"season":{"type":"string"},"limit":{"type":"string"}},"required":["imdb_id"]},"example":{"imdb_id":"tt0903747","season":1}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/imdb/v1/charts":{"post":{"operationId":"imdb_charts","summary":"An IMDb chart: the Top 250 movies, Top 250 TV, Bottom 100, or a Most-Popular / Top-Rated meter board. Returns ranked titles with their IMDb chart rating, vote count, year, type and poster.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"chart":{"type":"string"},"limit":{"type":"string"}}},"example":{"chart":"top_250","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/imdb/v1/reviews":{"post":{"operationId":"imdb_reviews","summary":"User reviews for a movie or TV show by its tt… id — the full IMDb review text plus the reviewer's star rating, headline, date, spoiler flag and helpful up/down votes. Cursor-paginated: pass the returned `next_cursor` back as `cursor` to walk through every review (titles can have thousands). meta.total reports the full review count.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"imdb_id":{"type":"string"},"sort":{"type":"string"},"cursor":{"type":"string"},"limit":{"type":"string"}},"required":["imdb_id"]},"example":{"imdb_id":"tt0133093","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/imdb/v1/videos":{"post":{"operationId":"imdb_videos","summary":"Trailers and video clips for a movie or TV show by its tt… id, each with a playable MP4 URL (multiple qualities), title, type (Trailer/Clip/Featurette), runtime, description and thumbnail. Note: playback URLs are IMDb-signed and time-limited.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"imdb_id":{"type":"string"},"limit":{"type":"string"}},"required":["imdb_id"]},"example":{"imdb_id":"tt0133093","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/imdb/v1/photos":{"post":{"operationId":"imdb_photos","summary":"Image gallery for a movie or TV show by its tt… id — posters, stills and event photos with full-resolution URLs, dimensions and captions. Cursor-paginated: pass the returned `next_cursor` back as `cursor`. meta.total reports the gallery size.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"imdb_id":{"type":"string"},"cursor":{"type":"string"},"limit":{"type":"string"}},"required":["imdb_id"]},"example":{"imdb_id":"tt0133093","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/imdb/v1/awards":{"post":{"operationId":"imdb_awards","summary":"Awards and nominations for a movie or TV show by its tt… id — Oscars, Golden Globes, BAFTAs, Emmys and more, each with the event, year, category, win/nomination flag and the people nominated. Cursor-paginated; meta.total reports the full count.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"imdb_id":{"type":"string"},"cursor":{"type":"string"},"limit":{"type":"string"}},"required":["imdb_id"]},"example":{"imdb_id":"tt0133093","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/imdb/v1/extras":{"post":{"operationId":"imdb_extras","summary":"Extra IMDb detail for a movie or TV show by its tt… id in one call: trivia, plot keywords, goofs, memorable quotes, alternate titles (AKAs), country release dates, taglines and the parental guide (Sex/Nudity, Violence, Profanity, etc. with severity and example items). Each section is capped by `limit`; section totals are reported.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"imdb_id":{"type":"string"},"limit":{"type":"string"}},"required":["imdb_id"]},"example":{"imdb_id":"tt0133093","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/imdb/v1/credits":{"post":{"operationId":"imdb_credits","summary":"Full cast & crew for a movie or TV show by its tt… id, grouped by department (director, writer, cast, producer, cinematographer, editor, composer, …) — beyond the top-20 cast in `title`. Omit `category` for every department (first N each); pass one `category` to page that department fully with `cursor`.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"imdb_id":{"type":"string"},"category":{"type":"string"},"cursor":{"type":"string"},"limit":{"type":"string"}},"required":["imdb_id"]},"example":{"imdb_id":"tt0133093"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/imdb/v1/person_extras":{"post":{"operationId":"imdb_person_extras","summary":"Extra IMDb detail for a person by their nm… id: their photo gallery (full-res URLs + captions), awards and nominations (with the titles they were for), height and alternate names. Complements `person` (bio + filmography).","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"imdb_id":{"type":"string"},"cursor":{"type":"string"},"limit":{"type":"string"}},"required":["imdb_id"]},"example":{"imdb_id":"nm0634240","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/imdb/v1/whats_new":{"post":{"operationId":"imdb_whats_new","summary":"IMDb's 'what's new' lists: upcoming movies (coming_soon_movies) or TV (coming_soon_tv) with release dates, the weekend box-office top 10 (box_office) with gross earnings, or the currently trending titles (trending). One friendly `list` value picks the board; coming-soon lists are cursor-paginated and region-aware.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"list":{"type":"string"},"region":{"type":"string"},"cursor":{"type":"string"},"limit":{"type":"string"}}},"example":{"list":"box_office"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/immobiliare/v1/search":{"post":{"operationId":"immobiliare_search","summary":"Search Immobiliare.it property listings by location (for sale or for rent), with structured filters: price (EUR), rooms, surface (m²), bathrooms, property type and sort. Each result carries price, rooms, bathrooms, surface, floor, typology, features, agency, map coordinates and the primary photo. Paginate with page.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"},"contract":{"type":"string"},"category":{"type":"string"},"sort":{"type":"string"},"home_type":{"type":"string"},"page":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"rooms_min":{"type":"string"},"rooms_max":{"type":"string"},"surface_min":{"type":"string"},"surface_max":{"type":"string"},"baths_min":{"type":"string"}},"required":["location"]},"example":{"location":"Roma"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/immobiliare/v1/detail":{"post":{"operationId":"immobiliare_detail","summary":"Full record for a single listing by its Immobiliare id (from a search result's `id`, or the number in an immobiliare.it/annunci// URL). Returns every structured field plus all photos at full resolution. Note: the long description text is the portal preview (~600 chars); the complete prose is only on the listing page itself.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"location":{"type":"string"}},"required":["id"]},"example":{"id":"130988676","location":"Roma"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/immobiliare/v1/geography":{"post":{"operationId":"immobiliare_geography","summary":"Location autocomplete — resolve a free-text Italian place name to Immobiliare's geo-ids (comune / province / region) with centre coordinates. Use it to power a search box or to get the exact ids the search needs. Returns ready-to-use search_params for each match.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"example":{"query":"Roma"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/indeed/v1/jobs/search":{"post":{"operationId":"indeed_jobs_search","summary":"Search live job postings on Indeed by keyword and location. Each result includes the full job description, salary range, employer details, posting date, apply link, employment type and remote flag. Filter by job type, remote/hybrid, seniority, posting date and radius. Covers 60+ Indeed country sites.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"country":{"type":"string"},"location":{"type":"string"},"max_results":{"type":"string"},"sort_by":{"type":"string"},"include_detail":{"type":"string"},"job_type":{"type":"string"},"remote":{"type":"string"},"hybrid":{"type":"string"},"level":{"type":"string"},"from_days":{"type":"string"},"radius":{"type":"string"}},"required":["query"]},"example":{"query":"python developer","location":"New York","country":"US","max_results":60}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/indeed/v1/job":{"post":{"operationId":"indeed_job","summary":"Get the full detail of one or more specific jobs by their Indeed job key (or job URL). Returns the complete job description, salary, employer details, location, posting date, skills, benefits and apply link for each. Pass several keys at once to fetch them in a single call.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jobkey":{"type":"string"},"country":{"type":"string"}},"required":["jobkey"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/indeed/v1/company":{"post":{"operationId":"indeed_company","summary":"Look up a company on Indeed: profile (industry, size, revenue, HQ, founded year, description, website), reputation (overall rating, review count, CEO approval) and optionally the company's open jobs.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"string"},"country":{"type":"string"},"include_jobs":{"type":"string"},"max_jobs":{"type":"string"}},"required":["company"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/indeed/v1/company/search":{"post":{"operationId":"indeed_company_search","summary":"Find companies on Indeed by name or keyword (optionally near a location). Returns a ranked list of companies with each one's overall rating, review count, industry sectors, logo and links to its Indeed profile, jobs, reviews and salaries pages.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"country":{"type":"string"},"location":{"type":"string"},"max_results":{"type":"string"}},"required":["query"]},"example":{"query":"software","country":"US","max_results":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/indeed/v1/company/reviews":{"post":{"operationId":"indeed_company_reviews","summary":"Get a company's employee reviews from Indeed (review text, overall rating, the 5 sub-ratings — work/life balance, compensation, management, culture, job security — job title, location and date). Pass the company name or Indeed /cmp slug; paginate with `start`.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"string"},"max_reviews":{"type":"string"},"start":{"type":"string"},"sort":{"type":"string"}},"required":["company"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/indeed/v1/company/salaries":{"post":{"operationId":"indeed_company_salaries","summary":"Get a company's salary breakdown by job title from Indeed (average pay, pay period and the number of salaries reported per role). Pass the company name or Indeed /cmp slug.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"string"}},"required":["company"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/indeed/v1/estimated_salary":{"post":{"operationId":"indeed_estimated_salary","summary":"Estimate the market salary for a job title (optionally in a specific US location) from Indeed's salary data — median/mean/min/max/std + sample size + average cash bonus, plus the top-paying companies, top-paid cities, related job titles and a per-US-state average map. Both the location-specific estimate and the national estimate are returned.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"job_title":{"type":"string"},"location":{"type":"string"}},"required":["job_title"]},"example":{"job_title":"software engineer"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/instagram/v1/profile":{"post":{"operationId":"instagram_profile","summary":"public profile facts and first-page recent posts","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"}},"required":["username"]},"example":{"username":"nike"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/instagram/v1/posts":{"post":{"operationId":"instagram_posts","summary":"public profile grid posts, newest first, with max_id pagination","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"limit":{"type":"string"},"max_id":{"type":"string"},"cursor":{"type":"string"},"rich":{"type":"string"}},"required":["username"]},"example":{"username":"nike"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/instagram/v1/reels":{"post":{"operationId":"instagram_reels","summary":"public profile reels tab, newest first, with max_id pagination","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"limit":{"type":"string"},"max_id":{"type":"string"},"cursor":{"type":"string"}},"required":["username"]},"example":{"username":"nike"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/instagram/v1/similar_accounts":{"post":{"operationId":"instagram_similar_accounts","summary":"public related profiles from web_profile_info","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"limit":{"type":"string"}},"required":["username"]},"example":{"username":"nike"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/instagram/v1/search":{"post":{"operationId":"instagram_search","summary":"topsearch blended public users, hashtags, and places","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/instagram/v1/users_search":{"post":{"operationId":"instagram_users_search","summary":"public user lookup by handle (exact / near-exact match)","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/instagram/v1/hashtag_search":{"post":{"operationId":"instagram_hashtag_search","summary":"topsearch public hashtags only","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/instagram/v1/post_info":{"post":{"operationId":"instagram_post_info","summary":"maximally-complete public post/reel detail by shortcode (URL) or media_id","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"shortcode":{"type":"string"},"media_id":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/instagram/v1/post_comments":{"post":{"operationId":"instagram_post_comments","summary":"public comments for a post/reel by shortcode (URL) or media_id, with CURSOR pagination","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"shortcode":{"type":"string"},"media_id":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/instagram/v1/audio_media":{"post":{"operationId":"instagram_audio_media","summary":"public reels feed that use a given audio/music track, with pagination","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"audio_id":{"type":"string"},"limit":{"type":"string"},"max_id":{"type":"string"},"cursor":{"type":"string"}},"required":["audio_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/internet-archive/v1/search":{"post":{"operationId":"internet_archive_search","summary":"Search archive.org's catalogue. Filter by mediatype (texts/audio/movies/software/image/etree…), collection, creator, subject, language and year range; sort and paginate. Returns items with identifier, title, mediatype, creator, year, downloads, rating, collections and thumbnail/details URLs.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"mediatype":{"type":"string"},"collection":{"type":"string"},"creator":{"type":"string"},"subject":{"type":"string"},"language":{"type":"string"},"year_from":{"type":"string"},"year_to":{"type":"string"},"sort":{"type":"string"},"rows":{"type":"string"},"page":{"type":"string"}}},"example":{"query":"apollo 11"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/internet-archive/v1/item":{"post":{"operationId":"internet_archive_item","summary":"Full metadata for one archive.org item by identifier: title, creator, description, date, publisher, language, subjects, collections, license, rating — plus the COMPLETE file list (name, format, size, duration, source) with direct download URLs, and the item's reviews. Set include_files=false / include_reviews=false to slim the payload.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"identifier":{"type":"string"},"include_files":{"type":"string"},"include_reviews":{"type":"string"},"files_limit":{"type":"string"}},"required":["identifier"]},"example":{"identifier":"OTRR_Dragnet_Singles"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/internet-archive/v1/collection":{"post":{"operationId":"internet_archive_collection","summary":"Browse the items inside an archive.org collection by its identifier (e.g. 'nasa', 'librivoxaudio', 'prelinger', 'GratefulDead'). Same rich item rows as search, paginated and sortable; optionally narrow by mediatype within the collection.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"collection":{"type":"string"},"mediatype":{"type":"string"},"query":{"type":"string"},"sort":{"type":"string"},"rows":{"type":"string"},"page":{"type":"string"}},"required":["collection"]},"example":{"collection":"librivoxaudio"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/internet-archive/v1/reviews":{"post":{"operationId":"internet_archive_reviews","summary":"All public reviews and star ratings for one archive.org item: reviewer handle, star rating (0-5), review title, body and date. Reviews are embedded in the item record, so this returns every review in one call (no pagination needed).","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"identifier":{"type":"string"}},"required":["identifier"]},"example":{"identifier":"OTRR_Dragnet_Singles"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/internet-archive/v1/files":{"post":{"operationId":"internet_archive_files","summary":"Just the downloadable files for one archive.org item (no heavy metadata/reviews): name, format, size, duration, source and a direct download URL for each. Useful for fetching the actual book PDF / MP3 / video / ZIP.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"identifier":{"type":"string"},"format":{"type":"string"},"files_limit":{"type":"string"}},"required":["identifier"]},"example":{"identifier":"OTRR_Dragnet_Singles"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/internet-archive/v1/search_inside":{"post":{"operationId":"internet_archive_search_inside","summary":"Full-text 'search inside' one digitized book on archive.org: find a phrase within the book's OCR text and get the matching snippets with page numbers. The item must be a texts/book item with OCR (most scanned books are).","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"identifier":{"type":"string"},"query":{"type":"string"}},"required":["identifier","query"]},"example":{"identifier":"adventuresoftoms00twaiiala","query":"whitewash"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/ip-geolocation/v1/lookup":{"post":{"operationId":"ip_geolocation_lookup","summary":"geolocate ONE IPv4/IPv6 → country/region/city/lat-lon/timezone/ASN/ISP/org + hosting flag","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ip":{"type":"string"},"lang":{"type":"string"}},"required":["ip"]},"example":{"ip":"8.8.8.8"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/ip-geolocation/v1/batch":{"post":{"operationId":"ip_geolocation_batch","summary":"geolocate up to 100 IPs in one call","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ips":{"type":"string"},"lang":{"type":"string"}},"required":["ips"]},"example":{"ips":["8.8.8.8","1.1.1.1","192.168.0.1","nonsense"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/japan-re/v1/search":{"post":{"operationId":"japan_re_search","summary":"Search SUUMO property listings in any of Japan's 47 prefectures — rentals or homes for sale (used house / used condo / land / new house) — filtered by max price (万円), min area (m²), max station walk-time, building age and a free-text station/area keyword. Paginate with page + max_pages.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prefecture":{"type":"string"},"listing_type":{"type":"string"},"page":{"type":"string"},"max_pages":{"type":"string"},"max_price_man":{"type":"string"},"min_area_m2":{"type":"string"},"max_walk_minutes":{"type":"string"},"building_age":{"type":"string"},"keyword":{"type":"string"}},"required":["prefecture"]},"example":{"prefecture":"tokyo","listing_type":"rent","max_pages":1}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/japan-re/v1/detail":{"post":{"operationId":"japan_re_detail","summary":"Full detail for one SUUMO listing — rent/deposit/key-money or sale price, madori layout, floor area, floor, orientation, building structure & age, station access and the photo gallery. For RENT pass listing_id; for SALE pass the listing's `url` from a search result (SUUMO sale pages have no id-only URL). listing_type picks the right parser.","tags":["Real Estate"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"listing_id":{"type":"string"},"url":{"type":"string"},"listing_type":{"type":"string"}}},"example":{"listing_id":"000109252250"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/japan-re/v1/areas":{"post":{"operationId":"japan_re_areas","summary":"List Japan's 47 prefectures with their romaji slug, kanji name and SUUMO region/JIS codes — use it to discover or validate the `prefecture` value before searching. Pass an optional query to filter by name.","tags":["Real Estate"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/japan-re/v1/listings/search":{"post":{"operationId":"japan_re_listings_search","summary":"Legacy name for `search`, kept so older integrations keep working. It runs the exact same code and returns the exact same body (verified byte-for-byte, 2026-08-28). New code should call `search`.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prefecture":{"type":"string"},"listing_type":{"type":"string"},"page":{"type":"string"},"max_pages":{"type":"string"},"max_price_man":{"type":"string"},"min_area_m2":{"type":"string"},"max_walk_minutes":{"type":"string"},"building_age":{"type":"string"},"keyword":{"type":"string"}},"required":["prefecture"]},"example":{"prefecture":"tokyo"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/japan-re/v1/listings/detail":{"post":{"operationId":"japan_re_listings_detail","summary":"Legacy name for `detail`, kept so older integrations keep working. It runs the exact same code and returns the exact same body. New code should call `detail`.","tags":["Real Estate"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"listing_id":{"type":"string"},"url":{"type":"string"},"listing_type":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/kleinanzeigen/v1/search":{"post":{"operationId":"kleinanzeigen_search","summary":"Search Kleinanzeigen classifieds by keyword and/or category with price, location + radius, seller-type and sort filters. Returns normalized listings (title, price, photos, location, seller type) with the true total. Page pagination.","tags":["Classifieds & Second-hand"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"category_id":{"type":"string"},"category_slug":{"type":"string"},"location_id":{"type":"string"},"radius":{"type":"string"},"location":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"seller_type":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"}}},"example":{"query":"iphone"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/kleinanzeigen/v1/listing":{"post":{"operationId":"kleinanzeigen_listing","summary":"Full listing detail by url, slug or adid: title, price, description, all photos, attributes (e.g. car specs), category breadcrumb, seller id & badges, posted date.","tags":["Classifieds & Second-hand"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string"},"adid":{"type":"string"}}},"example":{"url":"https://www.kleinanzeigen.de/s-anzeige/.../3372412834-173-1563"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/kleinanzeigen/v1/similar":{"post":{"operationId":"kleinanzeigen_similar","summary":"Related/similar listings shown on an ad's detail page (\"Das könnte dich auch interessieren\") — by url, slug or adid.","tags":["Classifieds & Second-hand"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string"},"adid":{"type":"string"}}},"example":{"adid":308066172}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/kleinanzeigen/v1/categories":{"post":{"operationId":"kleinanzeigen_categories","summary":"Full Kleinanzeigen category tree (id, name, nested children) for discovering category_id values to use in search.","tags":["Classifieds & Second-hand"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/kleinanzeigen/v1/filters":{"post":{"operationId":"kleinanzeigen_filters","summary":"Live filter facets for a query/category from the search filter tree: category, location (state) and attribute facets, each with a result count — so you know which filter values are available and how many listings match.","tags":["Classifieds & Second-hand"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"category_id":{"type":"string"}}},"example":{"query":"iphone"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/kleinanzeigen/v1/location_suggestions":{"post":{"operationId":"kleinanzeigen_location_suggestions","summary":"Autocomplete location names + ids for a partial query — use the returned location_id with search's location_id + radius.","tags":["Classifieds & Second-hand"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"example":{"query":"Berlin"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/kleinanzeigen/v1/user_listings":{"post":{"operationId":"kleinanzeigen_user_listings","summary":"All active listings for a seller (by user/seller id), with page pagination.","tags":["Classifieds & Second-hand"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string"},"page":{"type":"string"}},"required":["user_id"]},"example":{"user_id":92546099}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/kleinanzeigen/v1/seller":{"post":{"operationId":"kleinanzeigen_seller","summary":"Public seller profile by user/seller id: display name (redacted by default), member since, reputation badges, rating count, and listing count.","tags":["Classifieds & Second-hand"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string"}},"required":["user_id"]},"example":{"user_id":92546099}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/lei/v1/lookup":{"post":{"operationId":"lei_lookup","summary":"One LEI → the full verified legal-entity record (Level-1 who-is-who): legal name, addresses, jurisdiction, legal form, registration status + honesty note, authority ids, renewal dates, BIC/ISIN-adjacent identifiers.","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lei":{"type":"string"},"resolve_codes":{"type":"string"},"history":{"type":"string"}},"required":["lei"]},"example":{"lei":"HWUPKR0MPOU8FGXBT394"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/lei/v1/search":{"post":{"operationId":"lei_search","summary":"Company name → ranked candidate entities with match_confidence for disambiguation (same-name entities across countries/legal-forms). Filters: country, status, jurisdiction, entity_status.","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"scope":{"type":"string"},"country":{"type":"string"},"status":{"type":"string"},"entity_status":{"type":"string"},"jurisdiction":{"type":"string"},"limit":{"type":"string"},"page":{"type":"string"},"min_confidence":{"type":"string"},"typo":{"type":"string"}},"required":["name"]},"example":{"name":"Apple Inc","country":"US"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/lei/v1/autocomplete":{"post":{"operationId":"lei_autocomplete","summary":"Type-ahead suggestions for a partial company name (GLEIF autocompletions surface) — each suggestion carries its LEI for direct lookup.","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]},"example":{"name":"apple"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/lei/v1/relationships":{"post":{"operationId":"lei_relationships","summary":"One LEI → Level-2 corporate hierarchy: direct & ultimate parent (entity OR the entity's declared reporting-exception with reason+meaning OR no_data), children list + total counts. detail=true adds the auditable relationship provenance.","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lei":{"type":"string"},"children_limit":{"type":"string"},"detail":{"type":"string"}},"required":["lei"]},"example":{"lei":"5493006MHB84DD0ZWV18"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/lei/v1/map":{"post":{"operationId":"lei_map","summary":"Identifier mapping: ISIN / BIC / MIC / QCC / S&P-Global-ID → LEI record(s), or reverse LEI → all its ISINs.","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"value":{"type":"string"},"limit":{"type":"string"}},"required":["type","value"]},"example":{"type":"isin","value":"US0378331005"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/lei/v1/reference":{"post":{"operationId":"lei_reference","summary":"GLEIF reference collections: ISO-20275 legal forms, registration authorities, LEI issuers (LOUs), jurisdictions, countries, regions, field catalog — list or fetch one by code.","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"limit":{"type":"string"},"page":{"type":"string"}},"required":["kind"]},"example":{"kind":"legal-forms"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/lei/v1/batch":{"post":{"operationId":"lei_batch","summary":"Up to 50 mixed lookup/search items in one call. Lookups are collapsed into one upstream request per 50 LEIs (GLEIF rate-friendly); searches are spaced.","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"string"}},"required":["items"]},"example":{"items":[{"type":"lookup","lei":"HWUPKR0MPOU8FGXBT394"},{"type":"search","name":"Deutsche Bank","country":"DE"}]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/letterboxd/v1/film":{"post":{"operationId":"letterboxd_film","summary":"Full Letterboxd film detail by film slug or URL: title, year, directors, cast, genres, runtime, poster, IMDb/TMDb IDs, average rating, total ratings, watch count, like count, and list appearances.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"film":{"type":"string"},"film_slug":{"type":"string"},"url":{"type":"string"}}},"example":{"film":"parasite-2019"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/letterboxd/v1/user":{"post":{"operationId":"letterboxd_user","summary":"Public Letterboxd member profile and stats by username: display name, avatar, bio, film/list/follower counts, and the member's favourite films.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"string"}},"required":["user"]},"example":{"user":"dave"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/letterboxd/v1/user_films":{"post":{"operationId":"letterboxd_user_films","summary":"Paginated list of films a Letterboxd member has watched and rated, with their personal star rating for each.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"}},"required":["user"]},"example":{"user":"dave"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/letterboxd/v1/user_diary":{"post":{"operationId":"letterboxd_user_diary","summary":"Paginated diary entries for a Letterboxd member: film slug, name, watch date, and star rating for each viewing.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"}},"required":["user"]},"example":{"user":"dave"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/letterboxd/v1/list":{"post":{"operationId":"letterboxd_list","summary":"A public Letterboxd curated film list: title, description, and the paginated film entries with user ratings.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"string"},"list":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"}},"required":["user","list"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/letterboxd/v1/film_reviews":{"post":{"operationId":"letterboxd_film_reviews","summary":"Paginated public reviews for a Letterboxd film: reviewer username, display name, star rating, review text, and like count.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"film":{"type":"string"},"film_slug":{"type":"string"},"url":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/letterboxd/v1/browse":{"post":{"operationId":"letterboxd_browse","summary":"Browse Letterboxd films with optional genre / decade / year filters, ordered by popularity, rating, release date, or runtime (paginated): slug, name, URL, and average rating.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"sort":{"type":"string"},"genre":{"type":"string"},"decade":{"type":"string"},"year":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/letterboxd/v1/film_similar":{"post":{"operationId":"letterboxd_film_similar","summary":"Films Letterboxd shows as similar/related to a given film: slug, name, URL — useful for recommendation and discovery off a single seed film.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"film":{"type":"string"},"film_slug":{"type":"string"},"url":{"type":"string"}}},"example":{"film":"parasite-2019"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/letterboxd/v1/lists_popular":{"post":{"operationId":"letterboxd_lists_popular","summary":"Browse Letterboxd's most popular member-curated film lists for a time window (week/month/year/all): list title, owner username, list slug+URL, and a preview of the first films.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"period":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/letterboxd/v1/user_lists":{"post":{"operationId":"letterboxd_user_lists","summary":"The public film lists a Letterboxd member has created (paginated): list title, slug+URL, and a preview of the first films in each list.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"}},"required":["user"]},"example":{"user":"dave"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/letterboxd/v1/search":{"post":{"operationId":"letterboxd_search","summary":"Search Letterboxd for films, members, or curated lists by keyword — returns matching results with ratings and links.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"type":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"}},"required":["query"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/levels-fyi/v1/company/salaries":{"post":{"operationId":"levels_fyi_company_salaries","summary":"The flagship action: full Levels.fyi compensation breakdown for one company + role. Returns the level ladder (L3/L4/…), per-level averages (base / stock / bonus / total), the percentile bands (P10/P25/P50/P75/P90 for total-comp, base, bonus and stock), the median offer (with years of experience), the role's sub-specializations and a sample of recent salary submissions. Pass an optional `location` to scope to a metro.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"string"},"role":{"type":"string"},"location":{"type":"string"}},"required":["company","role"]},"example":{"company":"google","role":"software-engineer"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/levels-fyi/v1/company/roles":{"post":{"operationId":"levels_fyi_company_roles","summary":"Resolve a company to its Levels.fyi profile (id, slug, website, employee count, HQ, vesting schedule…) plus the catalog of job-family role slugs you can query for it. Use this to confirm a company's slug and pick a role slug to feed into company/salaries. NOTE: the role list is the full Levels.fyi job-family catalog (the roles available to query) — for the roles a company actually has reported data for, read `related_roles` from a company/salaries response.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"string"}},"required":["company"]},"example":{"company":"stripe"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/levels-fyi/v1/company/search":{"post":{"operationId":"levels_fyi_company_search","summary":"Find companies on Levels.fyi by name. Returns matching companies with the slug and a ready-to-use salaries URL — feed the slug into company/roles or company/salaries.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"}},"required":["query"]},"example":{"query":"goldman"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/levels-fyi/v1/role/companies":{"post":{"operationId":"levels_fyi_role_companies","summary":"For a given role/title, list every company that reports compensation data for it on Levels.fyi (the role's coverage), plus the country-wide median total-comp and the full job-family catalog. Useful for 'which companies pay for ' and leaderboard-style discovery.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"role":{"type":"string"},"limit":{"type":"string"}},"required":["role"]},"example":{"role":"software-engineer"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/levels-fyi/v1/submissions":{"post":{"operationId":"levels_fyi_submissions","summary":"Paginated individual salary submissions for a company + role — the raw anonymized datapoints behind the averages: level, focus, years of experience, location, base / stock / bonus / total comp and offer date. 50 per page; page with `page`.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"string"},"role":{"type":"string"},"location":{"type":"string"},"page":{"type":"string"}},"required":["company","role"]},"example":{"company":"google","role":"software-engineer"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/linkedin-jobs/v1/jobs/search":{"post":{"operationId":"linkedin_jobs_jobs_search","summary":"Search public LinkedIn job postings by keywords, with optional location and date/seniority/job-type/workplace filters.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keywords":{"type":"string"},"location":{"type":"string"},"max_results":{"type":"string"},"date_posted":{"type":"string"},"experience":{"type":"string"},"job_type":{"type":"string"},"workplace":{"type":"string"},"industry":{"type":"string"},"job_function":{"type":"string"},"salary_min":{"type":"string"},"salary_band":{"type":"string"},"company":{"type":"string"},"include_detail":{"type":"string"},"include_company":{"type":"string"},"page":{"type":"string"},"cursor":{"type":"string"},"start":{"type":"string"},"geoId":{"type":"string"},"filters":{"type":"string"},"detail_concurrency":{"type":"string"}},"required":["keywords"]},"example":{"keywords":"python developer","location":"United States","max_results":25}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/linkedin-jobs/v1/jobs/detail":{"post":{"operationId":"linkedin_jobs_jobs_detail","summary":"Full posting for one job: description, employment type, seniority, salary, applicant count.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string"},"include_company":{"type":"string"}},"required":["job_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/linkedin-jobs/v1/company":{"post":{"operationId":"linkedin_jobs_company","summary":"Company profile: description, website, employee count, industry, HQ, founded year, specialties.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"string"}},"required":["company"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/linkedin-jobs/v1/jobs/by-company":{"post":{"operationId":"linkedin_jobs_jobs_by_company","summary":"All public job postings at a specific company — pass a company slug, URL or numeric id; optionally narrow with the same keyword/location/date/seniority/job-type/workplace filters as jobs/search.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"string"},"keywords":{"type":"string"},"location":{"type":"string"},"max_results":{"type":"string"},"date_posted":{"type":"string"},"experience":{"type":"string"},"job_type":{"type":"string"},"workplace":{"type":"string"},"industry":{"type":"string"},"job_function":{"type":"string"},"salary_min":{"type":"string"},"salary_band":{"type":"string"},"include_detail":{"type":"string"},"include_company":{"type":"string"},"page":{"type":"string"},"cursor":{"type":"string"},"start":{"type":"string"},"geoId":{"type":"string"},"filters":{"type":"string"},"detail_concurrency":{"type":"string"}},"required":["company"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/linkedin-jobs/v1/locations/search":{"post":{"operationId":"linkedin_jobs_locations_search","summary":"Location typeahead → resolve a place name (city, region, metro area, country) to the LinkedIn numeric geoId used by the `geoId` search param for precise geo-pinned searches.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/linkedin-jobs/v1/jobs/similar":{"post":{"operationId":"linkedin_jobs_jobs_similar","summary":"Related job postings for a given job_id. LinkedIn's guest surface exposes no direct similar-jobs feed, so results are a keyword+location re-search seeded from the source job's own title (the seed job is excluded).","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string"},"keywords":{"type":"string"},"location":{"type":"string"},"max_results":{"type":"string"},"include_detail":{"type":"string"},"include_company":{"type":"string"}},"required":["job_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/listennotes/v1/search":{"post":{"operationId":"listennotes_search","summary":"Search Listen Notes for podcasts by keyword. Returns up to 10 matching podcasts with title, publisher, cover image and the podcast id (feed into `podcast` for full details).","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"example":{"query":"startup"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/listennotes/v1/podcast":{"post":{"operationId":"listennotes_podcast","summary":"Full detail for one podcast by id (from search) or a Listen Notes podcast URL: title, publisher, description, cover art, language, country, genres, hosts, rating, total episode count, social links and its latest episodes.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"}}},"example":{"id":"xp7nhsmSkX2"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/listennotes/v1/episode":{"post":{"operationId":"listennotes_episode","summary":"Full detail for one episode by id or a Listen Notes episode URL: title, description, audio URL, duration, publish date, cover art and the parent podcast.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"}}},"example":{"id":"5d3f3a3fc4534c2ca63c3245f8c2b894"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/listennotes/v1/best_podcasts":{"post":{"operationId":"listennotes_best_podcasts","summary":"The curated 'best podcasts' list for a country, paginated. Each entry has the podcast title, publisher, cover image, id, Listen Score and global rank.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"string"},"page":{"type":"string"}}},"example":{"region":"us"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/listennotes/v1/genre":{"post":{"operationId":"listennotes_genre","summary":"Browse the best podcasts in a genre, paginated. Use the `genres` action to get the genre id → name list. Each entry has title, publisher, image, id, Listen Score and global rank.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"genre_id":{"type":"string"},"page":{"type":"string"}},"required":["genre_id"]},"example":{"genre_id":93}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/listennotes/v1/genres":{"post":{"operationId":"listennotes_genres","summary":"The complete Listen Notes genre taxonomy — every genre id mapped to its name. These ids are the input vocabulary for the `genre` action.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/made-in-china/v1/rfq_search":{"post":{"operationId":"made_in_china_rfq_search","summary":"Search live buying requests posted by Made-in-China buyers — the demand side of the marketplace. Each row is a purchase someone is asking for right now: their FULL request text (this board does not truncate it), how many they want, which country they are buying from, the day they posted and the day the request expires. Filter by keyword, category, buyer country and recency; page through up to 100 requests per call. Omit `query` to browse the whole open board.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"category":{"type":"string"},"buyer_country":{"type":"string"},"posted_within":{"type":"string"},"page":{"type":"string"},"limit":{"type":"string"},"include_expired":{"type":"string"}}},"example":{"query":"solar panel"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/made-in-china/v1/categories":{"post":{"operationId":"made_in_china_categories","summary":"The 27 top-level sourcing categories of the buying-request board, with the ids that `rfq_search`'s `category` parameter takes. Read live from the board's own category rail, so a new or renamed category appears without a code change.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/magiceden/v1/collections":{"post":{"operationId":"magiceden_collections","summary":"Browse Magic Eden collections (paginated). Each: symbol, name, description, image, categories and social links. Use the returned symbol with the other actions. Offset pagination via the `page` param.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"page":{"type":"string"},"limit":{"type":"string"}}},"example":{"limit":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/magiceden/v1/collection":{"post":{"operationId":"magiceden_collection","summary":"Full collection detail by symbol: metadata (name, description, image, categories, social links) merged with live market stats — floor price (SOL), listed count, 24h average sale price and all-time volume.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"okay_bears"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/magiceden/v1/stats":{"post":{"operationId":"magiceden_stats","summary":"Live market stats for a collection: floor price (SOL), number of NFTs currently listed, 24-hour average sale price and all-time trading volume.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"okay_bears"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/magiceden/v1/listings":{"post":{"operationId":"magiceden_listings","summary":"Active NFT listings in a collection (NFTs currently for sale), cheapest first. Each: token mint, name, price (SOL), seller, rarity rank (Moonrank + HowRare), image and traits. Optional min/max price filter (SOL). Offset pagination via `page`.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"page":{"type":"string"},"limit":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"okay_bears","limit":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/magiceden/v1/tokens":{"post":{"operationId":"magiceden_tokens","summary":"All tokens (NFTs) in a collection (listed or not), paginated. Each: mint address, name, owner, image, list status, price if listed, and traits. Offset pagination via `page`.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"page":{"type":"string"},"limit":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"okay_bears"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/magiceden/v1/token":{"post":{"operationId":"magiceden_token","summary":"Single NFT / token detail by its Solana mint address: name, collection, current owner, image, all traits, list status and price if listed. Get a mint address from a listings[], tokens[] or activity[] row.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mint_address":{"type":"string"}},"required":["mint_address"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/magiceden/v1/token_activity":{"post":{"operationId":"magiceden_token_activity","summary":"On-chain activity history for a single NFT by mint address: every sale, listing, delisting and bid with type, price (SOL), buyer / seller and block time. Offset pagination via `page`.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mint_address":{"type":"string"},"page":{"type":"string"},"limit":{"type":"string"}},"required":["mint_address"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/magiceden/v1/activity":{"post":{"operationId":"magiceden_activity","summary":"Recent on-chain activity for a collection: sales, listings, delistings and bids. Each event: type, price (SOL), buyer / seller, token mint and block time. Filter by event type (default: all). Offset pagination via `page`.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"page":{"type":"string"},"limit":{"type":"string"},"event_type":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"okay_bears","limit":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/magiceden/v1/attributes":{"post":{"operationId":"magiceden_attributes","summary":"Trait floor prices for a collection — for every trait value (e.g. Background = Yellow), the floor price (SOL) and how many NFTs carry it. Useful for trait-based valuation.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"]},"example":{"symbol":"okay_bears"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/magiceden/v1/wallet":{"post":{"operationId":"magiceden_wallet","summary":"NFTs held by a Solana wallet address: each token's mint, name, collection, image, list status and price if listed. Offset pagination via `page`.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string"},"page":{"type":"string"},"limit":{"type":"string"}},"required":["address"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/magiceden/v1/popular":{"post":{"operationId":"magiceden_popular","summary":"Popular / trending Magic Eden collections over a time window — the marketplace leaderboard. Each: symbol, name, floor price (SOL) and all-time volume. Choose a window (1h / 1d / 7d / 30d).","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"time_range":{"type":"string"},"limit":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/magiceden/v1/launchpad":{"post":{"operationId":"magiceden_launchpad","summary":"Magic Eden Launchpad collections — upcoming and live primary mints. Each: symbol, name, mint price (SOL), supply size, launch datetime, chain and contract. Offset pagination via `page`.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"page":{"type":"string"},"limit":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/magiceden/v1/search":{"post":{"operationId":"magiceden_search","summary":"Search Magic Eden collections by free-text name. Resolves a name to its collection symbol(s): first tries an exact symbol match, then scans popular collections and collection pages for a name/symbol substring match. Returns matching collections (symbol, name, image, categories) — use the returned symbol with the other actions.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"}},"required":["query"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/marktplaats/v1/search":{"post":{"operationId":"marktplaats_search","summary":"Keyword or category search with filters, sort, location, offset pagination (limit=30).","tags":["Classifieds & Second-hand"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"site":{"type":"string"},"l1_category_id":{"type":"string"},"l2_category_id":{"type":"string"},"sort_by":{"type":"string"},"sort_order":{"type":"string"},"price_from":{"type":"string"},"price_to":{"type":"string"},"postcode":{"type":"string"},"distance_meters":{"type":"string"},"offset":{"type":"string"}}},"example":{"query":"iphone","site":"nl"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/marktplaats/v1/listing":{"post":{"operationId":"marktplaats_listing","summary":"Listing detail by item_id and/or vip_url; enriched with full product details (price, availability, specs).","tags":["Classifieds & Second-hand"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"item_id":{"type":"string"},"vip_url":{"type":"string"},"site":{"type":"string"}}},"example":{"vip_url":"/v/telecommunicatie/mobiele-telefoons-apple-iphone/a1517165634-apple-iphone-14-128gb-4-gratis-accessoires-accu-tot-100","site":"nl"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/marktplaats/v1/categories":{"post":{"operationId":"marktplaats_categories","summary":"Category tree from search facets, or browse a category (l1/l2) with listings.","tags":["Classifieds & Second-hand"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"site":{"type":"string"},"l1_category_id":{"type":"string"},"l2_category_id":{"type":"string"},"offset":{"type":"string"}}},"example":{"site":"nl"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/marktplaats/v1/seller_listings":{"post":{"operationId":"marktplaats_seller_listings","summary":"Active listings for a seller; offset pagination via seller-name LRP search (name auto-resolved from profile when omitted).","tags":["Classifieds & Second-hand"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"seller_id":{"type":"string"},"seller_name":{"type":"string"},"site":{"type":"string"},"offset":{"type":"string"}},"required":["seller_id"]},"example":{"seller_id":57429132,"seller_name":"Mobisite.nl","site":"nl"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/mcp-registry/v1/search":{"post":{"operationId":"mcp_registry_search","summary":"Normalized cross-registry search over the Official MCP Registry, Glama and Smithery (and skills via GitHub). Dedups the same server across registries by canonical GitHub repo and returns cross-registry presence.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"type":{"type":"string"},"source":{"type":"string"},"sort":{"type":"string"},"limit":{"type":"string"}},"required":["query"]},"example":{"query":"filesystem","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/mcp-registry/v1/server_detail":{"post":{"operationId":"mcp_registry_server_detail","summary":"Full merged profile for one MCP server across every registry it appears in: manifest (tools/capabilities/transport), install paths (packages/remotes/connections), license, GitHub repo health, and cross-registry presence (how many registries list it = trust signal).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"repo_health":{"type":"string"}},"required":["id"]},"example":{"id":"github.com/modelcontextprotocol/servers"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/mcp-registry/v1/skill_detail":{"post":{"operationId":"mcp_registry_skill_detail","summary":"Metadata for one agent-skill repo (GitHub-backed). Fetches the repo + its SKILL.md frontmatter (name/description/license) + repo health.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]},"example":{"id":"github.com/modelcontextprotocol/servers"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/mcp-registry/v1/security_signals":{"post":{"operationId":"mcp_registry_security_signals","summary":"HEURISTIC risk signals for an MCP server (NOT a safe/unsafe certification). Flags permission breadth (fs/network/exec), credential/env-var requests, repo health (archived/low-adoption), prompt-injection patterns in description/manifest, and corroboration (cross-registry presence). Always returns a disclaimer.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]},"example":{"id":"github.com/modelcontextprotocol/servers"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/mcp-registry/v1/trending":{"post":{"operationId":"mcp_registry_trending","summary":"New / rising entries. MCP: most-used servers on Smithery + latest on the Official registry. Skills: recently-created GitHub skill repos.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"limit":{"type":"string"}}},"example":{"type":"mcp","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/mcp-registry/v1/list_sources":{"post":{"operationId":"mcp_registry_list_sources","summary":"The registries this engine aggregates, their roles, auth status and live reachability. Free.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/medium/v1/user":{"post":{"operationId":"medium_user","summary":"Public Medium user profile by username.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"string"}},"required":["user"]},"example":{"user":"dhh"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/medium/v1/user_id":{"post":{"operationId":"medium_user_id","summary":"Resolve username to Medium userId.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"string"}},"required":["user"]},"example":{"user":"dhh"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/medium/v1/user_articles":{"post":{"operationId":"medium_user_articles","summary":"An author's published articles, newest first, with deep pagination.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["user"]},"example":{"user":"dhh"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/medium/v1/user_top_articles":{"post":{"operationId":"medium_user_top_articles","summary":"User articles sorted by clap count from profile references.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"string"},"limit":{"type":"string"}},"required":["user"]},"example":{"user":"dhh"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/medium/v1/article":{"post":{"operationId":"medium_article","summary":"Article metadata by url or id.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"id":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/medium/v1/article_content":{"post":{"operationId":"medium_article_content","summary":"Article plain-text body from bodyModel paragraphs.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"id":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/medium/v1/article_html":{"post":{"operationId":"medium_article_html","summary":"Article HTML body from bodyModel paragraphs.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"id":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/medium/v1/article_markdown":{"post":{"operationId":"medium_article_markdown","summary":"Article markdown body from bodyModel paragraphs.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"id":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/medium/v1/article_responses":{"post":{"operationId":"medium_article_responses","summary":"Public responses/comments for an article.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"id":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/medium/v1/publication":{"post":{"operationId":"medium_publication","summary":"Publication/collection metadata by slug.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"}},"required":["slug"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/medium/v1/publication_id":{"post":{"operationId":"medium_publication_id","summary":"Resolve publication slug to collection id.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"}},"required":["slug"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/medium/v1/publication_articles":{"post":{"operationId":"medium_publication_articles","summary":"A publication's articles, newest first, with deep pagination.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["slug"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/medium/v1/tag":{"post":{"operationId":"medium_tag","summary":"Latest posts for a topic tag (the tag/topic feed).","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tag":{"type":"string"},"limit":{"type":"string"}},"required":["tag"]},"example":{"tag":"python"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/medium/v1/search_users":{"post":{"operationId":"medium_search_users","summary":"Look up an author by exact username. (Medium gates fuzzy people-search behind a logged-in JS app, so this resolves q as a username and returns that profile.)","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"}},"required":["q"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/medium/v1/search_publications":{"post":{"operationId":"medium_search_publications","summary":"Look up a publication by exact slug. (Fuzzy publication search is login/JS-gated on Medium, so this resolves q as a publication slug and returns that publication.)","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"}},"required":["q"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/medium/v1/search_tags":{"post":{"operationId":"medium_search_tags","summary":"Check whether a topic tag exists and is active on Medium (resolves q as a tag slug).","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"}},"required":["q"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/medium/v1/followers":{"post":{"operationId":"medium_followers","summary":"An author's followers (paginated). Identify the author by 'user' or 'user_id'.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"string"},"user_id":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/medium/v1/following":{"post":{"operationId":"medium_following","summary":"The authors a user follows (paginated). Identify the user by 'user' or 'user_id'.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"string"},"user_id":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/medium/v1/list":{"post":{"operationId":"medium_list","summary":"Reading list metadata and articles from public list page HTML. Provide the full list 'url', or 'id' together with 'user'.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"user":{"type":"string"},"username":{"type":"string"},"slug":{"type":"string"},"limit":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/medium/v1/search_articles":{"post":{"operationId":"medium_search_articles","summary":"Search Medium articles by keyword — returns matching articles with title, URL and publication details from medium.com.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["q"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/meetup/v1/search":{"post":{"operationId":"meetup_search","summary":"Discover upcoming events near a city. Filter by event type (in-person or online) and by date window, paginated. Returns each event's name, date, venue with coordinates, RSVP count, fee, image and the hosting group. (Meetup's logged-out discovery feed is location-based — pass a city; for a specific topic, browse a relevant group's events.)","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"},"event_type":{"type":"string"},"date":{"type":"string"},"radius":{"type":"string"},"cursor":{"type":"string"}}},"example":{"location":"New York"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/meetup/v1/event":{"post":{"operationId":"meetup_event","summary":"Full detail for one event by id or url: name, description, start/end datetime, venue with full address and coordinates, hosting group, fee, RSVP/going count, topics, event type and status.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"event_id":{"type":"string"},"url":{"type":"string"}}},"example":{"url":"https://www.meetup.com/code-for-boston/events/315094325/"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/meetup/v1/group":{"post":{"operationId":"meetup_group","summary":"Full profile for a Meetup group by urlname or url: name, member count, average event rating, topics, city/coordinates, description, join mode, founded date and social links.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"group":{"type":"string"},"urlname":{"type":"string"},"url":{"type":"string"}}},"example":{"group":"code-for-boston"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/meetup/v1/group_events":{"post":{"operationId":"meetup_group_events","summary":"A group's events by urlname or url. Choose upcoming (default) or past. Returns each event with name, datetime, venue, fee, RSVP count and link.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"group":{"type":"string"},"urlname":{"type":"string"},"url":{"type":"string"},"type":{"type":"string"}}},"example":{"group":"code-for-boston"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/mercadolibre/v1/deals":{"post":{"operationId":"mercadolibre_deals","summary":"MercadoLibre's live deals feed (Ofertas del día) — discounted listing cards with current and previous price, discount %, star rating + review count, seller (+official-store flag), shipping and brand. Multi-country, paginated, optional minimum-discount filter. Note: this is the site-wide daily-deals browse — it is NOT keyword-filtered.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site_id":{"type":"string"},"page":{"type":"string"},"max_pages":{"type":"string"},"min_discount":{"type":"string"},"sort":{"type":"string"}}},"example":{"site_id":"MLA"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/mercadolibre/v1/category_items":{"post":{"operationId":"mercadolibre_category_items","summary":"Products listed in a MercadoLibre category — title, price (current/previous/discount), rating, product link and picture. Pass a category_id (it's resolved to the category's /c/ landing page). MercadoLibre puts keyword search behind a login, so browsing by category is the way to list real products for it.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category_id":{"type":"string"},"site_id":{"type":"string"},"sort":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"}},"required":["category_id"]},"example":{"category_id":"MLA1051"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/mercadolibre/v1/reviews":{"post":{"operationId":"mercadolibre_reviews","summary":"Buyer reviews for a catalog product — full review text, rating and date, paginated to gather ALL reviews in one call + a derived star distribution and average. Works across countries.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"},"site_id":{"type":"string"},"page":{"type":"string"},"max_pages":{"type":"string"}},"required":["product_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/mercadolibre/v1/suggest":{"post":{"operationId":"mercadolibre_suggest","summary":"Search-term autocomplete — what MercadoLibre suggests as a shopper types.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"site_id":{"type":"string"}},"required":["query"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/mercadolibre/v1/category":{"post":{"operationId":"mercadolibre_category","summary":"Browse the MercadoLibre category tree — a category's name, total item count, full path from root and its direct child subcategories. Drill down via children[].id; use `category_items` to retrieve the products within a category.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category_id":{"type":"string"}},"required":["category_id"]},"example":{"category_id":"MLA1051"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/search":{"post":{"operationId":"movies_tv_search","summary":"search titles (type=multi|movie|tv|streaming)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"type":{"type":"string"},"limit":{"type":"string"},"year":{"type":"string"},"country":{"type":"string"},"page":{"type":"string"},"language":{"type":"string"}},"required":["query"]},"example":{"query":"breaking bad","type":"tv"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/detail":{"post":{"operationId":"movies_tv_detail","summary":"unified title detail (tv→TVmaze, movie→TMDB depth + JustWatch offers)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"id_type":{"type":"string"},"country":{"type":"string"},"include_streaming":{"type":"string"},"language":{"type":"string"}},"required":["id"]},"example":{"id":169,"type":"tv"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/episodes":{"post":{"operationId":"movies_tv_episodes","summary":"TV episodes (optionally one season)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"id_type":{"type":"string"},"season":{"type":"string"},"specials":{"type":"string"}},"required":["id"]},"example":{"id":169,"type":"tv"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/cast":{"post":{"operationId":"movies_tv_cast","summary":"cast (tv→TVmaze, movie→TMDB)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"id_type":{"type":"string"}},"required":["id"]},"example":{"id":169,"type":"tv"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/crew":{"post":{"operationId":"movies_tv_crew","summary":"crew (tv→TVmaze, movie→TMDB)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"id_type":{"type":"string"}},"required":["id"]},"example":{"id":169}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/akas":{"post":{"operationId":"movies_tv_akas","summary":"alternative titles (tv→TVmaze, movie→TMDB)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"id_type":{"type":"string"}},"required":["id"]},"example":{"id":169,"type":"tv"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/schedule":{"post":{"operationId":"movies_tv_schedule","summary":"TV broadcast (kind=tv) or streaming-premiere (kind=web) calendar","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"date":{"type":"string"},"kind":{"type":"string"}}},"example":{"country":"US","date":"2024-01-01"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/streaming":{"post":{"operationId":"movies_tv_streaming","summary":"where-to-watch offers via JustWatch (query/node_id/imdb/tmdb)","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"id":{"type":"string"},"id_type":{"type":"string"},"node_id":{"type":"string"},"country":{"type":"string"},"object_types":{"type":"string"},"title":{"type":"string"},"year":{"type":"string"}}},"example":{"query":"inception","country":"US"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/people":{"post":{"operationId":"movies_tv_people","summary":"person search or detail (tv→TVmaze, movie→TMDB)","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"id":{"type":"string"},"type":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/lookup":{"post":{"operationId":"movies_tv_lookup","summary":"cross-resolve imdb↔tmdb↔tvmaze ids","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"imdb_id":{"type":"string"},"tmdb_id":{"type":"string"},"tvmaze_id":{"type":"string"},"id":{"type":"string"},"id_type":{"type":"string"},"type":{"type":"string"}}},"example":{"imdb_id":"tt0903747"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/genres":{"post":{"operationId":"movies_tv_genres","summary":"TMDB genre reference (movie|tv)","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/countries":{"post":{"operationId":"movies_tv_countries","summary":"streaming services available in a country (JustWatch)","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"}}},"example":{"country":"US"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/new_titles":{"post":{"operationId":"movies_tv_new_titles","summary":"recently added/changed on streaming (≈ catalog changes)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string"},"country":{"type":"string"},"limit":{"type":"string"},"object_types":{"type":"string"},"packages":{"type":"string"}},"required":["date"]},"example":{"country":"US","date":"2026-06-01"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/charts":{"post":{"operationId":"movies_tv_charts","summary":"Ranked title charts: most-popular / top-rated / upcoming / now-playing / on-the-air / trending — for movies, TV or both. A `language` filter turns top-rated/popular into the per-language charts (e.g. top-rated Tamil/Telugu/Hindi); `region` localises upcoming/now-playing.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"chart":{"type":"string"},"language":{"type":"string"},"region":{"type":"string"},"page":{"type":"string"},"limit":{"type":"string"}},"required":["chart"]},"example":{"chart":"top_rated_movies"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/similar":{"post":{"operationId":"movies_tv_similar","summary":"Titles similar to / recommended for a given movie or TV show (TMDB recommendations, falling back to similar). Accepts a TMDB id or an IMDb tt… id.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"limit":{"type":"string"}},"required":["id"]},"example":{"id":27205,"type":"movie"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/credits":{"post":{"operationId":"movies_tv_credits","summary":"A person's full filmography (combined movie + TV credits) by TMDB person id or by name — every title they were cast or crew on, newest first, with their character/job.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"person_id":{"type":"string"},"name":{"type":"string"},"limit":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/discover":{"post":{"operationId":"movies_tv_discover","summary":"Browse the catalog with filters — find movies or TV by genre, year range, minimum rating, runtime, original language, cast/crew, keyword and where-to-stream provider, sorted however you like. The 'explore like a real user' surface.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"genres":{"type":"string"},"year":{"type":"string"},"year_gte":{"type":"string"},"year_lte":{"type":"string"},"rating_gte":{"type":"string"},"runtime_gte":{"type":"string"},"runtime_lte":{"type":"string"},"language":{"type":"string"},"region":{"type":"string"},"with_cast":{"type":"string"},"sort_by":{"type":"string"},"page":{"type":"string"},"locale":{"type":"string"}}},"example":{"type":"movie","genres":"Science Fiction","year_gte":2010,"rating_gte":7.5,"sort_by":"vote_average.desc"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/reviews":{"post":{"operationId":"movies_tv_reviews","summary":"User reviews for a movie or TV show (author, star rating, full text), paginated.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"page":{"type":"string"}},"required":["id"]},"example":{"id":27205,"type":"movie"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/images":{"post":{"operationId":"movies_tv_images","summary":"All artwork for a title — posters, backdrops and (TV) episode stills with resolutions and language tags.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"limit":{"type":"string"}},"required":["id"]},"example":{"id":27205,"type":"movie"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/videos":{"post":{"operationId":"movies_tv_videos","summary":"Trailers, teasers and clips for a movie or TV show (YouTube keys + ready-to-play URLs).","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"}},"required":["id"]},"example":{"id":27205,"type":"movie"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/watch_providers":{"post":{"operationId":"movies_tv_watch_providers","summary":"Where to stream/rent/buy a title (TMDB/JustWatch data) — pass a country for that region's offers, or omit it to get every region.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"country":{"type":"string"}},"required":["id"]},"example":{"id":27205,"type":"movie","country":"US"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/season":{"post":{"operationId":"movies_tv_season","summary":"Full episode list for one season of a TV show — episode titles, overviews, air dates, ratings and stills (TMDB).","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"season":{"type":"string"},"type":{"type":"string"}},"required":["id","season"]},"example":{"id":1396,"season":1}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/movies-tv/v1/episode":{"post":{"operationId":"movies_tv_episode","summary":"One TV episode in depth — overview, air date, rating, guest stars and crew (TMDB).","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"season":{"type":"string"},"episode":{"type":"string"}},"required":["id","season","episode"]},"example":{"id":1396,"season":1,"episode":1}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/music-metadata/v1/search":{"post":{"operationId":"music_metadata_search","summary":"search artist/album/release/recording/track/label/work (advanced field search supported)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"type":{"type":"string"},"limit":{"type":"string"},"offset":{"type":"string"}},"required":["query"]},"example":{"query":"radiohead","type":"artist"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/music-metadata/v1/artist_detail":{"post":{"operationId":"music_metadata_artist_detail","summary":"artist + relationships (members/collaborations), discography, aliases, tags","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mbid":{"type":"string"},"inc":{"type":"string"}},"required":["mbid"]},"example":{"mbid":"a74b1b7f-71a5-4011-9441-d0b5e4122711"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/music-metadata/v1/album_detail":{"post":{"operationId":"music_metadata_album_detail","summary":"release (tracklist+labels+ISRCs+discids) or release-group","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mbid":{"type":"string"},"entity":{"type":"string"},"inc":{"type":"string"}},"required":["mbid"]},"example":{"mbid":"4b3d18cc-8937-36f4-8de0-481088be58e6","entity":"release"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/music-metadata/v1/track_detail":{"post":{"operationId":"music_metadata_track_detail","summary":"recording + ISRCs + work-relations + artist credits","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mbid":{"type":"string"},"inc":{"type":"string"}},"required":["mbid"]},"example":{"mbid":"7c0e3d7c-3944-4b64-87bb-62dba67bea83"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/music-metadata/v1/label":{"post":{"operationId":"music_metadata_label","summary":"label detail (country, label-code, aliases, url-rels)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mbid":{"type":"string"},"inc":{"type":"string"}},"required":["mbid"]},"example":{"mbid":"14221f01-8939-4ea0-b8f1-b5a21beae80a"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/music-metadata/v1/work_detail":{"post":{"operationId":"music_metadata_work_detail","summary":"work/composition + ISWC + writer relations","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mbid":{"type":"string"},"inc":{"type":"string"}},"required":["mbid"]},"example":{"mbid":"1b4ff597-f43f-3dac-9f76-0e7b7f38d0d2"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/music-metadata/v1/isrc_lookup":{"post":{"operationId":"music_metadata_isrc_lookup","summary":"reverse ISRC -> recordings (cross-catalog key)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"isrc":{"type":"string"},"inc":{"type":"string"}},"required":["isrc"]},"example":{"isrc":"GBAYE9701274"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/music-metadata/v1/cover_art":{"post":{"operationId":"music_metadata_cover_art","summary":"Cover-Art-Archive images (multi-resolution) for a release/release-group","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mbid":{"type":"string"},"entity":{"type":"string"}},"required":["mbid"]},"example":{"mbid":"4b3d18cc-8937-36f4-8de0-481088be58e6","entity":"release"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/music-metadata/v1/itunes_search":{"post":{"operationId":"music_metadata_itunes_search","summary":"iTunes / Apple Music search for artists, albums or songs — returns genre, high-res artwork, a 30s preview URL, price and store link (country-aware)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"type":{"type":"string"},"limit":{"type":"string"},"country":{"type":"string"}},"required":["query"]},"example":{"query":"Daft Punk","type":"artist"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/music-metadata/v1/charts":{"post":{"operationId":"music_metadata_charts","summary":"Apple Music top charts — the most-played songs or albums in a country (updated through the day)","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"country":{"type":"string"},"limit":{"type":"string"}}},"example":{"type":"songs","country":"us","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/music-metadata/v1/artist_profile":{"post":{"operationId":"music_metadata_artist_profile","summary":"Rich artist profile: biography, genre/style/mood, formed year, label, follower/popularity counts, social links and images (TheAudioDB). Pass the MusicBrainz mbid (from search/artist_detail) for an exact match, or an artist name","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"mbid":{"type":"string"},"name":{"type":"string"}}},"example":{"mbid":"cc197bad-dc9c-440d-a5b5-d52ba2e14234"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/music-metadata/v1/artist_top_tracks":{"post":{"operationId":"music_metadata_artist_top_tracks","summary":"An artist's most popular tracks (top 10) with album, duration, genre and music-video link (TheAudioDB)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]},"example":{"name":"Coldplay"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/music-metadata/v1/similar_artists":{"post":{"operationId":"music_metadata_similar_artists","summary":"Artists similar to a given artist, ranked by a collaborative listening model (ListenBrainz, CC0). Pass the artist's MusicBrainz mbid","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mbid":{"type":"string"},"limit":{"type":"string"}},"required":["mbid"]},"example":{"mbid":"cc197bad-dc9c-440d-a5b5-d52ba2e14234"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/music-metadata/v1/lyrics":{"post":{"operationId":"music_metadata_lyrics","summary":"Song lyrics — both plain text and time-synced (LRC) when available — for an artist + track (lrclib, open). Optionally pass album+duration for an exact match","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"artist":{"type":"string"},"track":{"type":"string"},"album":{"type":"string"},"duration":{"type":"string"}},"required":["artist","track"]},"example":{"artist":"Daft Punk","track":"Get Lucky"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/n11/v1/product/detail":{"post":{"operationId":"n11_product_detail","summary":"Full n11 product by `url` or `product_id`: title, brand, price, discount, campaign (Sepette indirim), rating, review_count, images, seller, gtin/barcode, category, description, attributes, variants, rating_breakdown and sample reviews. Parsed from n11's own window.model JSON (durable).","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"product_id":{"type":"string"},"max_rotations":{"type":"string"}}},"example":{"url":"https://www.n11.com/urun/samsung-galaxy-a07-4-gb-128-gb-samsung-turkiye-garantili-106765738"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/n11/v1/product/reviews":{"post":{"operationId":"n11_product_reviews","summary":"Customer reviews for a product by `url` or `product_id` — the review set n11 itself picks for the product page, with each reviewer's text, star rating and date, next to n11's own totals: how many people rated the product, how many wrote a comment, and the full star breakdown. The reviews returned are a sample of that total by design; both numbers are in the response so the gap is visible rather than implied. n11 publishes no further pages of reviews on the web, so this action takes no `page`.","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"product_id":{"type":"string"},"max_rotations":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/n11/v1/search":{"post":{"operationId":"n11_search","summary":"Search n11 by keyword (`query`), paginated + sortable. Every card carries product_id, title, brand, price, rating, image, url.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"page":{"type":"string"},"sort":{"type":"string"},"max_rotations":{"type":"string"}},"required":["query"]},"example":{"query":"telefon"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/n11/v1/category":{"post":{"operationId":"n11_category","summary":"Browse an n11 category by its `url` (…/ or …-c-), paginated + sortable.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"page":{"type":"string"},"sort":{"type":"string"},"max_rotations":{"type":"string"}},"required":["url"]},"example":{"url":"https://www.n11.com/urun/samsung-galaxy-a07-4-gb-128-gb-samsung-turkiye-garantili-106765738"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/n11/v1/seller":{"post":{"operationId":"n11_seller","summary":"Seller (mağaza) profile + its products by nickname or store `url`.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"seller":{"type":"string"},"page":{"type":"string"},"max_rotations":{"type":"string"}},"required":["seller"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/n11/v1/resolve":{"post":{"operationId":"n11_resolve","summary":"Resolve an n11 short-link (`token` or `url`, e.g. sl.n11.com/n/) to its REAL n11.com URL + type, capturing the final destination — a short link opened directly dead-ends on an app-install page instead of the item. Classifies product/store/campaign/category; for products it embeds the full product detail (include_detail) so one call returns both. Deterministic per token → cacheable.","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string"},"url":{"type":"string"},"include_detail":{"type":"string"},"max_rotations":{"type":"string"}}},"example":{"token":"vnETLtk"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/naver/v1/place/search":{"post":{"operationId":"naver_place_search","summary":"search restaurants & food places by query (richest food data)","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"}},"required":["query"]},"example":{"query":"강남 맛집","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/naver/v1/place/search-all":{"post":{"operationId":"naver_place_search_all","summary":"search ANY business type on Naver Place/Map (clinics, cafes, hotels, salons, shops…)","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"}},"required":["query"]},"example":{"query":"강남 성형외과","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/naver/v1/place/detail":{"post":{"operationId":"naver_place_detail","summary":"full place profile (rating, phone, hours, images)","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"place_id":{"type":"string"},"query":{"type":"string"}},"required":["place_id"]},"example":{"place_id":"18485191"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/naver/v1/place/reviews":{"post":{"operationId":"naver_place_reviews","summary":"visitor reviews (latest page, ~20 per call) with the true total","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"place_id":{"type":"string"},"limit":{"type":"string"},"page_size":{"type":"string"},"sort":{"type":"string"},"query":{"type":"string"}},"required":["place_id"]},"example":{"place_id":"18485191","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/naver/v1/place/blog-reviews":{"post":{"operationId":"naver_place_blog_reviews","summary":"blog reviews","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"place_id":{"type":"string"},"limit":{"type":"string"},"page_size":{"type":"string"},"query":{"type":"string"}},"required":["place_id"]},"example":{"place_id":"18485191","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/naver/v1/place/resolve":{"post":{"operationId":"naver_place_resolve","summary":"resolve a query → place_id (works for food AND any other business)","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"place_id":{"type":"string"}},"required":["query"]},"example":{"query":"강남 맛집"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/naver/v1/search/autocomplete":{"post":{"operationId":"naver_search_autocomplete","summary":"Naver search-box keyword suggestions for a partial term (keyword research)","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"}},"required":["query"]},"example":{"query":"아이폰","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/newegg/v1/search":{"post":{"operationId":"newegg_search","summary":"Search Newegg products by keyword with page pagination, sort (price/best-selling/rating), brand/facet filter, and a price range. Return up to 360 products in one call with `max_results` (36 per page, paged for you); `page` picks where that window starts. Paid placements are flagged `sponsored: true` and can be excluded with `include_sponsored: false`","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"max_results":{"type":"string"},"page":{"type":"string"},"sort":{"type":"string"},"n_value":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"include_sponsored":{"type":"string"}},"required":["query"]},"example":{"query":"ssd"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/newegg/v1/price":{"post":{"operationId":"newegg_price","summary":"Live price and stock for ONE item — the cheap way to refresh products you already hold, without paying for the whole product page","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"item_id":{"type":"string"},"url":{"type":"string"}}},"example":{"item_id":"N82E16820156412"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/newegg/v1/product":{"post":{"operationId":"newegg_product","summary":"Full product detail by item_id or url — price, list price, promotion, brand, model, MPN, GTIN/UPC barcode, shipping weight and package dimensions, specifications, bullets, images, rating, stock, and marketplace seller","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"item_id":{"type":"string"},"url":{"type":"string"}}},"example":{"item_id":"N82E16820156412"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/newegg/v1/reviews":{"post":{"operationId":"newegg_reviews","summary":"Customer reviews for a Newegg product — fully paginated through ALL reviews (20/page) with rating filter and sort, plus a rating distribution summary. Returns rating, title, body, pros/cons, author, verified-purchase, helpful votes, media, and merchant replies","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"item_id":{"type":"string"},"page":{"type":"string"},"rating":{"type":"string"},"sort":{"type":"string"},"url":{"type":"string"}},"required":["item_id"]},"example":{"item_id":"N82E16820156412"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/newegg/v1/best_sellers":{"post":{"operationId":"newegg_best_sellers","summary":"Top best-selling products for a keyword or category (Newegg's Best Selling sort), paginated. Same `max_results` (up to 300, 36/page) and `include_sponsored` controls as the search action","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"n_value":{"type":"string"},"subcategory_id":{"type":"string"},"subcategory_slug":{"type":"string"},"max_results":{"type":"string"},"page":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"include_sponsored":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/newegg/v1/qna":{"post":{"operationId":"newegg_qna","summary":"product Q&A questions and answers from PDP initial state","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"item_id":{"type":"string"},"url":{"type":"string"}},"required":["item_id"]},"example":{"item_id":"N82E16820156412"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/newegg/v1/category":{"post":{"operationId":"newegg_category","summary":"Browse a Newegg subcategory's product listing by subcategory_id, paginated. The slug is auto-resolved when omitted (pass subcategory_slug from category_tree to skip the lookup)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subcategory_id":{"type":"string"},"subcategory_slug":{"type":"string"},"page":{"type":"string"}},"required":["subcategory_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/newegg/v1/browse":{"post":{"operationId":"newegg_browse","summary":"Alias of the category action — browse a subcategory's product listing, paginated","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subcategory_id":{"type":"string"},"subcategory_slug":{"type":"string"},"page":{"type":"string"}},"required":["subcategory_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/newegg/v1/deals":{"post":{"operationId":"newegg_deals","summary":"Shell Shocker daily deal items","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"page":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/newegg/v1/categories":{"post":{"operationId":"newegg_categories","summary":"top-level store/category nodes from homepage RolloverMenu","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/newegg/v1/filters":{"post":{"operationId":"newegg_filters","summary":"search facets, department navigation, and sort options for a query","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"page":{"type":"string"}},"required":["query"]},"example":{"query":"ssd"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/newegg/v1/similar":{"post":{"operationId":"newegg_similar","summary":"related product cards from a product detail page","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"item_id":{"type":"string"},"url":{"type":"string"},"limit":{"type":"string"}},"required":["item_id"]},"example":{"item_id":"N82E16820156412"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/newegg/v1/category_tree":{"post":{"operationId":"newegg_category_tree","summary":"nested category navigation tree from a Newegg store landing page","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"store_id":{"type":"string"},"store_slug":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/newegg/v1/variants":{"post":{"operationId":"newegg_variants","summary":"Product family/variant options from the PDP — size/capacity/colour family members, package bundles, and any combo-deal promotion","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"item_id":{"type":"string"},"url":{"type":"string"}},"required":["item_id"]},"example":{"item_id":"N82E16820156412"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/news-article/v1/extract":{"post":{"operationId":"news_article_extract","summary":"Extract a clean article from any news or blog URL: returns title, full text, author, publication date, top image, all images, language, site name, and canonical URL. Automatically follows Google News and Bing News redirect links to the original publisher page.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"render":{"type":"string"},"include_markdown":{"type":"string"}},"required":["url"]},"example":{"url":"https://en.wikipedia.org/wiki/Web_scraping"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/news-article/v1/news_search":{"post":{"operationId":"news_article_news_search","summary":"recent-news list from source=google|bing|gdelt|rss|all (unified schema title/url/source/published/lang); resolve=true → Google-News URLs become real publisher URLs","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"source":{"type":"string"},"lang":{"type":"string"},"country":{"type":"string"},"limit":{"type":"string"},"rss_url":{"type":"string"},"resolve":{"type":"string"}}},"example":{"query":"artificial intelligence","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/news-intel/v1/search":{"post":{"operationId":"news_intel_search","summary":"Global news search across GDELT (+ optionally merged Google-News-RSS), de-duplicated into one unified article shape. The core 'what's the news on X' call. Filter by timespan/language/country/sort; each article carries title, url, source_domain, published_at, language, snippet, image, duplicate_count, also_reported_by[].","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"timespan":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"language":{"type":"string"},"country":{"type":"string"},"sort":{"type":"string"},"max":{"type":"string"},"merge_google_news":{"type":"string"},"dedup":{"type":"string"},"similarity":{"type":"string"}},"required":["query"]},"example":{"query":"OpenAI","timespan":"2d","max":40}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/news-intel/v1/timeline":{"post":{"operationId":"news_intel_timeline","summary":"How much is X in the news over time — GDELT volume-over-time (timelinevol) for a query as [{date, value}], with peak detection (max point + average + latest). SLOW BY NATURE: the analytics index behind this endpoint currently answers in about 20-25 seconds and refuses a large share of connections, so expect a ~20-25s call and an occasional honest 'source did not answer' rather than a sub-second reply. If the source misses, a reading up to 30 minutes old may be returned instead, always labelled with stale_age_seconds. For fast news use search / top_headlines / by_source (~1s).","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"timespan":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"language":{"type":"string"},"country":{"type":"string"}},"required":["query"]},"example":{"query":"earthquake","timespan":"1w"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/news-intel/v1/sentiment":{"post":{"operationId":"news_intel_sentiment","summary":"Sentiment / tone analysis for a query — GDELT tonechart gives the distribution of article tone (how positive/negative coverage is) as a histogram, a count-weighted average tone, a positive/neutral/negative breakdown, and the single most-positive and most-negative representative article. Answers 'how is X being covered — favorably or critically?'. (alias: tone) SLOW BY NATURE: the analytics index behind this endpoint currently answers in about 20-25 seconds and refuses a large share of connections, so expect a ~20-25s call and an occasional honest 'source did not answer' rather than a sub-second reply. If the source misses, a reading up to 30 minutes old may be returned instead, always labelled with stale_age_seconds. For fast news use search / top_headlines / by_source (~1s).","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"timespan":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"language":{"type":"string"},"country":{"type":"string"}},"required":["query"]},"example":{"query":"inflation","timespan":"1w"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/news-intel/v1/entities":{"post":{"operationId":"news_intel_entities","summary":"Top entities for a query — the people/organizations and locations most mentioned in coverage of a topic, ranked by mention count. Organizations/people are mined from article titles; locations come from GDELT's source-country distribution. Metadata-only. Useful for 'who and where is this story about'. SLOW BY NATURE: the analytics index behind this endpoint currently answers in about 20-25 seconds and refuses a large share of connections, so expect a ~20-25s call and an occasional honest 'source did not answer' rather than a sub-second reply. If the source misses, a reading up to 30 minutes old may be returned instead, always labelled with stale_age_seconds. For fast news use search / top_headlines / by_source (~1s).","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"timespan":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"language":{"type":"string"},"country":{"type":"string"},"max":{"type":"string"}},"required":["query"]},"example":{"query":"OpenAI","timespan":"3d"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/news-intel/v1/trending":{"post":{"operationId":"news_intel_trending","summary":"What's big in the news right now — a curated multi-bucket roll-up (breaking/world/tech/business/politics/science by default, or your own queries) ranked by recent volume, each with a few representative headlines. SLOW BY NATURE: the analytics index behind this endpoint currently answers in about 20-25 seconds and refuses a large share of connections, so expect a ~20-25s call and an occasional honest 'source did not answer' rather than a sub-second reply. If the source misses, a reading up to 30 minutes old may be returned instead, always labelled with stale_age_seconds. For fast news use search / top_headlines / by_source (~1s). PARTIAL BY DESIGN: each bucket is fetched independently, so a call can return fewer topics than requested; meta.bucket_errors names the ones that missed, and a repeat call fills them in (buckets already fetched are reused).","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string"},"timespan":{"type":"string"},"language":{"type":"string"},"country":{"type":"string"},"max":{"type":"string"}}},"example":{"timespan":"1d"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/news-intel/v1/top_headlines":{"post":{"operationId":"news_intel_top_headlines","summary":"Editor-curated top headlines by Google-News topic section (WORLD/BUSINESS/TECHNOLOGY/…) and/or country edition. De-duplicated. The 'front page' call.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"topic":{"type":"string"},"country":{"type":"string"},"max":{"type":"string"},"dedup":{"type":"string"}}},"example":{"topic":"TECHNOLOGY"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/news-intel/v1/by_source":{"post":{"operationId":"news_intel_by_source","summary":"Recent articles from a specific publisher domain (reuters.com, bbc.com, …). Google-News site: is the reliable primary (near-live, ~100% on-source); GDELT domain: enriches with direct publisher URLs + tone when its 5s window is free (skipped silently otherwise — never blocks). Source-exact. merge_google_news=false → GDELT-only exact.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string"},"query":{"type":"string"},"timespan":{"type":"string"},"language":{"type":"string"},"sort":{"type":"string"},"max":{"type":"string"},"merge_google_news":{"type":"string"},"dedup":{"type":"string"}},"required":["source"]},"example":{"source":"reuters.com","timespan":"3d"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/news-intel/v1/coverage":{"post":{"operationId":"news_intel_coverage","summary":"Full-story coverage — for a story or topic, discover which news outlets are covering it. Returns the most-covered stories first, each expanded to every outlet that carried it (outlet_count + outlets[]). Ideal for media monitoring and PR: see how widely a story was reported and by whom.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"timespan":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"language":{"type":"string"},"country":{"type":"string"},"max":{"type":"string"},"similarity":{"type":"string"}},"required":["query"]},"example":{"query":"OpenAI","timespan":"3d"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/news-intel/v1/sources":{"post":{"operationId":"news_intel_sources","summary":"Reference directory of supported news outlets, filterable by category (e.g. TECHNOLOGY, SPORTS) and country. Also returns the topic, language and country reference lists accepted by other actions. Note: by_source accepts any publisher domain — this directory is a curated starting set, not a limit.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"country":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/news-intel/v1/tech":{"post":{"operationId":"news_intel_tech","summary":"Hacker News tech vertical — top/new/best stories, or a full-text Algolia search. Each story: title, url, points, author, num_comments, created_at, hn_url.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"list":{"type":"string"},"max":{"type":"string"}}},"example":{"list":"top","max":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/news-intel/v1/batch":{"post":{"operationId":"news_intel_batch","summary":"Run up to 10 search queries in one call (shared concurrency, GDELT 5s-window paced). results[] preserves input order; each is a de-duped search result.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string"},"timespan":{"type":"string"},"language":{"type":"string"},"country":{"type":"string"},"max":{"type":"string"},"merge_google_news":{"type":"string"},"dedup":{"type":"string"}},"required":["queries"]},"example":{"queries":"openai,tesla,bitcoin","timespan":"2d","max":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/olx/v1/search":{"post":{"operationId":"olx_search","summary":"Search OLX classifieds by keyword and/or category with sort, condition, price, delivery and location filters. Offset pagination (limit=40). Promoted ads filtered out.","tags":["Classifieds & Second-hand"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"country":{"type":"string"},"category_id":{"type":"string"},"sort_by":{"type":"string"},"condition":{"type":"string"},"with_photos":{"type":"string"},"courier":{"type":"string"},"region_id":{"type":"string"},"city_id":{"type":"string"},"district_id":{"type":"string"},"price_from":{"type":"string"},"price_to":{"type":"string"},"filters":{"type":"string"},"offset":{"type":"string"},"limit":{"type":"string"}}},"example":{"query":"iphone","country":"pl"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/olx/v1/count":{"post":{"operationId":"olx_count","summary":"Lightweight result count for a query/category/filter combination — total matching listings without fetching the offers. Useful for market sizing.","tags":["Classifieds & Second-hand"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"country":{"type":"string"},"category_id":{"type":"string"},"condition":{"type":"string"},"region_id":{"type":"string"},"city_id":{"type":"string"},"district_id":{"type":"string"},"price_from":{"type":"string"},"price_to":{"type":"string"},"filters":{"type":"string"}}},"example":{"query":"iphone","country":"pl"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/olx/v1/locations":{"post":{"operationId":"olx_locations","summary":"GEO resolver: turn a place name into OLX region/city/district ids for the location filters. No params -> all regions; region_id -> its cities; city_id -> city detail + districts; query -> match a city by name across regions.","tags":["Classifieds & Second-hand"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"query":{"type":"string"},"region_id":{"type":"string"},"city_id":{"type":"string"}}},"example":{"country":"pl"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/olx/v1/offer":{"post":{"operationId":"olx_offer","summary":"Offer detail by numeric id (no trailing slash on upstream path).","tags":["Classifieds & Second-hand"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"country":{"type":"string"}},"required":["id"]},"example":{"id":1027143072,"country":"pl"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/olx/v1/categories":{"post":{"operationId":"olx_categories","summary":"Category facets + filter suggestions from search metadata, plus global filter definitions.","tags":["Classifieds & Second-hand"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"country":{"type":"string"},"category_id":{"type":"string"}}},"example":{"country":"pl","category_id":99}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/olx/v1/user_offers":{"post":{"operationId":"olx_user_offers","summary":"Active offers for a seller user_id with offset pagination.","tags":["Classifieds & Second-hand"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string"},"country":{"type":"string"},"offset":{"type":"string"},"limit":{"type":"string"}},"required":["user_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/olx/v1/suggested":{"post":{"operationId":"olx_suggested","summary":"Related/suggested offers for a given offer id.","tags":["Classifieds & Second-hand"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"country":{"type":"string"}},"required":["id"]},"example":{"id":1027143072}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/olx/v1/breadcrumbs":{"post":{"operationId":"olx_breadcrumbs","summary":"Category or offer breadcrumb trail.","tags":["Classifieds & Second-hand"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"category_id":{"type":"string"},"id":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/olx/v1/user":{"post":{"operationId":"olx_user","summary":"Public seller profile by user id.","tags":["Classifieds & Second-hand"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string"},"country":{"type":"string"}},"required":["user_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/olx/v1/filters":{"post":{"operationId":"olx_filters","summary":"Global filter attribute definitions keyed by filter_enum/filter_float names.","tags":["Classifieds & Second-hand"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/onthemarket/v1/location_search":{"post":{"operationId":"onthemarket_location_search","summary":"Resolve a text location (town, postcode, borough, area) to OnTheMarket location slug(s). Returns multiple ranked matches; use a result's location_id in search.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"channel":{"type":"string"},"limit":{"type":"string"}},"required":["query"]},"example":{"query":"London"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/onthemarket/v1/search":{"post":{"operationId":"onthemarket_search","summary":"Search UK property listings by location (for sale / to rent) with structured filters: price, beds, property type, radius, keywords, added-within and sort. Paginate with page/max_pages (30 per page).","tags":["Real Estate"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"},"location_id":{"type":"string"},"channel":{"type":"string"},"for_rent":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"beds_min":{"type":"string"},"beds_max":{"type":"string"},"property_type":{"type":"string"},"radius":{"type":"string"},"added_within_days":{"type":"string"},"sort":{"type":"string"},"keywords":{"type":"string"},"retirement_only":{"type":"string"},"shared_ownership_only":{"type":"string"},"auction_only":{"type":"string"},"new_homes_only":{"type":"string"},"include_under_offer":{"type":"string"},"include_sponsored":{"type":"string"},"page":{"type":"string"},"max_pages":{"type":"string"},"filters":{"type":"string"}}},"example":{"location":"London"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/onthemarket/v1/property_detail":{"post":{"operationId":"onthemarket_property_detail","summary":"Full property record: price (+qualifier), beds/baths, description, key features, key-info (tenure, council-tax band), images, floorplans, virtual/video tours, documents, nearby stations & schools, area stats (avg price, crime level), breadcrumbs and the listing agent.","tags":["Real Estate"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"property_id":{"type":"string"},"url":{"type":"string"}}},"example":{"property_id":"19555795"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/opensea/v1/collection":{"post":{"operationId":"opensea_collection","summary":"Full collection detail by slug: floor price, top offer, 24h + total volume, owner / listed / supply counts and 1-day floor change (live from OpenSea's GraphQL) merged with keyless metadata — description, image/banner, contracts (address + chain), category, safelist status, fees and social links (Twitter / Discord / Telegram / website).","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"}},"required":["slug"]},"example":{"slug":"pudgypenguins"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/opensea/v1/search":{"post":{"operationId":"opensea_search","summary":"Search OpenSea collections by free-text name. Returns matching collections with slug, name, image, category, floor price, owner count, supply and total volume — use the returned slug with the other actions.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"}},"required":["query"]},"example":{"query":"pudgy"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/opensea/v1/items":{"post":{"operationId":"opensea_items","summary":"Paginated items (NFTs) in a collection. Each item: name, token id, contract, image, rarity rank, best listing price + marketplace, best offer and last sale. Sort by price / rarity / last-sale-price / listing-date. Cursor pagination — pass the returned meta.next_cursor as `cursor` to page on.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"},"sort_by":{"type":"string"},"direction":{"type":"string"}},"required":["slug"]},"example":{"slug":"pudgypenguins","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/opensea/v1/item":{"post":{"operationId":"opensea_item","summary":"Single NFT / item detail by collection contract + token id: name, image, all traits (trait_type + value), rarity rank, best listing (price + marketplace), best offer and last sale. Get contract_address from the collection action's contracts[] (or an items[] row); token_id is the NFT number.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"contract_address":{"type":"string"},"token_id":{"type":"string"},"chain":{"type":"string"}},"required":["contract_address","token_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/opensea/v1/activity":{"post":{"operationId":"opensea_activity","summary":"Recent on-chain activity for a collection (default: sales). Each event: type, time, price (token amount + USD) and the item (name, token id, contract). Filter by event type — sales, listings, offers, transfers or mints.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"limit":{"type":"string"},"event_type":{"type":"string"}},"required":["slug"]},"example":{"slug":"pudgypenguins","event_type":"SALE","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/opensea/v1/holders":{"post":{"operationId":"opensea_holders","summary":"Top holders (owners) of a collection, ranked by quantity owned. Each holder: wallet address, display name (ENS / OpenSea username if any), quantity, % of supply and estimated total NFT portfolio value (USD). Cursor pagination.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["slug"]},"example":{"slug":"pudgypenguins","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/opensea/v1/trending":{"post":{"operationId":"opensea_trending","summary":"Trending or top collections ranked over a time window — the OpenSea rankings/leaderboard. Each: rank score, slug, name, floor price, volume, owners and 1-day floor change. Choose TRENDING (momentum) or TOP (by volume), and a window (1h / 1d / 7d / 30d).","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ranking":{"type":"string"},"timeframe":{"type":"string"},"limit":{"type":"string"}}},"example":{"ranking":"TRENDING","timeframe":"ONE_DAY","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/otto/v1/search":{"post":{"operationId":"otto_search","summary":"Keyword product search on Otto.de with brand, price, rating, condition and availability filters, sort order and offset pagination. Returns product cards (name, brand, price in EUR, condition, availability, rating, review count, image, URL).","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"offset":{"type":"string"},"marke":{"type":"string"},"brand":{"type":"string"},"sortierung":{"type":"string"},"sort":{"type":"string"},"preis":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"bewertung":{"type":"string"},"min_rating":{"type":"string"},"zustand":{"type":"string"},"condition":{"type":"string"},"verfuegbarkeit":{"type":"string"},"availability":{"type":"string"}},"required":["query"]},"example":{"query":"iphone"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/otto/v1/browse":{"post":{"operationId":"otto_browse","summary":"Browse an Otto.de category landing (e.g. moebel, technik/computer, mode) with the same brand / price / rating / sort filters and offset pagination as search.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"offset":{"type":"string"},"marke":{"type":"string"},"brand":{"type":"string"},"sortierung":{"type":"string"},"sort":{"type":"string"},"preis":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"bewertung":{"type":"string"},"min_rating":{"type":"string"},"zustand":{"type":"string"},"condition":{"type":"string"},"verfuegbarkeit":{"type":"string"},"availability":{"type":"string"}},"required":["category"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/otto/v1/product":{"post":{"operationId":"otto_product","summary":"Product facts for one Otto.de item by variation id — name, brand, price (EUR), condition, availability, aggregate rating, review count, image and URL. Read from the search grid, because Otto does not serve its standalone product page to this endpoint; individual review text, GTIN and the full spec table are therefore not available here.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"query":{"type":"string"},"variation_id":{"type":"string"}},"required":["id","query"]},"example":{"id":"1786938267","query":"iphone"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/otto/v1/deals":{"post":{"operationId":"otto_deals","summary":"Current Otto.de deal / sale campaign products (e.g. Deal des Monats, Super Sale). Auto-discovers the active campaigns from the storefront and returns their product cards. Pick a specific campaign with the campaign param.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"campaign":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/otto/v1/new_arrivals":{"post":{"operationId":"otto_new_arrivals","summary":"Newest products on Otto.de — keyword or category sorted newest-first (sortierung=neuheiten). Pass query OR category; supports the same filters and offset pagination.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"category":{"type":"string"},"offset":{"type":"string"},"marke":{"type":"string"},"brand":{"type":"string"},"preis":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"bewertung":{"type":"string"},"min_rating":{"type":"string"},"zustand":{"type":"string"},"condition":{"type":"string"},"verfuegbarkeit":{"type":"string"},"availability":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/otto/v1/brands":{"post":{"operationId":"otto_brands","summary":"Brand filter links available on an Otto.de category landing page — feed the slug to search/browse as the brand filter.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"}},"required":["category"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/otto/v1/categories":{"post":{"operationId":"otto_categories","summary":"Otto.de department tree — top-level departments from the homepage, or the child categories of a parent path (e.g. parent=technik). Feed paths to browse / brands.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"parent":{"type":"string"},"category":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/otto/v1/filters":{"post":{"operationId":"otto_filters","summary":"Discover the sort orders and filter query params supported by Otto.de search/browse, with a live probe showing the available deal campaigns.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/otto/v1/reviews":{"post":{"operationId":"otto_reviews","summary":"Aggregate customer rating for an Otto.de item — average star rating and total review count from the search-embedded data. Individual review TEXT is only on the standalone product page, which Otto does not serve to this endpoint, so it is not available here (reviews[] is returned empty with text_available=false, honestly).","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"query":{"type":"string"},"variation_id":{"type":"string"}},"required":["id","query"]},"example":{"id":"1786938267","query":"iphone"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/packages/v1/package":{"post":{"operationId":"packages_package","summary":"full package metadata (latest version normalized)","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"registry":{"type":"string"},"name":{"type":"string"}},"required":["registry","name"]},"example":{"registry":"npm","name":"react"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/packages/v1/versions":{"post":{"operationId":"packages_versions","summary":"paginated version list for a package","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"registry":{"type":"string"},"name":{"type":"string"},"page":{"type":"string"},"page_size":{"type":"string"}},"required":["registry","name"]},"example":{"registry":"npm","name":"react","page_size":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/packages/v1/version":{"post":{"operationId":"packages_version","summary":"single version metadata","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"registry":{"type":"string"},"name":{"type":"string"},"version":{"type":"string"}},"required":["registry","name","version"]},"example":{"registry":"pypi","name":"requests","version":"2.34.2"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/packages/v1/dependencies":{"post":{"operationId":"packages_dependencies","summary":"runtime + dev dependencies for a version (latest if omitted)","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"registry":{"type":"string"},"name":{"type":"string"},"version":{"type":"string"}},"required":["registry","name"]},"example":{"registry":"npm","name":"react"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/packages/v1/downloads":{"post":{"operationId":"packages_downloads","summary":"download statistics (npm: period=last-day|week|month|year; pypi: recent day/week/month)","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"registry":{"type":"string"},"name":{"type":"string"},"period":{"type":"string"}},"required":["registry","name"]},"example":{"registry":"npm","name":"react","period":"last-month"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/packages/v1/search":{"post":{"operationId":"packages_search","summary":"search packages (npm: registry API; pypi: libraries.io→HTML→ranked simple-index+enrich)","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"registry":{"type":"string"},"query":{"type":"string"},"page":{"type":"string"},"page_size":{"type":"string"},"from":{"type":"string"}},"required":["registry","query"]},"example":{"registry":"npm","query":"fastapi"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/packages/v1/maintainer":{"post":{"operationId":"packages_maintainer","summary":"maintainer/author records for a package","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"registry":{"type":"string"},"name":{"type":"string"}},"required":["registry","name"]},"example":{"registry":"pypi","name":"requests"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/passive-osint/v1/subdomains":{"post":{"operationId":"passive_osint_subdomains","summary":"Passive subdomain discovery across crt.sh + certspotter + OTX + hackertarget + Wayback, deduped, with a per-source matrix and an honest coverage note","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"sources":{"type":"string"}},"required":["domain"]},"example":{"domain":"hackerone.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/passive-osint/v1/domain":{"post":{"operationId":"passive_osint_domain","summary":"One-call unified passive report: subdomains + DNS summary + SSL summary + archive first/last-seen + threat blocklist flags, each section degrading independently","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"sources":{"type":"string"},"include_pii":{"type":"string"}},"required":["domain"]},"example":{"domain":"github.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/passive-osint/v1/ip":{"post":{"operationId":"passive_osint_ip","summary":"Passive IP enrichment: rDNS (PTR) + ASN/org/country (Team-Cymru + RDAP) + threat blocklist flags + shared-host neighbours (reverse-IP + OTX IPv4 passive-DNS)","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ip":{"type":"string"},"include_pii":{"type":"string"}},"required":["ip"]},"example":{"ip":"8.8.8.8"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/passive-osint/v1/batch":{"post":{"operationId":"passive_osint_batch","summary":"Compact passive report (subdomain count+list, DNS, threat, archive-first-seen) across up to 10 domains in one call","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domains":{"type":"string"}},"required":["domains"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/phone-validate/v1/validate":{"post":{"operationId":"phone_validate_validate","summary":"validate ONE number → validity + format/region/line-type/carrier/timezone/location","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"number":{"type":"string"},"region":{"type":"string"},"default_region":{"type":"string"},"lang":{"type":"string"}},"required":["number"]},"example":{"number":"+90 532 123 4567"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/phone-validate/v1/batch":{"post":{"operationId":"phone_validate_batch","summary":"validate up to 100 numbers in one call (shared default region)","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"numbers":{"type":"string"},"region":{"type":"string"},"default_region":{"type":"string"},"lang":{"type":"string"}},"required":["numbers"]},"example":{"numbers":["+90 532 123 4567","+90 212 245 5555","nonsense"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/pinterest/v1/search_pins":{"post":{"operationId":"pinterest_search_pins","summary":"Search Pinterest pins by keyword. Returns pin id/title/description/image/link/save-count with the pinner. Paginate with meta.bookmark.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"},"bookmark":{"type":"string"}},"required":["query"]},"example":{"query":"minimalist home office","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/pinterest/v1/search_videos":{"post":{"operationId":"pinterest_search_videos","summary":"Search Pinterest video pins (Idea Pins / video) by keyword. Same shape as search_pins but scoped to video content (image_url + video_url). Paginate with meta.bookmark.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"},"bookmark":{"type":"string"}},"required":["query"]},"example":{"query":"minimalist home office"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/pinterest/v1/search_users":{"post":{"operationId":"pinterest_search_users","summary":"Search Pinterest users/creators by keyword. Returns username/profile stats/avatar.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"},"bookmark":{"type":"string"}},"required":["query"]},"example":{"query":"minimalist home office"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/pinterest/v1/search_boards":{"post":{"operationId":"pinterest_search_boards","summary":"Search Pinterest boards by keyword. Returns board name/url/description/pin-count/owner.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"},"bookmark":{"type":"string"}},"required":["query"]},"example":{"query":"minimalist home office"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/pinterest/v1/suggestions":{"post":{"operationId":"pinterest_suggestions","summary":"Autocomplete / typeahead search suggestions for a partial query — the dropdown Pinterest shows as you type. Great for keyword research.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"example":{"query":"minimalist home office"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/pinterest/v1/pin":{"post":{"operationId":"pinterest_pin","summary":"Full detail for one pin: title, description, image, video, outbound link/domain, save & comment & share counts, reactions, hashtags, board, dominant color, product/price (when a shopping pin) and the pinner. Provide pin_id or pin_url.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"pin_id":{"type":"string"},"pin_url":{"type":"string"},"id":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/pinterest/v1/pin_comments":{"post":{"operationId":"pinterest_pin_comments","summary":"Public comments & 'Tried it' notes on a pin: text, like/helpful counts, commenter and whether the pin owner highlighted it. Provide pin_id or pin_url. Paginate with meta.bookmark.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"pin_id":{"type":"string"},"pin_url":{"type":"string"},"id":{"type":"string"},"limit":{"type":"string"},"bookmark":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/pinterest/v1/related_pins":{"post":{"operationId":"pinterest_related_pins","summary":"'More like this' pins related to a source pin. Provide pin_id or pin_url.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"pin_id":{"type":"string"},"pin_url":{"type":"string"},"id":{"type":"string"},"limit":{"type":"string"},"bookmark":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/pinterest/v1/profile":{"post":{"operationId":"pinterest_profile","summary":"Public profile for a username: name, bio, follower/following/board/pin counts, avatar, website.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"}},"required":["username"]},"example":{"username":"nike"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/pinterest/v1/user_boards":{"post":{"operationId":"pinterest_user_boards","summary":"Public boards owned by a username: name, url, description, pin-count, cover image.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"}},"required":["username"]},"example":{"username":"nike"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/pinterest/v1/user_pins":{"post":{"operationId":"pinterest_user_pins","summary":"Pins created by a username (their feed). Paginate with meta.bookmark.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"limit":{"type":"string"},"bookmark":{"type":"string"}},"required":["username"]},"example":{"username":"nike"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/pinterest/v1/board":{"post":{"operationId":"pinterest_board","summary":"Board metadata: name, description, pin & follower & section counts, cover image, owner. Provide board_url or username + board.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"board_url":{"type":"string"},"username":{"type":"string"},"board":{"type":"string"},"board_slug":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/pinterest/v1/board_pins":{"post":{"operationId":"pinterest_board_pins","summary":"Pins inside a board. Provide board_url or username + board. Paginate with meta.bookmark.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"board_url":{"type":"string"},"username":{"type":"string"},"board":{"type":"string"},"board_slug":{"type":"string"},"limit":{"type":"string"},"bookmark":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/producthunt/v1/posts":{"post":{"operationId":"producthunt_posts","summary":"Today's or historical leaderboard launches (daily/weekly/monthly/yearly).","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string"},"year":{"type":"string"},"month":{"type":"string"},"day":{"type":"string"},"week":{"type":"string"},"period":{"type":"string"},"page":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/producthunt/v1/post":{"post":{"operationId":"producthunt_post","summary":"Full launch/product detail by slug: tagline, description, website, makers, hunter, topics, media gallery, external links, review aggregates, alternatives, and launch history.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"}},"required":["slug"]},"example":{"slug":"notion"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/producthunt/v1/reviews":{"post":{"operationId":"producthunt_reviews","summary":"Product reviews by slug: per-question answer text, rating + rating histogram, pro/con tags, and the AI review summary.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"page":{"type":"string"}},"required":["slug"]},"example":{"slug":"notion"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/producthunt/v1/topics":{"post":{"operationId":"producthunt_topics","summary":"Browse Product Hunt topics (interest tags applied to launches).","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"page":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/producthunt/v1/topic_posts":{"post":{"operationId":"producthunt_topic_posts","summary":"Launches filtered by topic slug.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"page":{"type":"string"}},"required":["slug"]},"example":{"slug":"notion"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/producthunt/v1/categories":{"post":{"operationId":"producthunt_categories","summary":"Browse Product Hunt product categories (the curated category tree, distinct from topics).","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"page":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/producthunt/v1/category":{"post":{"operationId":"producthunt_category","summary":"Products and launches inside one product category by slug.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"page":{"type":"string"}},"required":["slug"]},"example":{"slug":"notion"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/producthunt/v1/search":{"post":{"operationId":"producthunt_search","summary":"Keyword search across Product Hunt — products (default) or makers/users (type=users).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"type":{"type":"string"},"page":{"type":"string"}},"required":["query"]},"example":{"query":"ai"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/producthunt/v1/collections":{"post":{"operationId":"producthunt_collections","summary":"Public curated product collections index.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"page":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/producthunt/v1/collection":{"post":{"operationId":"producthunt_collection","summary":"Single collection (its products) by user+collection slug or full path.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"path":{"type":"string"},"username":{"type":"string"},"collection_slug":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/producthunt/v1/user":{"post":{"operationId":"producthunt_user","summary":"Maker/user profile plus their submitted launches.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"page":{"type":"string"}},"required":["username"]},"example":{"username":"rrhoover"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/producthunt/v1/discussions":{"post":{"operationId":"producthunt_discussions","summary":"Product Hunt discussions/forum thread feed (popular or newest).","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"order":{"type":"string"},"page":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/producthunt/v1/discussion":{"post":{"operationId":"producthunt_discussion","summary":"Single discussion thread with its full nested comment tree.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"forum":{"type":"string"},"path":{"type":"string"}},"required":["slug"]},"example":{"slug":"notion"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/rakuten/v1/search":{"post":{"operationId":"rakuten_search","summary":"Search Rakuten Ichiba by keyword or genre with sort and price filters — returns items with name, price (JPY), shop, points, shipping, rating and images. Paginated.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string"},"q":{"type":"string"},"genre_id":{"type":"string"},"page":{"type":"string"},"sort":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"}}},"example":{"keyword":"ヘッドホン"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/rakuten/v1/item":{"post":{"operationId":"rakuten_item","summary":"Get a Rakuten Ichiba product's detail — title, price (JPY), brand, shop, rating, images, category breadcrumbs, spec attributes, shipping and points.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"item_url":{"type":"string"},"shop_code":{"type":"string"},"item_path":{"type":"string"},"manage_number":{"type":"string"}}},"example":{"url":"https://item.rakuten.co.jp/seedcoms/10003515-198/"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/rakuten/v1/reviews":{"post":{"operationId":"rakuten_reviews","summary":"Get ALL buyer reviews for a Rakuten Ichiba item, paginated (30/page) — rating, body, reviewer nickname, post date and helpful count, plus the total review count.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"item_url":{"type":"string"},"shop_code":{"type":"string"},"item_path":{"type":"string"},"manage_number":{"type":"string"},"page":{"type":"string"}}},"example":{"url":"https://item.rakuten.co.jp/seedcoms/10003515-198/"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/rakuten/v1/variants":{"post":{"operationId":"rakuten_variants","summary":"Get a Rakuten Ichiba item's SKU variant matrix — every color/size/option combination with its price and images.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"item_url":{"type":"string"},"shop_code":{"type":"string"},"item_path":{"type":"string"},"manage_number":{"type":"string"}}},"example":{"url":"https://item.rakuten.co.jp/seedcoms/10003515-198/"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/rakuten/v1/shop":{"post":{"operationId":"rakuten_shop","summary":"List a Rakuten Ichiba shop's catalog by shop_code — every item the shop sells, paginated.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"shop_code":{"type":"string"},"sid":{"type":"string"},"page":{"type":"string"}},"required":["shop_code"]},"example":{"shop_code":"rakuten24"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/rakuten/v1/ranking":{"post":{"operationId":"rakuten_ranking","summary":"Get the Rakuten Ichiba best-seller ranking — overall or for a genre, by day/week/realtime/month.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"genre_id":{"type":"string"},"period":{"type":"string"},"page":{"type":"string"}}},"example":{"genre_id":"0"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/rakuten/v1/genres":{"post":{"operationId":"rakuten_genres","summary":"Browse the Rakuten Ichiba category (genre) tree — top-level categories, or pass genre_id for a subtree.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"genre_id":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/realtor/v1/search":{"post":{"operationId":"realtor_search","summary":"Search Realtor.com listings by location (for sale / for rent / recently sold), with structured filters: price, beds, baths, property type, sqft, lot size, year built, HOA, days-on-market and keywords. Paginate with offset.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"},"status":{"type":"string"},"sort":{"type":"string"},"limit":{"type":"string"},"offset":{"type":"string"},"map_bounds":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"beds_min":{"type":"string"},"beds_max":{"type":"string"},"baths_min":{"type":"string"},"home_type":{"type":"string"},"sqft_min":{"type":"string"},"sqft_max":{"type":"string"},"lot_min":{"type":"string"},"lot_max":{"type":"string"},"year_built_min":{"type":"string"},"year_built_max":{"type":"string"},"max_hoa":{"type":"string"},"days_on_max":{"type":"string"},"keywords":{"type":"string"}},"required":["location"]},"example":{"location":"Austin, TX"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/realtor/v1/detail":{"post":{"operationId":"realtor_detail","summary":"Full property record by property_id: RealEstimate value (+ range), price history, tax history, schools (with ratings), photos, interior/exterior feature groups, HOA, status flags, monthly-payment estimate and the listing agent/broker.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"property_id":{"type":"string"}},"required":["property_id"]},"example":{"property_id":"7211899596"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/realtor/v1/estimates":{"post":{"operationId":"realtor_estimates","summary":"Multi-source home-value estimates (AVMs) for a property — Realtor.com surfaces several independent valuation models (Collateral Analytics, Quantarium, Cotality/CoreLogic), each with its own value and high/low range. Returns the full set plus the best estimate. The valuation surface for pricing a home.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"property_id":{"type":"string"}},"required":["property_id"]},"example":{"property_id":"7211899596"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/realtor/v1/sold":{"post":{"operationId":"realtor_sold","summary":"Recently-sold homes by location (or map bounds), with the same structured filters as search — the comparable-sales surface for valuing a home.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"},"sort":{"type":"string"},"limit":{"type":"string"},"offset":{"type":"string"},"map_bounds":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"beds_min":{"type":"string"},"beds_max":{"type":"string"},"baths_min":{"type":"string"},"home_type":{"type":"string"},"sqft_min":{"type":"string"},"sqft_max":{"type":"string"},"lot_min":{"type":"string"},"lot_max":{"type":"string"},"year_built_min":{"type":"string"},"year_built_max":{"type":"string"},"max_hoa":{"type":"string"},"days_on_max":{"type":"string"},"keywords":{"type":"string"}},"required":["location"]},"example":{"location":"Austin, TX"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/realtor/v1/market_trends":{"post":{"operationId":"realtor_market_trends","summary":"Local housing-market intelligence for a US city or ZIP — median listing price, median sold price, median price per square foot, median days-on-market and median rent. The market-overview surface for a neighborhood or metro.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"}},"required":["location"]},"example":{"location":"Austin, TX"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/realtor/v1/comps":{"post":{"operationId":"realtor_comps","summary":"Comparable homes near a property — synthesized from recently-sold and active listings around the subject's coordinates, scored by distance, beds and sqft.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"property_id":{"type":"string"},"radius_miles":{"type":"string"},"max_comps":{"type":"string"},"include_active":{"type":"string"}},"required":["property_id"]},"example":{"property_id":"7211899596"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/realtor/v1/autocomplete":{"post":{"operationId":"realtor_autocomplete","summary":"Location autocomplete — suggest Realtor.com cities, ZIPs, neighborhoods, counties and schools for a free-text query. Resolve a fuzzy term before searching, or power a search box.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"example":{"query":"Austin"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/recall/v1/search":{"post":{"operationId":"recall_search","summary":"Search FDA recalls by keyword, category, classification, status, company, and date range with skip/limit pagination. Pass category=all (default) to span food+drug+device.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"category":{"type":"string"},"classification":{"type":"string"},"status":{"type":"string"},"company":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"sort":{"type":"string"},"limit":{"type":"string"},"skip":{"type":"string"},"include_severity":{"type":"string"}}},"example":{"query":"listeria","category":"food","limit":3}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/recall/v1/recall_detail":{"post":{"operationId":"recall_recall_detail","summary":"Full detail for one recall by its FDA recall_number (category auto-detected from prefix).","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recall_number":{"type":"string"},"category":{"type":"string"}},"required":["recall_number"]},"example":{"recall_number":"F-1397-2012"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/recall/v1/by_company":{"post":{"operationId":"recall_by_company","summary":"All recalls for a recalling firm / manufacturer, newest first, paginated.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"string"},"category":{"type":"string"},"classification":{"type":"string"},"status":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"limit":{"type":"string"},"skip":{"type":"string"},"include_severity":{"type":"string"}},"required":["company"]},"example":{"company":"Pfizer","category":"drug","limit":3}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/recall/v1/latest":{"post":{"operationId":"recall_latest","summary":"Most recent recalls across all categories (or one), within the last N days.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"classification":{"type":"string"},"days":{"type":"string"},"limit":{"type":"string"},"skip":{"type":"string"},"include_severity":{"type":"string"}}},"example":{"days":120,"limit":3}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/recall/v1/batch":{"post":{"operationId":"recall_batch","summary":"Run multiple keyword searches in one call (compliance-watch over a product list).","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string"},"category":{"type":"string"},"classification":{"type":"string"},"limit":{"type":"string"}},"required":["queries"]},"example":{"queries":["listeria","salmonella"],"category":"food","limit":2}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/recall/v1/stats":{"post":{"operationId":"recall_stats","summary":"Aggregate recall counts grouped by a field (classification/status/firm/state/type).","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"field":{"type":"string"},"query":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"}}},"example":{"category":"food","field":"classification"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/recall/v1/categories":{"post":{"operationId":"recall_categories","summary":"The recall taxonomy: FDA categories + EU Safety Gate product-category & risk-type enums + EU country list (reference data for filters).","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/recall/v1/eu_recall":{"post":{"operationId":"recall_eu_recall","summary":"One EU Safety Gate (RAPEX) recall/alert by notification id — product, risk, measure, traceability, reacting countries.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"language":{"type":"string"}},"required":["id"]},"example":{"id":10000308}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/recall/v1/eu_recalls":{"post":{"operationId":"recall_eu_recalls","summary":"Search/list EU Safety Gate alerts (the EU analogue of `search`): pages over recent weekly reports (open-data XML) and filters by query, product category, country and risk type, with skip/limit pagination. Each alert carries product, barcode, brand, risk, measures, notifying country and country of origin.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"category":{"type":"string"},"country":{"type":"string"},"risk_type":{"type":"string"},"weeks":{"type":"string"},"limit":{"type":"string"},"skip":{"type":"string"}}},"example":{"category":"Toys","weeks":2,"limit":3}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/recall/v1/eu_latest":{"post":{"operationId":"recall_eu_latest","summary":"The newest EU Safety Gate weekly report fully expanded into its ~80-100 product alerts (newest-published recalls across the EU/EEA).","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"string"}}},"example":{"limit":3}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/reclameaqui/v1/company/search":{"post":{"operationId":"reclameaqui_company_search","summary":"resolve a company by name/slug","tags":["Reputation & Reviews"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"slug":{"type":"string"}}},"example":{"query":"nubank"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/reclameaqui/v1/company/detail":{"post":{"operationId":"reclameaqui_company_detail","summary":"company profile + reputation index","tags":["Reputation & Reviews"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"company_id":{"type":"string"}}},"example":{"slug":"nubank"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/reclameaqui/v1/company/stats":{"post":{"operationId":"reclameaqui_company_stats","summary":"reputation metrics + main/performance problems","tags":["Reputation & Reviews"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"company_id":{"type":"string"}}},"example":{"slug":"nubank"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/reclameaqui/v1/company/complaints":{"post":{"operationId":"reclameaqui_company_complaints","summary":"paginated complaints for a company","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company_id":{"type":"string"},"status":{"type":"string"},"statuses":{"type":"string"},"limit":{"type":"string"},"page_size":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"},"company_slug":{"type":"string"},"company_name":{"type":"string"}},"required":["company_id"]},"example":{"company_id":"88850","company_slug":"nubank","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/reclameaqui/v1/complaints/search":{"post":{"operationId":"reclameaqui_complaints_search","summary":"search complaints by keyword","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"},"page_size":{"type":"string"},"date_from":{"type":"string"},"date_to":{"type":"string"}},"required":["query"]},"example":{"query":"banco","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/reclameaqui/v1/complaint/detail":{"post":{"operationId":"reclameaqui_complaint_detail","summary":"single complaint thread (HTML timeline)","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company_slug":{"type":"string"},"complaint_url_slug":{"type":"string"}},"required":["company_slug","complaint_url_slug"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/reddit/v1/subreddit_posts":{"post":{"operationId":"reddit_subreddit_posts","summary":"Posts in a subreddit, ranked by `sort`. Returns title/author/score/comment-count. Supports deep paging (`page`) and `flair` filtering.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string"},"sub":{"type":"string"},"sort":{"type":"string"},"time":{"type":"string"},"limit":{"type":"string"},"after":{"type":"string"},"page":{"type":"string"},"cursor":{"type":"string"},"flair":{"type":"string"},"source":{"type":"string"}},"required":["subreddit"]},"example":{"subreddit":"python","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/reddit/v1/multi_subreddit_posts":{"post":{"operationId":"reddit_multi_subreddit_posts","summary":"ONE merged newest-first feed across a whole watchlist of subreddits — pass up to 5000 names in a single call instead of polling each one. Built for near-real-time monitoring: posts show up seconds after they go live, `since_utc` returns only what is new since your last poll.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddits":{"type":"string"},"subs":{"type":"string"},"subreddit":{"type":"string"},"sub":{"type":"string"},"sort":{"type":"string"},"time":{"type":"string"},"limit":{"type":"string"},"since_utc":{"type":"string"},"max_pages":{"type":"string"},"after":{"type":"string"},"cursor":{"type":"string"}},"required":["subreddits"]},"example":{"subreddits":"python,rust,golang","limit":25}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/reddit/v1/post_comments":{"post":{"operationId":"reddit_post_comments","summary":"Threaded comments for a post. Returns author/body/score per comment.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"post_id":{"type":"string"},"id":{"type":"string"},"url":{"type":"string"},"sort":{"type":"string"},"limit":{"type":"string"},"depth":{"type":"string"},"source":{"type":"string"}},"required":["post_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/reddit/v1/search":{"post":{"operationId":"reddit_search","summary":"Search posts, comments, or users by `q` and/or `subreddit`/`author`. Returns results[]. Comment search reads Reddit's own live comment index. Cursor pagination + `flair` filter apply on the live source.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"query":{"type":"string"},"subreddit":{"type":"string"},"sub":{"type":"string"},"author":{"type":"string"},"type":{"type":"string"},"sort":{"type":"string"},"limit":{"type":"string"},"flair":{"type":"string"},"after":{"type":"string"},"page":{"type":"string"},"cursor":{"type":"string"},"after_utc":{"type":"string"},"before_utc":{"type":"string"},"source":{"type":"string"}}},"example":{"subreddit":"python","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/reddit/v1/user":{"post":{"operationId":"reddit_user","summary":"User profile or content. kind=about returns karma/profile; submitted/comments list items (with deep paging).","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"user":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"limit":{"type":"string"},"after":{"type":"string"},"page":{"type":"string"},"cursor":{"type":"string"},"sort":{"type":"string"},"source":{"type":"string"}},"required":["username"]},"example":{"username":"spez","kind":"about"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/reddit/v1/subreddit_about":{"post":{"operationId":"reddit_subreddit_about","summary":"Subreddit metadata: subscribers, description, created date, etc.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string"},"sub":{"type":"string"},"source":{"type":"string"}},"required":["subreddit"]},"example":{"subreddit":"python"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/reddit/v1/communities":{"post":{"operationId":"reddit_communities","summary":"Search subreddits by name/keyword — find communities matching a term, with each one's subscribers, title, description and over-18 flag.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"limit":{"type":"string"}},"required":["q"]},"example":{"q":"python"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/reddit/v1/trending":{"post":{"operationId":"reddit_trending","summary":"Site-wide discovery — hot/popular posts from r/popular or r/all (what's trending across Reddit right now), or the most-popular communities. No subreddit needed.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"scope":{"type":"string"},"kind":{"type":"string"},"sort":{"type":"string"},"time":{"type":"string"},"limit":{"type":"string"},"flair":{"type":"string"},"after":{"type":"string"},"page":{"type":"string"},"source":{"type":"string"}}},"example":{"scope":"popular","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/reddit/v1/user_search":{"post":{"operationId":"reddit_user_search","summary":"Find Reddit users by name/keyword — people search. Returns matching profiles with karma. (Same as search with type=user.)","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"query":{"type":"string"},"username":{"type":"string"},"limit":{"type":"string"},"after":{"type":"string"},"source":{"type":"string"}},"required":["q"]},"example":{"q":"python","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/reddit/v1/load_more_comments":{"post":{"operationId":"reddit_load_more_comments","summary":"Expand the collapsed 'more comments' nodes from a post_comments call — pass that response's more_ids to reveal the rest of the thread (build the FULL comment tree).","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"post_id":{"type":"string"},"more_ids":{"type":"string"},"link_id":{"type":"string"},"id":{"type":"string"},"url":{"type":"string"},"comment_ids":{"type":"string"},"limit":{"type":"string"},"sort":{"type":"string"},"source":{"type":"string"}},"required":["post_id","more_ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/reddit/v1/subreddit_extras":{"post":{"operationId":"reddit_subreddit_extras","summary":"Public subreddit extras: the community's rules and its wiki page index/content. (Moderator list is mod-only on Reddit and is not available logged-out.)","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string"},"sub":{"type":"string"},"include":{"type":"string"},"wiki_page":{"type":"string"},"source":{"type":"string"}},"required":["subreddit"]},"example":{"subreddit":"python"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/redfin/v1/search":{"post":{"operationId":"redfin_search","summary":"Search Redfin listings by location (for sale / recently sold / for rent) with structured filters: price, beds, baths, property type, square feet, lot size, year built, HOA and days-on-market, plus result sorting.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"},"url":{"type":"string"},"status":{"type":"string"},"sort":{"type":"string"},"max_results":{"type":"string"},"sold_within_days":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"min_beds":{"type":"string"},"max_beds":{"type":"string"},"min_baths":{"type":"string"},"max_baths":{"type":"string"},"min_sqft":{"type":"string"},"max_sqft":{"type":"string"},"min_lot_sqft":{"type":"string"},"max_lot_sqft":{"type":"string"},"min_year_built":{"type":"string"},"max_year_built":{"type":"string"},"max_hoa":{"type":"string"},"max_days_on_market":{"type":"string"},"property_types":{"type":"string"}},"required":["location"]},"example":{"location":"Austin, TX","max_results":30}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/redfin/v1/listing_detail":{"post":{"operationId":"redfin_listing_detail","summary":"Everything Redfin holds on one address: the live listing when the home is on the market (status, asking price, days on market, listing agent, description, photos) plus the property record underneath it - up to 17 years of price and tax history, schools, amenities, Redfin Estimate, mortgage and parcel. The current listing is looked up from the property id automatically; pass `listing_id` as well if you already have it and want to skip that step. `meta.is_live_listing` tells you which of the two you got: false means the home is not currently listed and what you see is the property record - the last closed sale.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"property_id":{"type":"string"},"listing_id":{"type":"string"},"url":{"type":"string"}},"required":["property_id"]},"example":{"property_id":"31287179"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/redfin/v1/similar":{"post":{"operationId":"redfin_similar","summary":"Comparable/similar listings near a property, with the comp price band.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"property_id":{"type":"string"},"listing_id":{"type":"string"},"url":{"type":"string"}},"required":["property_id"]},"example":{"property_id":"31287179"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/redfin/v1/autocomplete":{"post":{"operationId":"redfin_autocomplete","summary":"Resolve free text to Redfin places / agents / schools / buildings (ids + types).","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"example":{"query":"Seattle"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/redfin/v1/market_stats":{"post":{"operationId":"redfin_market_stats","summary":"Derived market snapshot for an area: median list price, $/sqft, days on market, inventory, price band.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"},"url":{"type":"string"}},"required":["location"]},"example":{"location":"Austin, TX"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/reed/v1/search":{"post":{"operationId":"reed_search","summary":"Search Reed.co.uk job postings by keyword with optional location, distance, salary range, job-type, date-posted, remote and sort filters. Returns up to 25 jobs per page with title, company, salary, location, dates and a plain-text description.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keywords":{"type":"string"},"location":{"type":"string"},"distance":{"type":"string"},"job_type":{"type":"string"},"full_time":{"type":"string"},"part_time":{"type":"string"},"graduate":{"type":"string"},"agency":{"type":"string"},"employer":{"type":"string"},"salary_from":{"type":"string"},"salary_to":{"type":"string"},"date_posted":{"type":"string"},"remote":{"type":"string"},"visa_sponsorship":{"type":"string"},"easy_apply":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"}},"required":["keywords"]},"example":{"keywords":"python developer","location":"London"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/reed/v1/detail":{"post":{"operationId":"reed_detail","summary":"Full posting for one Reed job by job_id (or a Reed job URL): title, company, salary (range + display), location breakdown (town/county/region/country/postcode/remote), full HTML + plain-text description, contract type, sector, eligibility, dates and breadcrumbs — plus related jobs.","tags":["Jobs & Hiring"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string"},"url":{"type":"string"},"include_similar":{"type":"string"}}},"example":{"job_id":"57258187"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/reed/v1/company-jobs":{"post":{"operationId":"reed_company_jobs","summary":"All public job postings at a specific company on Reed. Pass the company's Reed profile slug, full company URL, or its name; optionally narrow with the same keyword/location/salary/job-type/date filters as search.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"string"},"keywords":{"type":"string"},"location":{"type":"string"},"distance":{"type":"string"},"job_type":{"type":"string"},"salary_from":{"type":"string"},"salary_to":{"type":"string"},"date_posted":{"type":"string"},"remote":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"}},"required":["company"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/reed/v1/sector":{"post":{"operationId":"reed_sector","summary":"Browse Reed jobs by sector/category (e.g. 'it', 'accountancy', 'healthcare', 'engineering', 'sales', 'marketing'). Optionally scope by location and the same salary/job-type/date/remote filters as search.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sector":{"type":"string"},"location":{"type":"string"},"distance":{"type":"string"},"job_type":{"type":"string"},"salary_from":{"type":"string"},"salary_to":{"type":"string"},"date_posted":{"type":"string"},"remote":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"}},"required":["sector"]},"example":{"sector":"it"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/rightmove/v1/location_search":{"post":{"operationId":"rightmove_location_search","summary":"resolve a text location to a Rightmove locationIdentifier (LOS typeahead)","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"example":{"query":"London"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/rightmove/v1/search":{"post":{"operationId":"rightmove_search","summary":"Search UK property listings by location (for sale / to rent / commercial / student) with structured filters: price, beds, baths, property type, size, radius, added-within, sort, and (rent) furnishing & let-type. Paginate with index/max_pages.","tags":["Real Estate"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"},"location_identifier":{"type":"string"},"channel":{"type":"string"},"for_rent":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"beds_min":{"type":"string"},"beds_max":{"type":"string"},"baths_min":{"type":"string"},"property_type":{"type":"string"},"sqft_min":{"type":"string"},"sqft_max":{"type":"string"},"radius":{"type":"string"},"added_within_days":{"type":"string"},"sort":{"type":"string"},"furnished":{"type":"string"},"let_type":{"type":"string"},"must_have":{"type":"string"},"dont_show":{"type":"string"},"include_sstc":{"type":"string"},"max_pages":{"type":"string"},"fetch_all":{"type":"string"},"index":{"type":"string"},"filters":{"type":"string"}}},"example":{"location":"London"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/rightmove/v1/property_detail":{"post":{"operationId":"rightmove_property_detail","summary":"Full property record: price (+£/sqft), description, key features, tenure & lease years, living costs (council tax band, service charge, ground rent), structured features (utilities/heating/parking/garden/flood-risk), images, floorplans, EPC graphs, sizings, nearest stations, street-view coords and the listing agent.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"property_id":{"type":"string"}},"required":["property_id"]},"example":{"property_id":"148711631"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/rightmove/v1/agent":{"post":{"operationId":"rightmove_agent","summary":"estate-agent branch profile (+ that branch's live listings via BRANCH^id)","tags":["Real Estate"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"branch_url":{"type":"string"},"branch_id":{"type":"string"},"max_pages":{"type":"string"}}},"example":{"branch_url":"/estate-agents/agent/Aspire/Clapham-45021.html"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/rightmove/v1/similar":{"post":{"operationId":"rightmove_similar","summary":"listings similar to a property (same area + price/bedroom band)","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"property_id":{"type":"string"}},"required":["property_id"]},"example":{"property_id":"148711631"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/rightmove/v1/sold_prices":{"post":{"operationId":"rightmove_sold_prices","summary":"sold/transaction history: by location (search) or per-property (detail_url|uuid). Land-Registry sold data with full per-address transaction history. Area mode pages with `page` (25 rows/page, different rows on every page).","tags":["Real Estate"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"},"detail_url":{"type":"string"},"uuid":{"type":"string"},"page":{"type":"string"}}},"example":{"location":"SW9"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sam-gov/v1/search":{"post":{"operationId":"sam_gov_search","summary":"Search every US federal contract opportunity by phrase — the demand side of a $700bn/year buyer. Each hit carries the response deadline, the buying department and office, the notice type (is this a heads-up, a live RFP, or an award?) and a 250-character preview of the solicitation text. Pair with `active_only=true` for things you can still bid on, or with notice type 'a' to see who won what.","tags":["Government & Tenders"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"phrase":{"type":"string"},"active_only":{"type":"string"},"notice_types":{"type":"string"},"published_within_days":{"type":"string"},"sort":{"type":"string"},"limit":{"type":"string"},"offset":{"type":"string"}},"required":["q"]},"example":{"q":"web scraping","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sam-gov/v1/opportunity":{"post":{"operationId":"sam_gov_opportunity","summary":"One notice in full: the COMPLETE solicitation text (search only ever returns the first 250 characters), the response deadline with its timezone, the set-aside type, NAICS and PSC classification, place of performance, and the contracting officer's name, e-mail and phone as published on the notice.","tags":["Government & Tenders"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]},"example":{"id":"ffabe21b876649d2a1669edb4858cd48"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sam-gov/v1/attachments":{"post":{"operationId":"sam_gov_attachments","summary":"The documents attached to a notice — the statement of work, the pricing sheet, the Q&A, the amendment. Returns each file's name, MIME type, size, posting date and a direct public download URL. The real requirement usually lives in these PDFs, not in the notice body.","tags":["Government & Tenders"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]},"example":{"id":"ffabe21b876649d2a1669edb4858cd48"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sanctions/v1/screen":{"post":{"operationId":"sanctions_screen","summary":"Screen ONE name against the official sanctions lists → status (match | possible_match | no_match) + ranked matches with score, matched aliases, programs, DOB/place-of-birth, IDs, and the audit trail (which sources + thresholds were used). Add type/country/dob descriptors to cut false positives.","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"},"country":{"type":"string"},"dob":{"type":"string"},"threshold":{"type":"string"},"limit":{"type":"string"},"sources":{"type":"string"}},"required":["name"]},"example":{"name":"Ismail Haniya","type":"person"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sanctions/v1/batch":{"post":{"operationId":"sanctions_batch","summary":"Screen up to 100 names in one call (in-memory → cheap). Each item is a string or {name,type?,country?,dob?,threshold?}; per-item options override call defaults.","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"names":{"type":"string"},"type":{"type":"string"},"country":{"type":"string"},"threshold":{"type":"string"},"limit":{"type":"string"},"sources":{"type":"string"}},"required":["names"]},"example":{"names":["Ismail Haniya","Bank of Kunlun"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sanctions/v1/entity":{"post":{"operationId":"sanctions_entity","summary":"Fetch ONE full normalized list record by its uid (':', from a screen match) — every field on the designation.","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"type":"string"}},"required":["uid"]},"example":{"uid":"ofac_sdn:35096"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sanctions/v1/sources_status":{"post":{"operationId":"sanctions_sources_status","summary":"List freshness + reachability of every sanctions source (the trust signal): which lists were screened, how many records, the source's own published date, and whether the last .gov fetch succeeded.","tags":["Finance & Data"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"refresh":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/seek/v1/search":{"post":{"operationId":"seek_search","summary":"Search SEEK (seek.com.au) job postings by keyword with optional location, salary range, work-type, work-arrangement (remote/hybrid/on-site), date-posted, classification and sort filters. Returns up to 32 jobs per page with title, company, salary, location, dates and a teaser.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keywords":{"type":"string"},"location":{"type":"string"},"job_type":{"type":"string"},"work_arrangement":{"type":"string"},"salary_from":{"type":"string"},"salary_to":{"type":"string"},"date_posted":{"type":"string"},"classification":{"type":"string"},"subclassification":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"}},"required":["keywords"]},"example":{"keywords":"developer","location":"Sydney NSW"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/seek/v1/detail":{"post":{"operationId":"seek_detail","summary":"Full posting for one SEEK job by job_id (or a SEEK job URL): title, company, salary, location breakdown (suburb/state/postcode/country), full HTML + plain-text description, work types, work arrangement, classifications, bullet points, posted & expiry dates, apply/share link, and the employer's company profile (industry, size, website, rating, review count).","tags":["Jobs & Hiring"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string"},"url":{"type":"string"}}},"example":{"job_id":"92851167"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/seek/v1/company-jobs":{"post":{"operationId":"seek_company_jobs","summary":"All public job postings at a specific company on SEEK. Pass the company's numeric advertiser id (the `advertiser_id` field on any search/detail result), its SEEK company slug, a full SEEK company URL, or its name; optionally narrow with the same keyword/location/salary/work-type/date filters as search.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"string"},"keywords":{"type":"string"},"location":{"type":"string"},"job_type":{"type":"string"},"work_arrangement":{"type":"string"},"salary_from":{"type":"string"},"salary_to":{"type":"string"},"date_posted":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"}},"required":["company"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/seek/v1/classification":{"post":{"operationId":"seek_classification","summary":"Browse SEEK jobs by classification/category — either a SEEK classification numeric id (e.g. 6281 = Information & Communication Technology) or a category slug ('information-communication-technology', 'healthcare-medical', 'trades-services', 'accounting', 'sales', 'education-training'). Optionally scope by location and the same salary/work-type/date filters as search.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"classification":{"type":"string"},"location":{"type":"string"},"job_type":{"type":"string"},"work_arrangement":{"type":"string"},"salary_from":{"type":"string"},"salary_to":{"type":"string"},"date_posted":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"}},"required":["classification"]},"example":{"classification":"6281"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sephora/v1/search":{"post":{"operationId":"sephora_search","summary":"Search the Sephora catalog. Give a `query` ('mascara', 'vitamin c serum', 'dior lipstick', 'rare beauty blush') and get back 60 products per page, each with Sephora's own product id and default SKU id, brand, price (both ends when Sephora quotes a range), sale flag, star rating, review count, how many shades the product has, the image set, and Sephora's own merchandising flags (bestseller, new, limited edition, Sephora exclusive, same-day/pickup eligibility). Narrow by price band, sort by rating, price or newest. The live facet vocabulary Sephora publishes for your query comes back in `facets`, and the category counts and its own related searches come with it.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"max_results":{"type":"string"},"page":{"type":"string"},"sort":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"brand":{"type":"string"}},"required":["query"]},"example":{"query":"mascara","max_results":30}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sephora/v1/price":{"post":{"operationId":"sephora_price","summary":"Re-check ONE shade's price and stock, cheaply. Give it the Sephora SKU id you already hold and it returns the current price, the regular price, whether that shade is in stock and whether Sephora is flagging it as nearly gone — and nothing else: no description, images, ingredients, shade matrix or reviews. Built for refreshing a catalogue you already have rather than discovering products. It reads Sephora's own SKU-scoped route instead of the whole product document, so it costs a fraction of `product_detail` — measured live on ten products in ten categories: 7.9-14.3 KB against 59.9-421.5 KB for a full `product_detail` (5.2x-45.9x), or 32.5-350.5 KB with its reviews switched off (2.9x-38.1x). The saving grows with the shade count, because the product document carries every sibling shade and this one carries yours. `sku_id` is REQUIRED, because Sephora prices and stocks each shade and size separately: a 49-shade foundation had 9 shades sold out while the product was on sale, so a product-level answer would be right about the product and wrong about the shade you are actually selling.","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"sku_id":{"type":"string"},"product_id":{"type":"string"},"url":{"type":"string"}}},"example":{"sku_id":"2837375"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sephora/v1/product_detail":{"post":{"operationId":"sephora_product_detail","summary":"Get one Sephora product in full, by its product id (or its sephora.com URL). One call returns: the complete image gallery; the complete variant matrix — one row per shade/size with Sephora's own SKU id, that variant's price, sale price, in-stock flag, low-stock flag, swatch, image and URL; the specification set Sephora publishes (size, the structured attribute map — coverage, finish, formulation, skin type, skin concerns, ingredient preferences —, the highlight badges with their explanations, the full ingredient list and the how-to-use copy); the brand with its id and page; availability and price range; the star rating with its distribution; and the top customer reviews with their full text, titles, dates, helpfulness votes, reviewer skin-tone/skin-type/eye/age context and photos. It also returns the product's UPC/EAN barcodes, which Sephora's own product API does not publish anywhere.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"},"url":{"type":"string"},"sku_id":{"type":"string"},"include_reviews":{"type":"string"},"reviews_limit":{"type":"string"},"reviews_sort":{"type":"string"},"reviews_offset":{"type":"string"},"include_variant_images":{"type":"string"}},"required":["product_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/shixian/v1/search":{"post":{"operationId":"shixian_search","summary":"Find remote-work briefs by keyword — the ones that mention 爬虫 (scraping), 数据采集 (data collection), API, 小程序 or any term you care about — each with the client's published CNY budget, duration, full requirement text and applicant count. 🔴 shixian publishes no job-search endpoint (its own `keyword=` parameter is accepted and ignored — verified: a nonsense keyword still returns the full front page), so this action scans the board pages and matches here; the response states exactly how many pages and briefs were scanned.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"match":{"type":"string"},"fields":{"type":"string"},"pages":{"type":"string"},"limit":{"type":"string"},"city":{"type":"string"},"category":{"type":"string"},"type":{"type":"string"},"sort":{"type":"string"}},"required":["q"]},"example":{"q":"爬虫","pages":6}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/shixian/v1/jobs":{"post":{"operationId":"shixian_jobs","summary":"One page of the shixian board — 20 remote-work briefs with the complete requirement text and the client's published CNY budget on every row. Filter by city, role category, contract shape or the board's own shortlists (newest, zero-applicant, accepts-remote) and page through roughly 3,200 live briefs.","tags":["Jobs & Hiring"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"page":{"type":"string"},"limit":{"type":"string"},"city":{"type":"string"},"category":{"type":"string"},"type":{"type":"string"},"sort":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/shixian/v1/job":{"post":{"operationId":"shixian_job","summary":"One brief in full: the complete requirement text straight out of the page's own schema.org block, the client's budget, the hiring city and role, the project type, workdays per month, how many people have applied, how many have viewed it, and the poster's public marketplace profile (display name, location, team size, funding stage, product and team blurbs) — the profile fields the board hides behind a login wall on the list page.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]},"example":{"id":"1192790804"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/shixian/v1/filters":{"post":{"operationId":"shixian_filters","summary":"The board's own filter taxonomy, read live off the site: every city slug, every role-category slug, the contract shapes and the sort modes, each with its Chinese label. Use it to discover the exact values `search` and `jobs` accept — the site silently ignores a slug it does not know, so a typo would otherwise return the unfiltered board.","tags":["Jobs & Hiring"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/shopee/v1/product":{"post":{"operationId":"shopee_product","summary":"Full Shopee product detail by shop id + item id, or by product link. Title, description, every image, every variant with its own live stock count, variant option axes, attributes, 3-level category path, brand, condition, currency, seller location, product videos with direct MP4 links, and the seller's active voucher codes with their minimum spend. Works the same on all seven markets. Two limits stated up front: Shopee removes PRICE, rating, review count and sold count from the public product page for everyone, so this action returns them as null (the shop_showcase action returns a real live price for one item per shop); and Shopee publishes no weight or dimensions field at all","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"shop_id":{"type":"string"},"item_id":{"type":"string"},"url":{"type":"string"},"market":{"type":"string"}}},"example":{"shop_id":165796339,"item_id":4669874676,"market":"id"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/shopee/v1/batch":{"post":{"operationId":"shopee_batch","summary":"Up to 20 Shopee products in ONE call, fetched in parallel — the same data as the product action, at a lower per-product cost and in roughly the time a single product takes. Each entry succeeds or fails on its own: one dead id does not spoil the call","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"string"},"market":{"type":"string"}},"required":["items"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/shopee/v1/shop":{"post":{"operationId":"shopee_shop","summary":"Seller profile for a Shopee shop by shop id or shop handle — name, description, logo and cover, country and city, listing count, followers, rating with its good/neutral/bad split, response rate and response time, order preparation time, cancellation rate, official-shop and verified-seller status, and when the shop opened. This is also where the product page's missing shop NAME comes from, and it tells you in advance whether a shop's product pages can be read at all","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"shop_id":{"type":"string"},"username":{"type":"string"},"market":{"type":"string"}}},"example":{"shop_id":27651338,"market":"id"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/shopee/v1/shop_showcase":{"post":{"operationId":"shopee_shop_showcase","summary":"The one product Shopee itself publishes for a shop — WITH a real, live price, discount, rating and sold count. This is the only place a Shopee price is available publicly, and it is shop-addressed, not product-addressed: Shopee picks the item, one per shop. Use it to price-sample a seller, not to price a product you name","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"shop_id":{"type":"string"},"username":{"type":"string"},"market":{"type":"string"}}},"example":{"shop_id":27651338,"market":"id"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/shopify/v1/products":{"post":{"operationId":"shopify_products","summary":"Paginated product catalog from any public Shopify store: title, vendor, variants, prices, inventory status, tags, and images.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"store":{"type":"string"},"page":{"type":"string"},"limit":{"type":"string"},"max_items":{"type":"string"},"vendor":{"type":"string"},"product_type":{"type":"string"},"tag":{"type":"string"},"tags":{"type":"string"},"title_contains":{"type":"string"},"sku_contains":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"only_on_sale":{"type":"string"},"only_in_stock":{"type":"string"},"new_arrivals_days":{"type":"string"}},"required":["store"]},"example":{"store":"allbirds.com","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/shopify/v1/product":{"post":{"operationId":"shopify_product","summary":"Full detail for a single Shopify product by its handle (URL slug) or product page URL: title, vendor, variants, prices, images, and inventory.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"store":{"type":"string"},"handle":{"type":"string"}},"required":["store","handle"]},"example":{"store":"allbirds.com","handle":"mens-tree-runners-mist"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/shopify/v1/collections":{"post":{"operationId":"shopify_collections","summary":"Paginated list of public collections from a Shopify store: collection id, title, handle, description, and cover image.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"store":{"type":"string"},"page":{"type":"string"},"limit":{"type":"string"},"max_items":{"type":"string"}},"required":["store"]},"example":{"store":"kith.com","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/shopify/v1/collection_products":{"post":{"operationId":"shopify_collection_products","summary":"Paginated products within a specific Shopify collection — same product shape as the products action, filterable and sortable.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"store":{"type":"string"},"handle":{"type":"string"},"page":{"type":"string"},"limit":{"type":"string"},"max_items":{"type":"string"},"sort_by":{"type":"string"},"vendor":{"type":"string"},"product_type":{"type":"string"},"tag":{"type":"string"},"tags":{"type":"string"},"title_contains":{"type":"string"},"sku_contains":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"only_on_sale":{"type":"string"},"only_in_stock":{"type":"string"},"new_arrivals_days":{"type":"string"}},"required":["store","handle"]},"example":{"store":"allbirds.com","handle":"mens-tree-runners-mist"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/shopify/v1/search":{"post":{"operationId":"shopify_search","summary":"Predictive search across a Shopify store: matching products (title, price, variants, image) plus optional collection, page, and autocomplete query suggestions.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"store":{"type":"string"},"query":{"type":"string"},"limit":{"type":"string"},"page":{"type":"string"},"max_items":{"type":"string"},"resource_types":{"type":"string"},"resources":{"type":"string"},"vendor":{"type":"string"},"product_type":{"type":"string"},"tag":{"type":"string"},"tags":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"only_on_sale":{"type":"string"},"only_in_stock":{"type":"string"}},"required":["store","query"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/shopify/v1/recommendations":{"post":{"operationId":"shopify_recommendations","summary":"Related or complementary products that a Shopify store recommends for a given product — the store's own 'you may also like' / 'goes well with' set, same rich product shape.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"store":{"type":"string"},"handle":{"type":"string"},"intent":{"type":"string"},"limit":{"type":"string"}},"required":["store","handle"]},"example":{"store":"allbirds.com","handle":"mens-tree-runners-mist","limit":4}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/shopify/v1/collection":{"post":{"operationId":"shopify_collection","summary":"Metadata for a single Shopify collection by handle: title, description, cover image, published/updated dates, and product count.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"store":{"type":"string"},"handle":{"type":"string"}},"required":["store","handle"]},"example":{"store":"allbirds.com","handle":"mens-tree-runners-mist"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/shopify/v1/pages":{"post":{"operationId":"shopify_pages","summary":"Content pages published on a Shopify store (About, FAQ, Shipping, size guides, etc.): title, handle, URL, and HTML/plain-text body.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"store":{"type":"string"},"page":{"type":"string"},"limit":{"type":"string"},"max_items":{"type":"string"}},"required":["store"]},"example":{"store":"allbirds.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/shopify/v1/store_info":{"post":{"operationId":"shopify_store_info","summary":"Rich profile for a Shopify store: name, currency, country/city, product & collection counts, accepted card brands, social links, myshopify domain, and platform confirmation.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"store":{"type":"string"}},"required":["store"]},"example":{"store":"allbirds.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sitejabber/v1/reviews":{"post":{"operationId":"sitejabber_reviews","summary":"Get a business's customer reviews from Sitejabber by domain — paginated, 20 per page. Each review has the 1-5 star rating, title, full text, the five sub-ratings (service, value, shipping, returns, quality), date, the reviewer's country, verified status, products used, helpful/not-helpful vote counts and the business's reply. Page with `page` until meta.pagination.has_more is false.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"page":{"type":"string"}},"required":["domain"]},"example":{"domain":"amazon.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sitejabber/v1/aggregate":{"post":{"operationId":"sitejabber_aggregate","summary":"The rating summary for a business by domain (no individual reviews) — overall star rating, total review count, the 5★→1★ rating distribution, and the five sub-rating averages (service, value, shipping, returns, quality). Cheaper than `reviews` when you only need the score.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]},"example":{"domain":"amazon.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sitejabber/v1/detail":{"post":{"operationId":"sitejabber_detail","summary":"The full business profile on Sitejabber by domain — name, website, founded year, industry, the AI summary of what customers say, categories, overall rating, total review count, sub-rating breakdown and the rating distribution.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]},"example":{"domain":"nike.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sitejabber/v1/search":{"post":{"operationId":"sitejabber_search","summary":"Search Sitejabber for businesses by name or keyword — returns matching businesses with name, domain, overall rating, total review count, industry and AI summary. 28 per page.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"page":{"type":"string"}},"required":["query"]},"example":{"query":"amazon"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sitejabber/v1/category":{"post":{"operationId":"sitejabber_category","summary":"Browse the businesses listed in a Sitejabber category — returns each business's name, domain, rating, review count and industry, ranked. 10 per page; paginate with `page`. Pick a top-level category from the list, or pass any deeper sub-category slug from a sitejabber.com/categories/ URL (e.g. 'banking', 'insurance', 'web-hosting', 'dating') — those work too.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"page":{"type":"string"}},"required":["category"]},"example":{"category":"shopping"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/snapchat/v1/profile":{"post":{"operationId":"snapchat_profile","summary":"Full public Snapchat profile by username: display name, snapcode, subscriber count, bio, website, verified badge, profile picture, business id, related/suggested accounts, plus flags for whether the account has a live story and saved highlights.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"}},"required":["username"]},"example":{"username":"kyliejenner"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/snapchat/v1/story":{"post":{"operationId":"snapchat_story","summary":"The account's current public story — the live snaps (image/video media URLs, timestamps, titles) that the profile is publicly broadcasting right now.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"}},"required":["username"]},"example":{"username":"kyliejenner"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/snapchat/v1/highlights":{"post":{"operationId":"snapchat_highlights","summary":"The account's saved public highlight stories (curated highlights + Spotlight highlights), each with its snaps. First page (the SSR page serves the first batch; deeper pagination is not exposed to logged-out clients).","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"}},"required":["username"]},"example":{"username":"kyliejenner"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/snapchat/v1/lenses":{"post":{"operationId":"snapchat_lenses","summary":"The creator's own public AR lenses listed on their profile: name, preview image/video, icon, unlock URL and scannable UUID.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"}},"required":["username"]},"example":{"username":"kyliejenner"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/snapchat/v1/spotlight":{"post":{"operationId":"snapchat_spotlight","summary":"The public trending Spotlight feed — ~25 popular Spotlight videos with engagement stats (views, shares, comments, boosts), creator, AI-generated title/description/keywords and media URLs. No input needed; returns what Snapchat is surfacing now.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/snapchat/v1/spotlight_detail":{"post":{"operationId":"snapchat_spotlight_detail","summary":"Full metadata for one public Spotlight video by its story id (from a spotlight result's story_id or a snapchat.com/spotlight/ URL): name, description, view count, duration, dimensions, creator and media URL.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"story_id":{"type":"string"}},"required":["story_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/snapchat/v1/lens_directory":{"post":{"operationId":"snapchat_lens_directory","summary":"Snapchat's public top/trending AR lens directory: the featured lenses plus the lens category list. First page (the SSR catalog serves the first ~25; deeper cursor pagination is not exposed to logged-out clients).","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/snapchat/v1/lens_detail":{"post":{"operationId":"snapchat_lens_detail","summary":"Detail for one public AR lens by its scannable UUID (from a lens result's scannable_uuid or a snapchat.com/lens/ URL): name, creator, preview media, unlock URL, the Spotlight videos that use this lens, and related lenses.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uuid":{"type":"string"}},"required":["uuid"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/scores":{"post":{"operationId":"sports_data_scores","summary":"Live and final scores for a league — pass a date (YYYYMMDD) or range to get scores for any day; omit it for today/in-play games.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sport":{"type":"string"},"league":{"type":"string"},"date":{"type":"string"},"dates":{"type":"string"}},"required":["sport","league"]},"example":{"sport":"soccer","league":"eng.1","dates":"20260301-20260331"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/fixtures":{"post":{"operationId":"sports_data_fixtures","summary":"Upcoming fixtures and the match schedule for a league, by date or date range (same event shape as scores).","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sport":{"type":"string"},"league":{"type":"string"},"date":{"type":"string"},"dates":{"type":"string"}},"required":["sport","league"]},"example":{"sport":"soccer","league":"eng.1","dates":"20260301-20260331"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/standings":{"post":{"operationId":"sports_data_standings","summary":"Full league table / standings with wins, losses, points and per-team stats (soccer leagues accept a season year).","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sport":{"type":"string"},"league":{"type":"string"},"season":{"type":"string"}},"required":["sport","league"]},"example":{"sport":"basketball","league":"nba"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/team":{"post":{"operationId":"sports_data_team","summary":"Every team in a league, or one team's detail (record, next game, logo) when you pass a team_id.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sport":{"type":"string"},"league":{"type":"string"},"team_id":{"type":"string"}},"required":["sport","league"]},"example":{"sport":"basketball","league":"nba"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/roster":{"post":{"operationId":"sports_data_roster","summary":"A team's full roster / squad with jersey, position, age, height, weight and nationality for each player.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sport":{"type":"string"},"league":{"type":"string"},"team_id":{"type":"string"}},"required":["sport","league","team_id"]},"example":{"sport":"basketball","league":"nba","team_id":"13"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/summary":{"post":{"operationId":"sports_data_summary","summary":"Full match summary: boxscore, per-player stats, lineups, play-by-play count, head-to-head, win probability and odds.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sport":{"type":"string"},"league":{"type":"string"},"event_id":{"type":"string"}},"required":["sport","league","event_id"]},"example":{"sport":"baseball","league":"mlb","event_id":"401815591"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/odds":{"post":{"operationId":"sports_data_odds","summary":"Betting odds (moneyline, spread, over/under) — for one game by event_id, or every scheduled game in the league that has odds.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sport":{"type":"string"},"league":{"type":"string"},"event_id":{"type":"string"},"dates":{"type":"string"}},"required":["sport","league"]},"example":{"sport":"baseball","league":"mlb","event_id":"401815591"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/news":{"post":{"operationId":"sports_data_news","summary":"Latest news headlines and articles for a league.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sport":{"type":"string"},"league":{"type":"string"}},"required":["sport","league"]},"example":{"sport":"basketball","league":"nba"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/search":{"post":{"operationId":"sports_data_search","summary":"Look up a team or player by name across all sports (returns ids, badges, league, country) — start here when you only have a name.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"type":{"type":"string"}},"required":["query"]},"example":{"query":"Arsenal","type":"team"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/injuries":{"post":{"operationId":"sports_data_injuries","summary":"Current injury report for a league, grouped by team, with each player's status and detail.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sport":{"type":"string"},"league":{"type":"string"}},"required":["sport","league"]},"example":{"sport":"basketball","league":"nba"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/team_schedule":{"post":{"operationId":"sports_data_team_schedule","summary":"One team's full season schedule and results (every game the team plays, unlike league-wide fixtures).","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sport":{"type":"string"},"league":{"type":"string"},"team_id":{"type":"string"},"season":{"type":"string"}},"required":["sport","league","team_id"]},"example":{"sport":"basketball","league":"nba","team_id":"13"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/conferences":{"post":{"operationId":"sports_data_conferences","summary":"A league's conference / division structure (the directory of groups and sub-groups, e.g. college conferences).","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sport":{"type":"string"},"league":{"type":"string"}},"required":["sport","league"]},"example":{"sport":"basketball","league":"ncaam"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/leagues":{"post":{"operationId":"sports_data_leagues","summary":"Directory of every supported league/competition (key, name, sport) — call this first to discover the league keys the other actions take.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"sport":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/entity_search":{"post":{"operationId":"sports_data_entity_search","summary":"search players/teams/tournaments/managers/referees → SofaScore ids","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"example":{"query":"Haaland"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/live_events":{"post":{"operationId":"sports_data_live_events","summary":"all in-play events for a sport","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sport":{"type":"string"}},"required":["sport"]},"example":{"sport":"soccer"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/scheduled_events":{"post":{"operationId":"sports_data_scheduled_events","summary":"all scheduled events for a sport on a date","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sport":{"type":"string"},"date":{"type":"string"}},"required":["sport","date"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/tournament_seasons":{"post":{"operationId":"sports_data_tournament_seasons","summary":"Every season available for a competition (season id + year) — use the id to scope season-specific calls.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"league":{"type":"string"}},"required":["league"]},"example":{"league":"eng.1"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/match_statistics":{"post":{"operationId":"sports_data_match_statistics","summary":"detailed match stats (possession/shots/xG)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_id":{"type":"string"}},"required":["event_id"]},"example":{"event_id":"14025079"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/match_lineups":{"post":{"operationId":"sports_data_match_lineups","summary":"lineups + per-player ratings & stats","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_id":{"type":"string"}},"required":["event_id"]},"example":{"event_id":"14025079"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/match_momentum":{"post":{"operationId":"sports_data_match_momentum","summary":"attack-momentum graph","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_id":{"type":"string"}},"required":["event_id"]},"example":{"event_id":"14025079"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/match_incidents":{"post":{"operationId":"sports_data_match_incidents","summary":"goal/card/sub timeline","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_id":{"type":"string"}},"required":["event_id"]},"example":{"event_id":"14025079"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/match_best_players":{"post":{"operationId":"sports_data_match_best_players","summary":"best player per team","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_id":{"type":"string"}},"required":["event_id"]},"example":{"event_id":"401815591"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/match_h2h":{"post":{"operationId":"sports_data_match_h2h","summary":"head-to-head duel record","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_id":{"type":"string"}},"required":["event_id"]},"example":{"event_id":"14025079"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/match_managers":{"post":{"operationId":"sports_data_match_managers","summary":"both managers for a match","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_id":{"type":"string"}},"required":["event_id"]},"example":{"event_id":"401815591"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/match_odds":{"post":{"operationId":"sports_data_match_odds","summary":"multi-market odds for a match","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_id":{"type":"string"}},"required":["event_id"]},"example":{"event_id":"401815591"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/match_player_heatmap":{"post":{"operationId":"sports_data_match_player_heatmap","summary":"a player's touch heatmap in a match","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_id":{"type":"string"},"player_id":{"type":"string"}},"required":["event_id","player_id"]},"example":{"event_id":"401815591","player_id":"839956"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/match_player_shotmap":{"post":{"operationId":"sports_data_match_player_shotmap","summary":"a player's shotmap in a match","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_id":{"type":"string"},"player_id":{"type":"string"}},"required":["event_id","player_id"]},"example":{"event_id":"401815591","player_id":"839956"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/match_average_positions":{"post":{"operationId":"sports_data_match_average_positions","summary":"average player positions on the pitch","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_id":{"type":"string"}},"required":["event_id"]},"example":{"event_id":"14025079"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/player":{"post":{"operationId":"sports_data_player","summary":"Player profile: current team, position, market value, preferred foot, height, date of birth and contract — by SofaScore player id.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"player_id":{"type":"string"}},"required":["player_id"]},"example":{"player_id":"839956"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/player_season_stats":{"post":{"operationId":"sports_data_player_season_stats","summary":"player's season statistics in a league","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"player_id":{"type":"string"},"league":{"type":"string"},"season":{"type":"string"},"type":{"type":"string"}},"required":["player_id","league"]},"example":{"player_id":"839956","league":"eng.1","season_id":"61627"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/player_heatmap":{"post":{"operationId":"sports_data_player_heatmap","summary":"player's season heatmap","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"player_id":{"type":"string"},"league":{"type":"string"},"season":{"type":"string"}},"required":["player_id","league"]},"example":{"player_id":"839956","league":"eng.1"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/player_attributes":{"post":{"operationId":"sports_data_player_attributes","summary":"player attribute radar (att/tech/tac/def/cre)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"player_id":{"type":"string"}},"required":["player_id"]},"example":{"player_id":"839956"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/player_transfers":{"post":{"operationId":"sports_data_player_transfers","summary":"A player's full transfer history (from/to club, fee, date) by SofaScore player id.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"player_id":{"type":"string"}},"required":["player_id"]},"example":{"player_id":"839956"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/player_recent":{"post":{"operationId":"sports_data_player_recent","summary":"player's recent matches","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"player_id":{"type":"string"}},"required":["player_id"]},"example":{"player_id":"839956"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/team_details":{"post":{"operationId":"sports_data_team_details","summary":"Team profile: manager, venue, founding year and recent pregame form — by SofaScore team id.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"team_id":{"type":"string"}},"required":["team_id"]},"example":{"team_id":"17"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/team_squad":{"post":{"operationId":"sports_data_team_squad","summary":"A club's full current squad (every player with id, position, value) by SofaScore team id.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"team_id":{"type":"string"}},"required":["team_id"]},"example":{"team_id":"17"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/team_transfers":{"post":{"operationId":"sports_data_team_transfers","summary":"A club's transfers in and out (player, club, fee, date) by SofaScore team id.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"team_id":{"type":"string"}},"required":["team_id"]},"example":{"team_id":"17"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/team_season_stats":{"post":{"operationId":"sports_data_team_season_stats","summary":"team's season statistics in a league","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"team_id":{"type":"string"},"league":{"type":"string"},"season":{"type":"string"},"type":{"type":"string"}},"required":["team_id","league"]},"example":{"team_id":"17","league":"eng.1","season_id":"61627"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/team_form":{"post":{"operationId":"sports_data_team_form","summary":"team recent form + next/prev event","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"team_id":{"type":"string"}},"required":["team_id"]},"example":{"team_id":"13"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/team_goal_distributions":{"post":{"operationId":"sports_data_team_goal_distributions","summary":"goals scored/conceded by match period","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"team_id":{"type":"string"},"league":{"type":"string"},"season":{"type":"string"}},"required":["team_id","league"]},"example":{"team_id":"13","league":"eng.1"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/season_standings":{"post":{"operationId":"sports_data_season_standings","summary":"SofaScore league table for a competition (overall / home / away splits) with goals for/against and goal difference.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"league":{"type":"string"},"season":{"type":"string"},"type":{"type":"string"}},"required":["league"]},"example":{"league":"eng.1"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/season_top_players":{"post":{"operationId":"sports_data_season_top_players","summary":"season leaders by category","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"league":{"type":"string"},"season":{"type":"string"},"type":{"type":"string"}},"required":["league"]},"example":{"league":"eng.1","season_id":"61627"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/season_top_teams":{"post":{"operationId":"sports_data_season_top_teams","summary":"season top teams by category","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"league":{"type":"string"},"season":{"type":"string"},"type":{"type":"string"}},"required":["league"]},"example":{"league":"eng.1","season_id":"61627"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/team_of_week":{"post":{"operationId":"sports_data_team_of_week","summary":"team of the week (round or rounds list)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"league":{"type":"string"},"season":{"type":"string"},"round_id":{"type":"string"}},"required":["league"]},"example":{"league":"eng.1"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/power_rankings":{"post":{"operationId":"sports_data_power_rankings","summary":"season power rankings","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"league":{"type":"string"},"season":{"type":"string"},"round_id":{"type":"string"}},"required":["league"]},"example":{"league":"eng.1"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/cup_tree":{"post":{"operationId":"sports_data_cup_tree","summary":"knockout bracket / cup tree","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"league":{"type":"string"},"season":{"type":"string"}},"required":["league"]},"example":{"league":"eng.1"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/tournament_details":{"post":{"operationId":"sports_data_tournament_details","summary":"Competition metadata: country, tier, and the clubs with the most titles — by league key.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"league":{"type":"string"}},"required":["league"]},"example":{"league":"eng.1"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/manager":{"post":{"operationId":"sports_data_manager","summary":"Manager profile and full club-by-club career history (matches, wins, points) by SofaScore manager id.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"manager_id":{"type":"string"}},"required":["manager_id"]},"example":{"manager_id":"794075"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/referee":{"post":{"operationId":"sports_data_referee","summary":"referee details + per-tournament stats","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"referee_id":{"type":"string"}},"required":["referee_id"]},"example":{"referee_id":"65702"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/sports-data/v1/rankings":{"post":{"operationId":"sports_data_rankings","summary":"World rankings — FIFA men's football, or ATP / WTA tennis (set type; defaults to FIFA).","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"}}},"example":{"type":"fifa"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/questions":{"post":{"operationId":"stackoverflow_questions","summary":"Paginated questions by sort/tag; returns score, tags, body, owner/link attribution.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"sort":{"type":"string"},"tag":{"type":"string"},"tags":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"filter":{"type":"string"}}},"example":{"sort":"votes"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/question":{"post":{"operationId":"stackoverflow_question","summary":"Single question by id plus paginated answers.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"filter":{"type":"string"}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/answers":{"post":{"operationId":"stackoverflow_answers","summary":"Answer details by id/ids, or recent answers when no id is supplied.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"ids":{"type":"string"},"site":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"filter":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user":{"post":{"operationId":"stackoverflow_user","summary":"User profile by id/ids.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"site":{"type":"string"}},"required":["id"]},"example":{"id":22656}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_questions":{"post":{"operationId":"stackoverflow_user_questions","summary":"Paginated questions for a user.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_answers":{"post":{"operationId":"stackoverflow_user_answers","summary":"Paginated answers for a user.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_tags":{"post":{"operationId":"stackoverflow_user_tags","summary":"Paginated tag activity for a user.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"sort":{"type":"string"}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_badges":{"post":{"operationId":"stackoverflow_user_badges","summary":"Paginated badges for a user.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"sort":{"type":"string"}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/search":{"post":{"operationId":"stackoverflow_search","summary":"Advanced full-text/tag search, paginated.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"site":{"type":"string"},"tags":{"type":"string"},"tagged":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"filter":{"type":"string"}},"required":["q"]},"example":{"q":"async await"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/tags":{"post":{"operationId":"stackoverflow_tags","summary":"Paginated Stack Exchange tags.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/tag_questions":{"post":{"operationId":"stackoverflow_tag_questions","summary":"Paginated questions for a tag.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tag":{"type":"string"},"site":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"filter":{"type":"string"}},"required":["tag"]},"example":{"tag":"python"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/tag_info":{"post":{"operationId":"stackoverflow_tag_info","summary":"Tag info by tag name.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tag":{"type":"string"},"site":{"type":"string"}},"required":["tag"]},"example":{"tag":"python"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/comments":{"post":{"operationId":"stackoverflow_comments","summary":"Paginated comments for post id/ids.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/answer_comments":{"post":{"operationId":"stackoverflow_answer_comments","summary":"Comments left on one or more answers, by answer id.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/answer_questions":{"post":{"operationId":"stackoverflow_answer_questions","summary":"The questions that the given answers belong to, by answer id.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/badges":{"post":{"operationId":"stackoverflow_badges","summary":"All badges on the site, ranked bronze/silver/gold.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/badge":{"post":{"operationId":"stackoverflow_badge","summary":"Badge details by badge id.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/badge_name":{"post":{"operationId":"stackoverflow_badge_name","summary":"Named badges (the ones with a fixed name, e.g. 'Nice Answer').","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/badge_recipients":{"post":{"operationId":"stackoverflow_badge_recipients","summary":"Recently awarded badges across the site, with the users who earned them.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/badge_recipients_by_ids":{"post":{"operationId":"stackoverflow_badge_recipients_by_ids","summary":"Recent recipients of specific badges, by badge id.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/badge_tags":{"post":{"operationId":"stackoverflow_badge_tags","summary":"Tag-based badges (badges earned for activity within a tag).","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/collectives":{"post":{"operationId":"stackoverflow_collectives","summary":"All Stack Overflow Collectives (curated communities like 'Google Cloud').","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/collective":{"post":{"operationId":"stackoverflow_collective","summary":"Details for a Collective by its slug.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slugs":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"}},"required":["slugs"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/collective_questions":{"post":{"operationId":"stackoverflow_collective_questions","summary":"Questions associated with a Collective.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slugs":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}},"required":["slugs"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/collective_answers":{"post":{"operationId":"stackoverflow_collective_answers","summary":"Answers associated with a Collective.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slugs":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}},"required":["slugs"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/collective_tags":{"post":{"operationId":"stackoverflow_collective_tags","summary":"Tags that belong to a Collective.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slugs":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}},"required":["slugs"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/collective_users":{"post":{"operationId":"stackoverflow_collective_users","summary":"Members of a Collective, by reputation.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slugs":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}},"required":["slugs"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/comments_all":{"post":{"operationId":"stackoverflow_comments_all","summary":"Recent comments across the whole site.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/comment":{"post":{"operationId":"stackoverflow_comment","summary":"Comment details by comment id.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/info":{"post":{"operationId":"stackoverflow_info","summary":"Site statistics: total questions, answers, users, badges, API revision.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/posts":{"post":{"operationId":"stackoverflow_posts","summary":"Recent posts (questions and answers together) across the site.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/post":{"post":{"operationId":"stackoverflow_post","summary":"Post details by id, whether it is a question or an answer.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/post_comments":{"post":{"operationId":"stackoverflow_post_comments","summary":"Comments on a post (question or answer), by post id.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/post_revisions":{"post":{"operationId":"stackoverflow_post_revisions","summary":"Edit history (revisions) of a post, by post id.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/post_suggested_edits":{"post":{"operationId":"stackoverflow_post_suggested_edits","summary":"Suggested edits submitted for a post, by post id.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/privileges":{"post":{"operationId":"stackoverflow_privileges","summary":"The site privilege ladder (what each reputation level unlocks).","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/question_answers":{"post":{"operationId":"stackoverflow_question_answers","summary":"All answers to one or more questions, by question id.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/question_comments":{"post":{"operationId":"stackoverflow_question_comments","summary":"Comments on a question, by question id.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/question_linked":{"post":{"operationId":"stackoverflow_question_linked","summary":"Questions that link to the given question(s).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/question_related":{"post":{"operationId":"stackoverflow_question_related","summary":"Questions Stack Overflow considers related to the given question(s).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/question_timeline":{"post":{"operationId":"stackoverflow_question_timeline","summary":"Full event timeline of a question (edits, answers, comments, votes, close/reopen).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/questions_featured":{"post":{"operationId":"stackoverflow_questions_featured","summary":"Featured (bountied) questions on the site.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/questions_no_answers":{"post":{"operationId":"stackoverflow_questions_no_answers","summary":"Questions with zero answers (no answers at all).","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/questions_unanswered":{"post":{"operationId":"stackoverflow_questions_unanswered","summary":"Questions the community considers unanswered (no accepted/upvoted answer).","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/revisions":{"post":{"operationId":"stackoverflow_revisions","summary":"Revision details by revision guid.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/search_simple":{"post":{"operationId":"stackoverflow_search_simple","summary":"Title-only question search — find questions whose title contains given text.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"intitle":{"type":"string"},"tag":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}},"required":["intitle"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/similar":{"post":{"operationId":"stackoverflow_similar","summary":"Find questions similar to a title (duplicate detection).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"tag":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}},"required":["title"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/search_excerpts":{"post":{"operationId":"stackoverflow_search_excerpts","summary":"Full-text search returning highlighted match excerpts for questions and answers.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"tag":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}},"required":["q"]},"example":{"q":"async await"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/suggested_edits":{"post":{"operationId":"stackoverflow_suggested_edits","summary":"Recent suggested edits across the site.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/suggested_edit":{"post":{"operationId":"stackoverflow_suggested_edit","summary":"Suggested-edit details by id.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/tags_moderator_only":{"post":{"operationId":"stackoverflow_tags_moderator_only","summary":"Tags only moderators can apply.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/tags_required":{"post":{"operationId":"stackoverflow_tags_required","summary":"Tags that must be present on every question (where the site requires them).","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/tag_synonyms":{"post":{"operationId":"stackoverflow_tag_synonyms","summary":"All tag synonyms on the site (e.g. 'js' → 'javascript').","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/tag_faq":{"post":{"operationId":"stackoverflow_tag_faq","summary":"The frequently-asked (FAQ) questions for a tag.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tags":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}},"required":["tags"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/tag_related":{"post":{"operationId":"stackoverflow_tag_related","summary":"Tags that commonly appear together with the given tag.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tags":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}},"required":["tags"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/tag_synonyms_by_tags":{"post":{"operationId":"stackoverflow_tag_synonyms_by_tags","summary":"Synonyms that map to a specific tag.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tags":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}},"required":["tags"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/tag_top_answerers":{"post":{"operationId":"stackoverflow_tag_top_answerers","summary":"Top answerers in a tag (the experts), all-time or last month.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tag":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"period":{"type":"string"}},"required":["tag"]},"example":{"tag":"python"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/tag_top_askers":{"post":{"operationId":"stackoverflow_tag_top_askers","summary":"Top askers in a tag, all-time or last month.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tag":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"period":{"type":"string"}},"required":["tag"]},"example":{"tag":"python"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/tag_wikis":{"post":{"operationId":"stackoverflow_tag_wikis","summary":"The wiki/excerpt body that describes a tag.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tags":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"}},"required":["tags"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/users":{"post":{"operationId":"stackoverflow_users","summary":"Site users, by reputation (the leaderboard).","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_comments":{"post":{"operationId":"stackoverflow_user_comments","summary":"Comments written by a user.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_comments_to_user":{"post":{"operationId":"stackoverflow_user_comments_to_user","summary":"Comments a user directed at one specific other user.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"toid":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}},"required":["ids","toid"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_favorites":{"post":{"operationId":"stackoverflow_user_favorites","summary":"Questions a user bookmarked (favorited).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_mentioned":{"post":{"operationId":"stackoverflow_user_mentioned","summary":"Comments that @-mention a user.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_network_activity":{"post":{"operationId":"stackoverflow_user_network_activity","summary":"A user's activity across the entire Stack Exchange network (all sites).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_posts":{"post":{"operationId":"stackoverflow_user_posts","summary":"All posts (questions and answers) authored by a user.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_privileges":{"post":{"operationId":"stackoverflow_user_privileges","summary":"The privileges a user has unlocked at their reputation level.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_questions_featured":{"post":{"operationId":"stackoverflow_user_questions_featured","summary":"A user's questions that currently carry a bounty (featured).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_questions_no_answers":{"post":{"operationId":"stackoverflow_user_questions_no_answers","summary":"A user's questions that have no answers.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_questions_unaccepted":{"post":{"operationId":"stackoverflow_user_questions_unaccepted","summary":"A user's questions that have answers but none accepted.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_questions_unanswered":{"post":{"operationId":"stackoverflow_user_questions_unanswered","summary":"A user's questions the community considers unanswered.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"},"filter":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_reputation":{"post":{"operationId":"stackoverflow_user_reputation","summary":"A user's reputation changes (the rep events feed).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_reputation_history":{"post":{"operationId":"stackoverflow_user_reputation_history","summary":"Public reputation history of a user (each gain/loss event).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_suggested_edits":{"post":{"operationId":"stackoverflow_user_suggested_edits","summary":"Suggested edits a user has submitted.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_top_answers_in_tags":{"post":{"operationId":"stackoverflow_user_top_answers_in_tags","summary":"A user's highest-scoring answers within specific tags.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"tags":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"filter":{"type":"string"}},"required":["id","tags"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_top_questions_in_tags":{"post":{"operationId":"stackoverflow_user_top_questions_in_tags","summary":"A user's highest-scoring questions within specific tags.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"tags":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"filter":{"type":"string"}},"required":["id","tags"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_timeline":{"post":{"operationId":"stackoverflow_user_timeline","summary":"A user's activity timeline (posts, comments, badges, rep events).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_top_answer_tags":{"post":{"operationId":"stackoverflow_user_top_answer_tags","summary":"The tags a user is strongest in by answer score.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_top_question_tags":{"post":{"operationId":"stackoverflow_user_top_question_tags","summary":"The tags a user is strongest in by question score.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/user_top_tags":{"post":{"operationId":"stackoverflow_user_top_tags","summary":"A user's top tags overall (combined question + answer activity).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/moderators":{"post":{"operationId":"stackoverflow_moderators","summary":"All moderators on the site.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/elected_moderators":{"post":{"operationId":"stackoverflow_elected_moderators","summary":"Moderators who were elected (excludes appointed/employee moderators).","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/errors":{"post":{"operationId":"stackoverflow_errors","summary":"The catalog of Stack Exchange API error codes and their meanings.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/error":{"post":{"operationId":"stackoverflow_error","summary":"Simulate one Stack Exchange API error by its id (returns the error as if it occurred).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"}},"required":["id"]},"example":{"id":11227809}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/sites":{"post":{"operationId":"stackoverflow_sites","summary":"Every site in the Stack Exchange network (Stack Overflow, Server Fault, Super User, etc.).","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"},"sort":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/associated_users":{"post":{"operationId":"stackoverflow_associated_users","summary":"A user's accounts across all Stack Exchange sites (network accounts).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stackoverflow/v1/merge_history":{"post":{"operationId":"stackoverflow_merge_history","summary":"Account-merge history for a user id.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"string"},"page":{"type":"string"},"pagesize":{"type":"string"},"order":{"type":"string"}},"required":["ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/status-intel/v1/status":{"post":{"operationId":"status_intel_status","summary":"Current OVERALL status for a vendor → normalized indicator (operational/degraded/partial_outage/major_outage/maintenance) + is_operational boolean + description.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"vendor":{"type":"string"}},"required":["vendor"]},"example":{"vendor":"github"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/status-intel/v1/incidents":{"post":{"operationId":"status_intel_incidents","summary":"Recent or active incidents for a vendor (title, impact, status, timeline of updates, affected components). active_only=true → just the ongoing ones.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"vendor":{"type":"string"},"active_only":{"type":"string"},"limit":{"type":"string"}},"required":["vendor"]},"example":{"vendor":"github"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/status-intel/v1/components":{"post":{"operationId":"status_intel_components","summary":"Per-component (sub-service) health for a vendor — which specific products are degraded.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"vendor":{"type":"string"},"limit":{"type":"string"}},"required":["vendor"]},"example":{"vendor":"cloudflare"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/status-intel/v1/summary":{"post":{"operationId":"status_intel_summary","summary":"Full one-call snapshot for a vendor: overall status + components + active incidents + scheduled maintenances (the whole status page in one normalized object).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"vendor":{"type":"string"}},"required":["vendor"]},"example":{"vendor":"datadog"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/status-intel/v1/check_multi":{"post":{"operationId":"status_intel_check_multi","summary":"THE dashboard call: give your stack as a list (keys / brands / domains / status hosts) → each is auto-resolved to its real status page and its LIVE status is returned, read from the SOURCE. 'Are any of my dependencies down right now?' Per-item errors never fail the whole call.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"vendors":{"type":"string"}},"required":["vendors"]},"example":{"vendors":"github,openai,cloudflare"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/status-intel/v1/batch":{"post":{"operationId":"status_intel_batch","summary":"Alias of check_multi — overall status for a batch of vendors in one call (up to 25).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"vendors":{"type":"string"}},"required":["vendors"]},"example":{"vendors":"github,openai,cloudflare"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/status-intel/v1/list_vendors":{"post":{"operationId":"status_intel_list_vendors","summary":"The supported vendor set (key → name, kind, category, status host). Optionally filtered by category. Also lists explicitly-unsupported vendors (e.g. Azure) with the reason.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/steam-games/v1/app_detail":{"post":{"operationId":"steam_games_app_detail","summary":"full game metadata from store appdetails (+structured languages; include_tags adds community tags/franchise/links)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"appid":{"type":"string"},"cc":{"type":"string"},"country":{"type":"string"},"lang":{"type":"string"},"language":{"type":"string"},"include_raw":{"type":"string"},"include_tags":{"type":"string"}},"required":["appid"]},"example":{"appid":730,"cc":"us"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/steam-games/v1/price":{"post":{"operationId":"steam_games_price","summary":"regional price + discount (appdetails price_overview)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"appid":{"type":"string"},"cc":{"type":"string"},"country":{"type":"string"},"lang":{"type":"string"},"language":{"type":"string"}},"required":["appid"]},"example":{"appid":1245620,"cc":"us"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/steam-games/v1/reviews":{"post":{"operationId":"steam_games_reviews","summary":"user reviews + query_summary; review_type/day_range/trend (day|week|month|year)/sort=funny; redact_pii drops author identity","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"appid":{"type":"string"},"language":{"type":"string"},"lang":{"type":"string"},"num_per_page":{"type":"string"},"limit":{"type":"string"},"filter":{"type":"string"},"review_type":{"type":"string"},"day_range":{"type":"string"},"trend":{"type":"string"},"sort":{"type":"string"},"purchase_type":{"type":"string"},"cursor":{"type":"string"},"redact_pii":{"type":"string"},"redactPii":{"type":"string"},"redact_author":{"type":"string"}},"required":["appid"]},"example":{"appid":730,"num_per_page":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/steam-games/v1/player_stats":{"post":{"operationId":"steam_games_player_stats","summary":"steamspy owners + optional current player count","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"appid":{"type":"string"},"include_current_players":{"type":"string"}},"required":["appid"]},"example":{"appid":730}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/steam-games/v1/search":{"post":{"operationId":"steam_games_search","summary":"store search → appid+price (+metascore on keyword); faceting: tags/type/category1/supportedlang/maxprice/specials. term OR a facet required.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"term":{"type":"string"},"query":{"type":"string"},"q":{"type":"string"},"count":{"type":"string"},"limit":{"type":"string"},"start":{"type":"string"},"cc":{"type":"string"},"country":{"type":"string"},"lang":{"type":"string"},"language":{"type":"string"},"tags":{"type":"string"},"type":{"type":"string"},"category1":{"type":"string"},"supportedlang":{"type":"string"},"maxprice":{"type":"string"},"specials":{"type":"string"},"force_infinite":{"type":"string"}}},"example":{"term":"portal","count":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/steam-games/v1/top_sellers":{"post":{"operationId":"steam_games_top_sellers","summary":"Steam top sellers chart slice (appid+price per item); same facets as search","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"string"},"limit":{"type":"string"},"start":{"type":"string"},"cc":{"type":"string"},"country":{"type":"string"},"lang":{"type":"string"},"language":{"type":"string"},"tags":{"type":"string"},"type":{"type":"string"},"category1":{"type":"string"},"supportedlang":{"type":"string"},"maxprice":{"type":"string"}}},"example":{"count":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/steam-games/v1/news":{"post":{"operationId":"steam_games_news","summary":"official game news (ISteamNews/GetNewsForApp)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"appid":{"type":"string"},"count":{"type":"string"},"limit":{"type":"string"},"maxlength":{"type":"string"}},"required":["appid"]},"example":{"appid":730,"count":3}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/steam-games/v1/tags":{"post":{"operationId":"steam_games_tags","summary":"community tags (InitAppTagModal) + franchise + external links (store page)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"appid":{"type":"string"},"cc":{"type":"string"},"country":{"type":"string"},"lang":{"type":"string"},"language":{"type":"string"}},"required":["appid"]},"example":{"appid":730}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/steam-games/v1/similar_games":{"post":{"operationId":"steam_games_similar_games","summary":"recommended similar games (appids) via /recommended/morelike","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"appid":{"type":"string"},"count":{"type":"string"},"limit":{"type":"string"}},"required":["appid"]},"example":{"appid":1245620,"count":6}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/steam-games/v1/artworks":{"post":{"operationId":"steam_games_artworks","summary":"official art-asset URLs (header/capsule/library/hero/logo/background)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"appid":{"type":"string"},"cc":{"type":"string"},"country":{"type":"string"},"lang":{"type":"string"},"language":{"type":"string"}},"required":["appid"]},"example":{"appid":730}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/steam-games/v1/guides":{"post":{"operationId":"steam_games_guides","summary":"Community guides for a game (Steam Workshop guides) — top-rated, trending or most-recent. Each guide: title, author, star rating, preview image and URL.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"appid":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"},"limit":{"type":"string"}},"required":["appid"]},"example":{"appid":570,"sort":"trend","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/steam-games/v1/dlc":{"post":{"operationId":"steam_games_dlc","summary":"List a game's DLC with names + regional prices. The base game's DLC appids are resolved to titles/prices (bounded by `resolve` to keep latency sane).","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"appid":{"type":"string"},"cc":{"type":"string"},"country":{"type":"string"},"lang":{"type":"string"},"language":{"type":"string"},"resolve":{"type":"string"},"count":{"type":"string"},"limit":{"type":"string"}},"required":["appid"]},"example":{"appid":1245620,"resolve":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/steam-games/v1/package":{"post":{"operationId":"steam_games_package","summary":"Steam package / bundle (a.k.a. 'sub') details — the apps it contains, the bundled price, platforms and release date. Use the package ids from app_detail.package_groups.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"packageid":{"type":"string"},"package_id":{"type":"string"},"subid":{"type":"string"},"id":{"type":"string"},"cc":{"type":"string"},"country":{"type":"string"},"lang":{"type":"string"},"language":{"type":"string"}},"required":["packageid"]},"example":{"packageid":440408}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/steam-games/v1/featured":{"post":{"operationId":"steam_games_featured","summary":"Store-front discovery lists: specials (current deals), new_releases, coming_soon and top_sellers — each with appid + price. Pick one with `category`, or get all four.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"type":{"type":"string"},"count":{"type":"string"},"limit":{"type":"string"},"cc":{"type":"string"},"country":{"type":"string"},"lang":{"type":"string"},"language":{"type":"string"}}},"example":{"category":"specials","count":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/steam-games/v1/most_played":{"post":{"operationId":"steam_games_most_played","summary":"Official Steam most-played chart — live concurrent player count + 24h peak per game (the only keyless source of all-time/period peak). Optionally enrich rows with names.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"string"},"limit":{"type":"string"},"resolve":{"type":"string"},"cc":{"type":"string"},"country":{"type":"string"},"lang":{"type":"string"},"language":{"type":"string"}}},"example":{"count":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/steam-games/v1/review_histogram":{"post":{"operationId":"steam_games_review_histogram","summary":"Recommendations up/down over the game's lifetime (Steam's own review histogram) — the data behind the store review-trend graph.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"appid":{"type":"string"},"lang":{"type":"string"},"language":{"type":"string"}},"required":["appid"]},"example":{"appid":730}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/steam-games/v1/player_profile":{"post":{"operationId":"steam_games_player_profile","summary":"Public Steam profile summary by 64-bit steamid OR vanity name (keyless). Returns persona, avatar, online state, ban flags and the privacy state. Note: owned-games / friends are NOT available on Steam's keyless surface — this is the profile summary.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"steamid":{"type":"string"},"steamid64":{"type":"string"},"steam_id":{"type":"string"},"vanity":{"type":"string"},"vanity_url":{"type":"string"},"profile":{"type":"string"}}},"example":{"vanity":"gabelogannewell"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/steam-games/v1/resolve":{"post":{"operationId":"steam_games_resolve","summary":"Turn a human name into ids so callers never hand-find a URL: a game name → matching appids (chains to app_detail), or a vanity name (kind=profile) → steamid64.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"term":{"type":"string"},"query":{"type":"string"},"q":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"count":{"type":"string"},"limit":{"type":"string"}},"required":["term"]},"example":{"term":"elden ring"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stockx/v1/product_detail":{"post":{"operationId":"stockx_product_detail","summary":"full product by `url` OR `url_key`/`id`/`uuid`: title/brand/model/sku/category/colorway/retail_price/release_date/image + market{lowest_ask,highest_bid,number_of_asks/bids,last_sale,sales_last_72h,last_sale_change_pct/value,avg_price_72h/90d/annual,sales_count_*,price_premium=(last_sale-retail)/retail, volatility=CV-of-recent-sales, ask_service_levels{standard/express_*: count,lowest_ask,processing_fee,delivery}} + per-size variants[]{size,lowest_ask,highest_bid,last_sale}. The market-data moat. `currency` (USD/EUR/GBP/…) + `market` (US/GB/DE/…) optional.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"url_key":{"type":"string"},"id":{"type":"string"},"uuid":{"type":"string"},"currency":{"type":"string"},"market":{"type":"string"}}},"example":{"url_key":"air-jordan-4-retro-bred-reimagined"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stockx/v1/search":{"post":{"operationId":"stockx_search","summary":"product search → results[]{id,url_key,url,title,brand,sku,category,image,lowest_ask,highest_bid,last_sale} + page_info{page,limit,total}. Resolves url_keys for product_detail. Optional facet filters: `brand` (e.g. Jordan), `gender` (men/women/…), `category` (sneakers/apparel/…) + `sort` (most-active/featured/release_date/lowest_ask). Return up to 1000 products in one call with `max_results` (40/page, paged for you) — that is StockX's own ceiling, its grid stops at page 26. `page` picks where the window starts. `currency`/`market` optional.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"max_results":{"type":"string"},"page":{"type":"string"},"currency":{"type":"string"},"market":{"type":"string"},"brand":{"type":"string"},"gender":{"type":"string"},"category":{"type":"string"},"sort":{"type":"string"}},"required":["query"]},"example":{"query":"jordan 1"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stockx/v1/recent_sales":{"post":{"operationId":"stockx_recent_sales","summary":"recent transaction feed by `url`/`url_key`/`id` → sales[]{amount,created_at} (most recent first) + product ref. Best-effort market-history. `currency`/`market` optional.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"url_key":{"type":"string"},"id":{"type":"string"},"uuid":{"type":"string"},"currency":{"type":"string"},"market":{"type":"string"}}},"example":{"url_key":"air-jordan-4-retro-bred-reimagined"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stockx/v1/suggest":{"post":{"operationId":"stockx_suggest","summary":"autocomplete query suggestions for `query` (QuerySuggestion text; falls back to search-derived titles if the suggest op drifts).","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"example":{"query":"jordan"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stockx/v1/price_history":{"post":{"operationId":"stockx_price_history","summary":"historical price time-series for a product, aggregated from the deep sales feed → series[]{date,count,avg,min,max,last} (oldest→newest) + summary{points,sales_sampled,min,max,avg,first_date,last_date,window_complete}. `window` (30d/90d/180d/365d/all) bounds lookback; `bucket` (day/week/month) sets granularity; optional `size` for per-size history. The #1 resale-trader ask. `currency` optional.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"url_key":{"type":"string"},"id":{"type":"string"},"uuid":{"type":"string"},"window":{"type":"string"},"bucket":{"type":"string"},"size":{"type":"string"},"currency":{"type":"string"}}},"example":{"url_key":"air-jordan-4-retro-bred-reimagined","window":"90d","bucket":"day"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stockx/v1/sales_history":{"post":{"operationId":"stockx_sales_history","summary":"deep paginated transaction log → sales[]{amount,created_at,cursor} (newest first) + page_info{cursor,has_more,total,limit,returned} + product. Far deeper than recent_sales (StockX exposes the full ledger, e.g. 60k+ sales). Cursor-paginate with `cursor`; optional `size` filters to one variant. `limit` ≤ 50 (StockX page cap). `currency` optional.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"url_key":{"type":"string"},"id":{"type":"string"},"uuid":{"type":"string"},"cursor":{"type":"string"},"limit":{"type":"string"},"size":{"type":"string"},"currency":{"type":"string"}}},"example":{"url_key":"air-jordan-4-retro-bred-reimagined","limit":50}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stockx/v1/browse":{"post":{"operationId":"stockx_browse","summary":"category/vertical grids + sort + facet filters → results[]{id,url_key,url,title,brand,sku,category,image,lowest_ask,highest_bid,last_sale} + page_info{page,limit,total}. Needs at least one of `category` (sneakers/apparel/electronics/collectibles/accessories), `query`, or a facet filter (`brand`/`gender`). `sort` (most-active/featured/release_date/lowest_ask) optional. Return up to 1000 products in one call with `max_results` (40/page, paged for you — StockX's own ceiling, its grid stops at page 26); `page` picks where the window starts. The catalog-discovery surface.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"query":{"type":"string"},"brand":{"type":"string"},"gender":{"type":"string"},"sort":{"type":"string"},"max_results":{"type":"string"},"page":{"type":"string"},"currency":{"type":"string"},"market":{"type":"string"}}},"example":{"category":"sneakers","sort":"most-active"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/stockx/v1/trending":{"post":{"operationId":"stockx_trending","summary":"movers / most-active products (global or within a `category`) → results[] (same card shape as browse) + page_info. Defaults `sort`=most-active. Optional `category`, `brand`, `gender`. Return up to 1000 products in one call with `max_results` (40/page, paged for you — StockX's grid stops at page 26); `page` picks where the window starts. Surfaces what's trading right now.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"brand":{"type":"string"},"gender":{"type":"string"},"sort":{"type":"string"},"max_results":{"type":"string"},"page":{"type":"string"},"currency":{"type":"string"},"market":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/streaming/v1/search":{"post":{"operationId":"streaming_search","summary":"search movies/shows with current offers","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"country":{"type":"string"},"language":{"type":"string"},"page_size":{"type":"string"},"cursor":{"type":"string"}},"required":["query"]},"example":{"query":"Inception","country":"US"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/streaming/v1/browse":{"post":{"operationId":"streaming_browse","summary":"browse a provider/country catalog by genre/type/year, ranked (sort_by), with pagination","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"language":{"type":"string"},"object_types":{"type":"string"},"packages":{"type":"string"},"genres":{"type":"string"},"sort_by":{"type":"string"},"release_year":{"type":"string"},"year_min":{"type":"string"},"year_max":{"type":"string"},"page_size":{"type":"string"},"cursor":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/streaming/v1/trending":{"post":{"operationId":"streaming_trending","summary":"trending titles right now (with where-to-watch offers), filterable by provider/type/genre","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"language":{"type":"string"},"sort_by":{"type":"string"},"object_types":{"type":"string"},"packages":{"type":"string"},"genres":{"type":"string"},"page_size":{"type":"string"},"cursor":{"type":"string"}}},"example":{"country":"US","page_size":3}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/streaming/v1/title":{"post":{"operationId":"streaming_title","summary":"title metadata and offers by JustWatch node id","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"query":{"type":"string"},"url":{"type":"string"},"country":{"type":"string"},"language":{"type":"string"}}},"example":{"id":"ts4","country":"US"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/streaming/v1/availability":{"post":{"operationId":"streaming_availability","summary":"where-to-watch offers for one title across multiple countries (the core comparison call)","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"query":{"type":"string"},"url":{"type":"string"},"countries":{"type":"string"},"country":{"type":"string"},"language":{"type":"string"},"monetization_types":{"type":"string"},"presentation_types":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/streaming/v1/new":{"post":{"operationId":"streaming_new","summary":"what's new / coming soon / leaving soon on a provider — by country/provider/type","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"language":{"type":"string"},"packages":{"type":"string"},"object_types":{"type":"string"},"date":{"type":"string"},"price_drops":{"type":"string"},"page_type":{"type":"string"},"monetization_types":{"type":"string"},"presentation_types":{"type":"string"},"page_size":{"type":"string"},"cursor":{"type":"string"}}},"example":{"country":"US","packages":["nfx"],"page_type":"leaving","page_size":3}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/streaming/v1/countries":{"post":{"operationId":"streaming_countries","summary":"supported country codes","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/streaming/v1/genres":{"post":{"operationId":"streaming_genres","summary":"JustWatch genre reference for a country/language","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"language":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/streaming/v1/providers":{"post":{"operationId":"streaming_providers","summary":"streaming providers available in a country","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"}}},"example":{"country":"US"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/streaming/v1/country":{"post":{"operationId":"streaming_country","summary":"one country plus live supported provider/service details","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"}},"required":["country"]},"example":{"country":"US"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/streaming/v1/seasons":{"post":{"operationId":"streaming_seasons","summary":"show seasons with offers","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"country":{"type":"string"},"language":{"type":"string"}},"required":["id"]},"example":{"id":"ts4"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/streaming/v1/episodes":{"post":{"operationId":"streaming_episodes","summary":"season episodes with offers; show id + season_number resolves first","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"season_id":{"type":"string"},"season_number":{"type":"string"},"country":{"type":"string"},"language":{"type":"string"},"page_size":{"type":"string"},"cursor":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/swappa/v1/search":{"post":{"operationId":"swappa_search","summary":"Search Swappa for live listings. Give a free-text `query` ('iphone 15 pro', 'macbook pro 14', 'playstation 5') or an exact `model` slug, and get back that model's listings for sale right now — each with Swappa's own listing code, price, condition grade, battery health, storage / memory / colour / carrier / model number, photo count, seller name, seller star-rating and ship-from city. Narrow with condition, carrier, colour, storage, memory, processor, model_number, edition, and the warranty / card-payment / individual-seller / Phonecheck / international-shipping switches; sort by price or newest. Paginated 50 per page. Every filter value a model actually supports is returned in `filters_available`, so you never have to guess.","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"model":{"type":"string"},"max_results":{"type":"string"},"page":{"type":"string"},"sort":{"type":"string"},"condition":{"type":"string"},"carrier":{"type":"string"},"color":{"type":"string"},"storage":{"type":"string"},"memory":{"type":"string"},"processor":{"type":"string"},"model_number":{"type":"string"},"edition":{"type":"string"},"with_warranty":{"type":"string"},"accepts_stripe":{"type":"string"},"exclude_businesses":{"type":"string"},"phone_check_certified":{"type":"string"},"international":{"type":"string"}}},"example":{"model":"apple-iphone-15","max_results":25}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/swappa/v1/price":{"post":{"operationId":"swappa_price","summary":"Re-check ONE listing's price, availability and condition, cheaply. Give it the Swappa listing code you already hold and it returns what the seller is asking right now, whether the listing is still buyable, and the condition grade — and nothing else: no photos, description, specs, seller block or reviews. Built for refreshing a catalogue you already have rather than discovering listings. It reads the small slide-over card Swappa's own grid fetches on hover instead of the whole listing page, so it costs a fraction of `product_detail` — measured live on nine listings across nine product lines: 6.8-11.5 KB against 122.3-171.0 KB for a full `product_detail` (10.7x-19.7x), or 73.5-82.6 KB with its reviews switched off (6.4x-10.9x). Remember what a Swappa listing IS: one specific used device from one seller, not a catalogue entry — when it sells, Swappa takes it down, and this action then returns NOT_FOUND. That is the answer, not a failure: it means the unit you were tracking is gone.","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"listing_id":{"type":"string"},"url":{"type":"string"}}},"example":{"listing_id":"LAGY58046"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/swappa/v1/product_detail":{"post":{"operationId":"swappa_product_detail","summary":"Get one Swappa listing in full, by its listing code or its swappa.com URL — the asking price and currency, quantity available, condition grade with Swappa's own condition criteria, the seller's damage description, battery health, storage / memory / colour / carrier / model number / processor, GTIN and GTIN-13, the COMPLETE photo gallery at full resolution, carrier compatibility, shipping (free-shipping flag, rate, ship-from city, handling time, international), payment methods, returns policy, listing created / updated / expiry dates, and the seller (display name, individual-vs-business, profile, star rating, number of ratings, location). Also returns the product the listing belongs to: brand, catalog slug, star rating and review count, top buyer reviews, and — for models with a Swappa product guide — the device spec tables including width, height, depth and weight in grams and ounces, for shipping-cost calculation.","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"listing_id":{"type":"string"},"url":{"type":"string"},"include_reviews":{"type":"string"},"max_reviews":{"type":"string"}}},"example":{"listing_id":"LAGY58046"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/target/v1/search":{"post":{"operationId":"target_search","summary":"Find products on target.com (US). Give a free-text `query` ('coffee maker', 'lego star wars', 'nike running shoes') to run Target's own site search, or a `category` path ('/c/cpus/-/N-01vhh', '/b/apple/-/N-5y3ej') to browse a Target category or brand page. Every product comes back with BOTH of Target's ids — the parent product id and the specific colour/size id — plus the name, brand, category, image, current price, the crossed-out list price when it is on sale, the star rating and rating count, and the product URL. Narrow with `sort`, `min_price` and `max_price`; page with `page` and `max_results`.","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"category":{"type":"string"},"page":{"type":"string"},"max_results":{"type":"string"},"sort":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"}}},"example":{"query":"coffee maker","max_results":24}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/target/v1/product_detail":{"post":{"operationId":"target_product_detail","summary":"Get one Target product in full, by Target's own id or by its target.com URL. One call returns the UPC barcode, the shipping weight and package dimensions with Target's own units, the complete image gallery, the entire colour/size variant matrix with each variant's own price, list price, stock status, barcode, weight, dimensions, image and native Target id, the specification table parsed into name/value pairs, the brand, the category breadcrumb path, the current price and availability, the star rating with its full 1-5 distribution and Target's secondary ratings, the customer review photos, and the customer reviews inline.","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"tcin":{"type":"string"},"url":{"type":"string"},"reviews":{"type":"string"},"include_price":{"type":"string"}}},"example":{"tcin":"87328557","reviews":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/threads/v1/profile":{"post":{"operationId":"threads_profile","summary":"Public Threads profile by username — name, bio, bio links, follower count, verification, profile picture and user id.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"}},"required":["username"]},"example":{"username":"zuck"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/threads/v1/posts":{"post":{"operationId":"threads_posts","summary":"Public posts from a Threads profile (most-recent first). Returns full text, media, engagement counts, location and music per post. Set `limit` for how many to return.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"limit":{"type":"string"}},"required":["username"]},"example":{"username":"natgeo","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/threads/v1/replies":{"post":{"operationId":"threads_replies","summary":"Public replies from a Threads profile (the Replies tab). Set `limit` for how many to return.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"limit":{"type":"string"}},"required":["username"]},"example":{"username":"zuck","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/threads/v1/reposts":{"post":{"operationId":"threads_reposts","summary":"Posts a Threads user has reposted — the Reposts tab on their profile. Returns the original reposted posts (authored by other accounts).","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"limit":{"type":"string"}},"required":["username"]},"example":{"username":"natgeo","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/threads/v1/post":{"post":{"operationId":"threads_post","summary":"Maximally-complete public post detail. Provide url, or username + code, or post_id. Returns text, media (image/video/carousel), all engagement counts, location, music, tagged users, link preview, language and paid-partnership flag.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"username":{"type":"string"},"code":{"type":"string"},"post_id":{"type":"string"}}},"example":{"username":"natgeo","code":"DZ2pt10Eanh"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/threads/v1/post_replies":{"post":{"operationId":"threads_post_replies","summary":"The reply conversation for a public post (thread_items). Provide post_id, or url, or username + code.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"post_id":{"type":"string"},"url":{"type":"string"},"username":{"type":"string"},"code":{"type":"string"},"limit":{"type":"string"}}},"example":{"username":"natgeo","code":"DZ2pt10Eanh","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/threads/v1/search":{"post":{"operationId":"threads_search","summary":"Search public Threads posts by keyword. Returns matching public posts with author, text and permalink.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"query":{"type":"string"},"limit":{"type":"string"}},"required":["q"]},"example":{"q":"reef","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/threads/v1/user_search":{"post":{"operationId":"threads_user_search","summary":"Look up the public Threads account whose handle matches a query (exact / near-exact). NOTE: full fuzzy people search is login-gated by Threads; logged-out resolves the matching handle, like instagram's users_search.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"query":{"type":"string"}},"required":["q"]},"example":{"q":"natgeo"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/threads/v1/followers":{"post":{"operationId":"threads_followers","summary":"Account-gated: the followers list requires a logged-in Threads session and is not available for public (logged-out) use.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/threads/v1/following":{"post":{"operationId":"threads_following","summary":"Account-gated: the following list requires a logged-in Threads session and is not available for public (logged-out) use.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/threads/v1/likes":{"post":{"operationId":"threads_likes","summary":"Account-gated: the list of accounts that liked a post (who-liked) is not exposed to logged-out clients by Threads — it requires a logged-in session.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"username":{"type":"string"},"code":{"type":"string"},"post_id":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/threat-intel/v1/url_check":{"post":{"operationId":"threat_intel_url_check","summary":"Is a URL malicious? Checks the URLHaus malware-URL feed + OpenPhish phishing feed (exact + variants) + its host across ThreatFox/URLHaus-hosts/Feodo/SSLBL + risk flags → verdict.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]},"example":{"url":"https://github.com/"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/threat-intel/v1/domain_reputation":{"post":{"operationId":"threat_intel_domain_reputation","summary":"Domain reputation: URLHaus host listing + active malware URLs + OpenPhish phishing + ThreatFox domain IOCs + urlscan scan-history count + risk flags → consolidated verdict.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]},"example":{"domain":"github.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/threat-intel/v1/ip_reputation":{"post":{"operationId":"threat_intel_ip_reputation","summary":"IP abuse signals: Feodo botnet-C2 + SSLBL botnet-C2 + ThreatFox IP IOCs + URLHaus IP-hosted malware + Spamhaus DROP hijacked-netblock → verdict + score (all keyless).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ip":{"type":"string"}},"required":["ip"]},"example":{"ip":"8.8.8.8"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/threat-intel/v1/scan_lookup":{"post":{"operationId":"threat_intel_scan_lookup","summary":"urlscan.io public scan history + per-scan verdict for a domain/IP (server, IP, country, TLS age, page title, malicious-flag). Open source — no key.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"search_field":{"type":"string"},"limit":{"type":"string"}},"required":["domain"]},"example":{"domain":"github.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/threat-intel/v1/batch":{"post":{"operationId":"threat_intel_batch","summary":"Check up to 20 mixed indicators (URL/domain/IP, auto-routed) in one call.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"targets":{"type":"string"}},"required":["targets"]},"example":{"targets":["https://github.com/","github.com","8.8.8.8"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tiktok-creative-center/v1/top_ads":{"post":{"operationId":"tiktok_creative_center_top_ads","summary":"Top-performing TikTok ads for a market, filterable by region, period, industry, objective and ad language, ranked by recommendation / CTR / likes / spend. The core ad-spy feed — the same Top Ads intelligence PiPiADS / Minea / AdSpy sell as SaaS — with each ad's metrics and full video renditions.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"string"},"period":{"type":"string"},"order_by":{"type":"string"},"industry":{"type":"string"},"objective":{"type":"string"},"ad_language":{"type":"string"},"limit":{"type":"string"},"page":{"type":"string"}}},"example":{"region":"US","period":"30"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tiktok-creative-center/v1/ad_detail":{"post":{"operationId":"tiktok_creative_center_ad_detail","summary":"Full creative record for one ad: title, brand, CTR, spend, likes, comments, shares, landing page, matched keywords, campaign objectives, highlight text, creative source, voice-over flag and the full set of video renditions (360p-1080p).","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ad_id":{"type":"string"}},"required":["ad_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tiktok-creative-center/v1/search_ads":{"post":{"operationId":"tiktok_creative_center_search_ads","summary":"Keyword search across TikTok's Top-Ads index (region/period scoped), returning the same ad shape as top_ads. NOTE: TikTok's keyword index is sparse — only terms that match indexed ad metadata return matches, and many generic queries come back empty (honest empty, ok=true). For broad discovery prefer `top_ads` with industry / objective filters.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string"},"region":{"type":"string"},"period":{"type":"string"},"limit":{"type":"string"},"page":{"type":"string"}},"required":["keyword"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tiktok-creative-center/v1/ad_filters":{"post":{"operationId":"tiktok_creative_center_ad_filters","summary":"The live filter taxonomy used by top_ads: full country (81), industry (258), objective (7), ad_language (16), pattern_label and period value lists.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tiktok-creative-center/v1/query_suggestions":{"post":{"operationId":"tiktok_creative_center_query_suggestions","summary":"Suggested Top-Ads search terms surfaced by TikTok's Creative Center search box. Honestly returns an empty list when TikTok is serving no suggestions for the locale.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tiktok-creative-center/v1/trend_reports":{"post":{"operationId":"tiktok_creative_center_trend_reports","summary":"Creative-Center trend reports & creative-guidance articles (official TikTok marketing insight content).","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"article_type":{"type":"string"},"limit":{"type":"string"},"page":{"type":"string"}}},"example":{"article_type":"trends"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tiktok-creative-center/v1/locations":{"post":{"operationId":"tiktok_creative_center_locations","summary":"Supported markets for the `region` filter: ISO code + human country name (e.g. {code: 'DE', name: 'Germany'}), sorted by name.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tiktok-shop/v1/product_detail":{"post":{"operationId":"tiktok_shop_product_detail","summary":"Full TikTok Shop product record in ONE call, for any of the ten markets — title, structured description, every image, EVERY SKU with its own price and its exact remaining stock as an integer, shipping weight in grams and package size in centimetres, discount and list price, shipping fee and delivery window, category path, the seller's full profile, three customer reviews and the complete star histogram. Nothing here needs a second request","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"},"market":{"type":"string"}},"required":["product_id"]},"example":{"product_id":"1729450858130215273","market":"us"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tiktok-shop/v1/products_by_ids":{"post":{"operationId":"tiktok_shop_products_by_ids","summary":"Look up as many as 15 US products in a SINGLE call — the cheapest way to refresh a list of ids you already hold, at roughly a sixth of the bandwidth per product of fetching each product page. It is also the only route on TikTok Shop with an unambiguous 'not found', which makes it the right way to check whether an id is still live before spending a full product fetch on it. US catalogue only","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_ids":{"type":"string"}},"required":["product_ids"]},"example":{"product_ids":["1729450858130215273","1729397197029216665"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tiktok-shop/v1/category_tree":{"post":{"operationId":"tiktok_shop_category_tree","summary":"TikTok Shop's own category taxonomy for any of the ten markets — 28 top-level departments from one call, then walk down to level 2 and level 3 by passing a category_id. Every node says whether it is a leaf, so the tree can be crawled to the bottom with no external id list and nothing hard-coded","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"market":{"type":"string"},"category_id":{"type":"string"},"slug":{"type":"string"}}},"example":{"market":"us"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tiktok-shop/v1/category_products":{"post":{"operationId":"tiktok_shop_category_products","summary":"Browse a whole category and page through it — around 100 products per category, on ALL TEN markets. This is the cheapest source of product ids there is, roughly 1 KB of traffic per product, and it is what replaces keyword search outside the US. Pages are position-independent, so a page that gets throttled is retried automatically without losing your place","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category_id":{"type":"string"},"market":{"type":"string"},"max_results":{"type":"string"},"slug":{"type":"string"}},"required":["category_id"]},"example":{"category_id":"601262","market":"us","max_results":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tiktok-shop/v1/search":{"post":{"operationId":"tiktok_shop_search","summary":"Keyword search across the US TikTok Shop catalogue, paged for you up to 150 products, with price, rating, sold count and seller on every row. US ONLY — TikTok does not serve keyword search on any other market, at any URL (use category_products there, which goes deeper than search does)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"max_results":{"type":"string"}},"required":["query"]},"example":{"query":"yoga mat","max_results":30}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tiktok-shop/v1/recommended_shops":{"post":{"operationId":"tiktok_shop_recommended_shops","summary":"Shops TikTok itself surfaces for a search term — a keyword-to-seller lookup that answers 'who sells this' rather than 'what is for sale'. Comes free alongside the US search page, so it costs one call and no extra bandwidth. US only","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"example":{"query":"yoga mat"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tiktok-shop/v1/seller_profile":{"post":{"operationId":"tiktok_shop_seller_profile","summary":"A TikTok Shop seller's full public profile on any of the ten markets — shop name, rating, review count, follower count, lifetime units sold, catalogue size, video count and TikTok's own service sub-scores. On the nine non-US markets there is no seller endpoint at all, so this is reached through one of the seller's products; pass a product_id and you get the seller for free","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"seller_id":{"type":"string"},"product_id":{"type":"string"},"market":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tiktok-shop/v1/seller_catalog":{"post":{"operationId":"tiktok_shop_seller_catalog","summary":"Every product a seller has listed, paged to the end — verified complete against the shop's own advertised product count (12 of 12, 81 of 81, 28 of 28 on three separate markets). Nine markets: US, Malaysia, Singapore, Thailand, Philippines, Vietnam, Indonesia, Japan and Mexico. NOT the UK, where TikTok does not deploy the seller catalogue service at all","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"seller_id":{"type":"string"},"market":{"type":"string"},"max_results":{"type":"string"}},"required":["seller_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tiktok-shop/v1/related_products":{"post":{"operationId":"tiktok_shop_related_products","summary":"The products TikTok itself recommends alongside a given product — its 'you may also like' rail, about 25 full product rows. Useful for competitor sets, substitutes and building a similar-items shelf. Works on all ten markets","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"},"market":{"type":"string"},"max_results":{"type":"string"}},"required":["product_id"]},"example":{"product_id":"1729450858130215273"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tiktok-shop/v1/ranking_list":{"post":{"operationId":"tiktok_shop_ranking_list","summary":"TikTok Shop's own best-seller board for the US — the 20 products TikTok is promoting as trending right now, in their published rank order, with full price, rating and seller rows. This is the editorial ranking the storefront shows, not a re-sorted search, which is what makes it the winning-products feed","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tiktok-shop/v1/premium_offers":{"post":{"operationId":"tiktok_shop_premium_offers","summary":"TikTok Shop's US 'premium offers' deal board, paged to the end — around 97 discounted products with the discount percentage and the pre-discount price on every row. A ready-made deals feed rather than a price filter over search","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"max_results":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tiktok-shop/v1/recommended_for_you":{"post":{"operationId":"tiktok_shop_recommended_for_you","summary":"TikTok Shop's US personalised discovery feed, paged and de-duplicated — 200-plus distinct products of what TikTok is currently pushing to shoppers. The widest trend-discovery surface this API has","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"max_results":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tiktok-shop/v1/reviews":{"post":{"operationId":"tiktok_shop_reviews","summary":"Customer reviews for a product on any of the ten markets — three full review texts with rating, author, verified-purchase flag and photo, plus the COMPLETE 1-to-5 star histogram and total review count covering every review the product has. Served from a 7 KB endpoint instead of the product page, so a ratings refresh costs a fraction of a re-fetch","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"},"market":{"type":"string"}},"required":["product_id"]},"example":{"product_id":"1729450858130215273"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tokopedia/v1/search":{"post":{"operationId":"tokopedia_search","summary":"Search Tokopedia products by keyword with optional price / condition / rating filters and sort. Returns up to 20 products per page (product_id, name, url, price in IDR, rating, sold count, category, shop) with page-based pagination.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"page":{"type":"string"},"sort":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"condition":{"type":"string"},"rating":{"type":"string"}},"required":["q"]},"example":{"q":"laptop"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tokopedia/v1/detail":{"post":{"operationId":"tokopedia_detail","summary":"Full product detail by product url: price, slashed/original price, discount, active campaign, stock, min/max order, weight, rating, review/view/talk counts, sold count, full description, spec rows, category breadcrumb, image gallery, variants and the seller shop.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]},"example":{"url":"https://www.tokopedia.com/ringke/casing-ringke-compatible-for-iphone-15-pro-silicone-magnet-magsafe-softcase-tipis-1729869063392494724"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tokopedia/v1/shop":{"post":{"operationId":"tokopedia_shop","summary":"Store/shop profile by shop domain (the tokopedia.com/ handle): name, description, open-since, follower count, active product count, total products sold, successful transactions, location, avatar and cover.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"shop":{"type":"string"}},"required":["shop"]},"example":{"shop":"unitechofficial"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tokopedia/v1/shop_products":{"post":{"operationId":"tokopedia_shop_products","summary":"Paginated product catalog of one shop by shop domain. Returns up to 20 products per page (same shape as search) plus the shop's total product count. Page through every product a store sells.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"shop":{"type":"string"},"page":{"type":"string"},"sort":{"type":"string"}},"required":["shop"]},"example":{"shop":"unitechofficial"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tokopedia/v1/reviews":{"post":{"operationId":"tokopedia_reviews","summary":"Paginated public product reviews by product_id (or url): star rating, review text, variant bought, relative date, reviewer handle, photos/videos, likes and the seller's reply. 20 reviews per page — page with `page`; meta.total / meta.has_more tell you how many.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"},"url":{"type":"string"},"page":{"type":"string"},"sort_reviews":{"type":"string"},"filter_rating":{"type":"string"}}},"example":{"product_id":"8485032043"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/translate/v1/translate":{"post":{"operationId":"translate_translate","summary":"Translate text into a single target language. Auto-detects the source by default and returns the detected language + confidence. Supports every script.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"target":{"type":"string"},"source":{"type":"string"}},"required":["text","target"]},"example":{"text":"Hello, how are you?","target":"es"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/translate/v1/translate_multi":{"post":{"operationId":"translate_translate_multi","summary":"Translate the SAME text into MANY target languages in a single call — the multi-target differentiator. Pass up to 60 target codes; returns a translation for each, fanned out concurrently (≈15× faster than calling translate per language).","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"targets":{"type":"string"},"source":{"type":"string"}},"required":["text","targets"]},"example":{"text":"The weather is beautiful today.","targets":["es","fr","de","ja","ar"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/translate/v1/translate_batch":{"post":{"operationId":"translate_translate_batch","summary":"Translate MANY strings into ONE target language in a single call — built for catalogue work (product titles, spec values, category names). Send up to 500 strings as an array and get an array back in the SAME order, index for index. Costs ONE upstream call regardless of how many strings you send, so a 500-title page is one request instead of 500. Items the upstream could not translate are listed in `failed[]` with a reason and come back as text:null — never as an empty string and never silently dropped.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"texts":{"type":"string"},"target":{"type":"string"},"source":{"type":"string"}},"required":["texts","target"]},"example":{"texts":["Wireless Bluetooth Headphones","Stainless Steel Water Bottle 1L","Men's Running Shoes, Size 42","Organic Green Tea, 100 bags","4K Ultra HD Smart TV 55 inch"],"target":"es"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/translate/v1/detect":{"post":{"operationId":"translate_detect","summary":"Detect the language of a piece of text. Returns the detected language code, its name and a confidence score (0-1). Works on any script.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"}},"required":["text"]},"example":{"text":"Привет мир"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/translate/v1/dictionary":{"post":{"operationId":"translate_dictionary","summary":"Word-level dictionary lookup: translate a word/short phrase and get its meanings grouped by part of speech, synonyms, back-translations and transliteration (romanization). Best for single words or short phrases.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"target":{"type":"string"},"source":{"type":"string"}},"required":["text","target"]},"example":{"text":"run","target":"es"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/translate/v1/languages":{"post":{"operationId":"translate_languages","summary":"List all supported languages (code → English name). Useful to populate a language picker or validate a code before translating.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/translate/v1/speak":{"post":{"operationId":"translate_speak","summary":"Text-to-speech: turn text into spoken audio (MP3). Pronounces the text in the chosen language's voice/accent — works with every script (Chinese, Japanese, Arabic, Cyrillic, Turkish…). Long text is split and joined into a single MP3. Returns the audio base64-encoded inline (audio/mpeg), so no second download is needed. Pair it with 'translate' to get spoken translations.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"lang":{"type":"string"},"slow":{"type":"string"}},"required":["text","lang"]},"example":{"text":"Hello, how are you today?","lang":"en"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trendyol/v1/product/detail":{"post":{"operationId":"trendyol_product_detail","summary":"full product by `url` OR `content_id`: title/brand/price(current+list+discount%/coupon/ty+)/campaign(+campaigns[])/rating+comment_count/in_stock/seller(+score)/other_offers/category/images/attributes(specs)/variants. The dual-use influencer module.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"content_id":{"type":"string"}}},"example":{"content_id":762254881}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trendyol/v1/product/reviews":{"post":{"operationId":"trendyol_product_reviews","summary":"paginated reviews by `content_id` OR `url`: {ai_summary (AI review digest), summary(avg/total_rating_count/total_comment_count/total_pages), reviews[]{user,rating,comment,date,seller,trusted,is_influencer,images}}. page/page_size params.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"content_id":{"type":"string"},"url":{"type":"string"},"page":{"type":"string"},"page_size":{"type":"string"}}},"example":{"content_id":762254881}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trendyol/v1/product/similar":{"post":{"operationId":"trendyol_product_similar","summary":"similar/cross-sell products by `content_id` OR `url` → results[]{content_id,title,brand,url,price,list_price,rating,comment_count,image,category}. page/size params.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"content_id":{"type":"string"},"url":{"type":"string"},"page":{"type":"string"},"size":{"type":"string"}}},"example":{"content_id":762254881}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trendyol/v1/search":{"post":{"operationId":"trendyol_search","summary":"Search Trendyol products by keyword with optional sort & price/brand filters → results[]{content_id,title,brand,url,price,list_price,rating,comment_count,category,image,free_cargo}. Resolves content_ids for product/detail. Paginated+deduped (page 1-based, max_pages ≤10). meta.total_count = full result-set size.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"page":{"type":"string"},"max_pages":{"type":"string"},"sort":{"type":"string"},"price":{"type":"string"},"brand":{"type":"string"}},"required":["query"]},"example":{"query":"iphone"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trendyol/v1/search/filters":{"post":{"operationId":"trendyol_search_filters","summary":"Discover the available filter facets for a `query` OR `category_id` before filtering — brands (with ids for the `brand` param), price ranges, product ratings, and category-specific attributes (RAM, screen size, color, …) each with live result counts.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"category_id":{"type":"string"}}},"example":{"query":"laptop"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trendyol/v1/category/products":{"post":{"operationId":"trendyol_category_products","summary":"Browse a Trendyol category by id — best-sellers, newest, or price/brand-filtered product lists. Same card shape as search. Get a category_id from a product's category.id (product/detail) or the '-c' in a category URL.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"category_id":{"type":"string"},"url":{"type":"string"},"page":{"type":"string"},"max_pages":{"type":"string"},"sort":{"type":"string"},"price":{"type":"string"},"brand":{"type":"string"}}},"example":{"category_id":103498}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trendyol/v1/seller/products":{"post":{"operationId":"trendyol_seller_products","summary":"All products of a Trendyol seller/store (paginated, sortable, filterable) by seller_id. Same card shape as search. meta.total_count = the seller's full catalog size.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"seller_id":{"type":"string"},"url":{"type":"string"},"page":{"type":"string"},"max_pages":{"type":"string"},"sort":{"type":"string"},"price":{"type":"string"},"brand":{"type":"string"}}},"example":{"seller_id":968}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trendyol/v1/seller/info":{"post":{"operationId":"trendyol_seller_info","summary":"Trendyol seller/store profile by seller_id: store name, legal entity (official_name), total product_count, seller score, and trust badges.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"seller_id":{"type":"string"},"url":{"type":"string"}}},"example":{"seller_id":968}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trendyol/v1/suggest":{"post":{"operationId":"trendyol_suggest","summary":"keyword suggestions for a query (ops; search-fallback if suggest API blocked)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"example":{"query":"iphone"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tripadvisor/v1/reviews":{"post":{"operationId":"tripadvisor_reviews","summary":"Reviews + the full place profile (rating histogram, subratings, amenities) for one or more Tripadvisor places, by page URL.","tags":["Reputation & Reviews"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"startUrls":{"type":"string"},"url":{"type":"string"},"queries":{"type":"string"},"query":{"type":"string"},"maxReviews":{"type":"string"},"language":{"type":"string"}}},"example":{"startUrls":[{"url":"https://www.tripadvisor.com/Hotel_Review-g45963-d91703-Reviews-Bellagio-Las_Vegas_Nevada.html"}],"maxReviews":45}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tripadvisor/v1/places/list":{"post":{"operationId":"tripadvisor_places_list","summary":"Discover hotels, restaurants or attractions in a city/area (name, rating, review count) — the feeder for `reviews`.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"},"category":{"type":"string"},"geo_id":{"type":"string"},"location_slug":{"type":"string"},"max_results":{"type":"string"}},"required":["location"]},"example":{"location":"Las Vegas","category":"hotels","geo_id":"45963","location_slug":"Las_Vegas_Nevada","max_results":30}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tripadvisor/v1/detail":{"post":{"operationId":"tripadvisor_detail","summary":"Full profile for one Tripadvisor hotel, restaurant or attraction by page URL: overall rating, total reviews, ranking, price level, the per-star rating breakdown, category subratings (cleanliness / service / value / location / food / atmosphere), amenities, cuisines, address, coordinates and phone.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]},"example":{"url":"https://www.tripadvisor.com/Hotel_Review-g45963-d91703-Reviews-Bellagio-Las_Vegas_Nevada.html"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/tripadvisor/v1/search":{"post":{"operationId":"tripadvisor_search","summary":"Find Tripadvisor places (hotels, restaurants, attractions) and destinations by name — the typeahead the site's own search box uses. Returns the matching location IDs + page URLs to feed into `reviews` or `detail`.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"example":{"query":"Bellagio Las Vegas","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/truelancer/v1/search":{"post":{"operationId":"truelancer_search","summary":"Search live freelance PROJECTS on Truelancer.com by keyword. Returns title, description, budget{type,min,max,currency}, skills[], category, proposal count, posted_at, coarse client signals (country, verified, total spent), and the project url. No client PII (the poster's name is dropped).","tags":["Jobs & Hiring"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"},"offset":{"type":"string"}}},"example":{"query":"design","limit":8}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/truelancer/v1/project":{"post":{"operationId":"truelancer_project","summary":"Full detail for one Truelancer.com project by URL or slug — everything from `search` plus views, end-date, tags, payment-verified flag, and proposal breakdown (received/active/shortlisted). No client PII.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/truelancer/v1/user":{"post":{"operationId":"truelancer_user","summary":"PUBLIC business profile of a Truelancer.com freelancer by handle or profile URL: display name, headline, country, hourly rate, skills, ratings (avg rating, reviews, five-star %, projects delivered, total earnings), membership and availability. PII (email/phone/legal-name/address) is NEVER returned.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"}},"required":["username"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trustpilot/v1/company/reviews":{"post":{"operationId":"trustpilot_company_reviews","summary":"Get a company's Trustpilot reviews and its full profile from trustpilot.com — TrustScore, star rating, total review count, 5-to-1-star rating distribution, business categories, and every review with rating, title, text, date, verified status, likes and the company's reply. Newest first; optionally filter by star rating.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"string"},"maxReviews":{"type":"string"},"includeCompany":{"type":"string"},"sort":{"type":"string"},"date_posted":{"type":"string"},"rating":{"type":"string"},"verified":{"type":"string"},"with_replies":{"type":"string"},"query":{"type":"string"},"languages":{"type":"string"},"page":{"type":"string"},"locale":{"type":"string"}},"required":["company"]},"example":{"company":"amazon.com","maxReviews":40}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trustpilot/v1/company/details":{"post":{"operationId":"trustpilot_company_details","summary":"The full Trustpilot company profile WITHOUT reviews (cheaper than company/reviews when you only need the listing) → TrustScore, star rating, total reviews (and last-12-months), 5-to-1-star distribution, category rankings (e.g. #2 of 26 in Bank), contact info (address, phone, website, email), how the business replies to reviews (reply rate + average days), business verification, claimed/closed status, what customers talk about most (AI topic summaries), the AI review summary and the company description. By company domain.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"string"},"locale":{"type":"string"}},"required":["company"]},"example":{"company":"lendingclub.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trustpilot/v1/category/browse":{"post":{"operationId":"trustpilot_category_browse","summary":"List the companies in a Trustpilot category (20/page) → each company's name, domain, TrustScore, review count and location. Filter by country, minimum TrustScore and claimed status, and sort by recently-reviewed. Also returns the category's size and subcategories, plus the newest companies and the recently-reviewed companies in that category — all in one call.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"categoryId":{"type":"string"},"page":{"type":"string"},"cursor":{"type":"string"},"locale":{"type":"string"},"sort":{"type":"string"},"country":{"type":"string"},"min_rating":{"type":"string"},"claimed":{"type":"string"}},"required":["categoryId"]},"example":{"categoryId":"electronics_technology"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trustpilot/v1/category/companies":{"post":{"operationId":"trustpilot_category_companies","summary":"List the companies in a Trustpilot category (20/page), ranked → each company's name, domain, TrustScore, review count, categories and location. Filter by country, minimum TrustScore and claimed status. Paginate with page.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"categoryId":{"type":"string"},"page":{"type":"string"},"locale":{"type":"string"},"sort":{"type":"string"},"country":{"type":"string"},"min_rating":{"type":"string"},"claimed":{"type":"string"}},"required":["categoryId"]},"example":{"categoryId":"electronics_technology"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trustpilot/v1/category/recently-reviewed":{"post":{"operationId":"trustpilot_category_recently_reviewed","summary":"The companies in a Trustpilot category that were reviewed most recently → name, domain, TrustScore, review count and location.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"categoryId":{"type":"string"},"locale":{"type":"string"}},"required":["categoryId"]},"example":{"categoryId":"electronics_technology"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trustpilot/v1/category/newest":{"post":{"operationId":"trustpilot_category_newest","summary":"The newest companies added to a Trustpilot category → name, domain, TrustScore, review count and location.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"categoryId":{"type":"string"},"locale":{"type":"string"}},"required":["categoryId"]},"example":{"categoryId":"electronics_technology"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trustpilot/v1/category/details":{"post":{"operationId":"trustpilot_category_details","summary":"Details of a Trustpilot category → its display name, the number of businesses in it, and its subcategories.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"categoryId":{"type":"string"},"locale":{"type":"string"}},"required":["categoryId"]},"example":{"categoryId":"electronics_technology"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trustpilot/v1/category/search":{"post":{"operationId":"trustpilot_category_search","summary":"Search Trustpilot categories by keyword → matching categories with their id and display name (feed a categoryId into category/companies).","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"locale":{"type":"string"}},"required":["query"]},"example":{"query":"nike"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trustpilot/v1/company/search":{"post":{"operationId":"trustpilot_company_search","summary":"Search Trustpilot for companies by name (10 matches/page) → each match's name, domain, TrustScore, star rating, review count, categories and location. Filter by minimum TrustScore and minimum review count. Also returns matching categories.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"page":{"type":"string"},"cursor":{"type":"string"},"min_rating":{"type":"string"},"min_review_count":{"type":"string"},"locale":{"type":"string"}},"required":["query"]},"example":{"query":"nike"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trustpilot/v1/consumer/details":{"post":{"operationId":"trustpilot_consumer_details","summary":"A Trustpilot consumer's public profile → display name, country, number of reviews written, and review statistics. By consumer id.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"consumer_id":{"type":"string"},"locale":{"type":"string"}},"required":["consumer_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trustpilot/v1/consumer/reviews":{"post":{"operationId":"trustpilot_consumer_reviews","summary":"Every review a Trustpilot consumer has written across all companies → each review's company, rating, title, text and date. Paginate with page.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"consumer_id":{"type":"string"},"page":{"type":"string"},"cursor":{"type":"string"},"locale":{"type":"string"}},"required":["consumer_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trustpilot/v1/reviewer/profile":{"post":{"operationId":"trustpilot_reviewer_profile","summary":"Alias of consumer/details + consumer/reviews: a reviewer's profile AND every review they have written. By consumer id.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"consumer_id":{"type":"string"},"page":{"type":"string"},"cursor":{"type":"string"},"locale":{"type":"string"}},"required":["consumer_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trustradius/v1/product/reviews":{"post":{"operationId":"trustradius_product_reviews","summary":"Fetch verified user reviews and ratings for a B2B software product from TrustRadius (up to 639 reviews with full verbatim text, reviewer job title, company industry and size) or GetApp. Filter by public-only or include all review visibility levels.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_slug":{"type":"string"},"source":{"type":"string"},"skip":{"type":"string"},"limit":{"type":"string"},"fetch_all":{"type":"string"},"include_non_public":{"type":"string"},"category_path":{"type":"string"}},"required":["product_slug"]},"example":{"source":"trustradius","product_slug":"slack","fetch_all":true}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trustradius/v1/product/detail":{"post":{"operationId":"trustradius_product_detail","summary":"product metadata (name, description, rating, category)","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_slug":{"type":"string"},"source":{"type":"string"},"category_path":{"type":"string"}},"required":["product_slug"]},"example":{"source":"trustradius","product_slug":"slack"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/trustradius/v1/product/resolve":{"post":{"operationId":"trustradius_product_resolve","summary":"resolve a TrustRadius/GetApp/Capterra/G2 URL → source + slug","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/turo/v1/search":{"post":{"operationId":"turo_search","summary":"Search Turo for rentable cars at a location and date range. Filter by make, model, vehicle type (CAR/SUV/MINIVAN/TRUCK/VAN), max price and sort order; paginated (~200 cars/page). Returns the full result page as clean JSON. (If the site serves a bot check the engine retries and, only if it still cannot pass, returns a clean TARGET_BLOCKED — never fabricated data.)","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"},"start_date":{"type":"string"},"end_date":{"type":"string"},"start_time":{"type":"string"},"end_time":{"type":"string"},"country":{"type":"string"},"make":{"type":"string"},"model":{"type":"string"},"vehicle_type":{"type":"string"},"max_price":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"}},"required":["location"]},"example":{"location":"Miami, FL, USA"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/turo/v1/vehicle.detail":{"post":{"operationId":"turo_vehicle.detail","summary":"Full detail for one Turo car: make/model/year/trim, transmission, seats, doors, luggage and fuel/battery specs, the categorized feature list, host card, ratings, and the price calendar. The protected listing card (host card + sub-ratings) rides a Cloudflare-guarded endpoint (best-effort, bounded retry); the specs, feature list and price calendar always come back from the open endpoints.","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"vehicle_id":{"type":"string"},"start_date":{"type":"string"},"end_date":{"type":"string"},"start_time":{"type":"string"},"end_time":{"type":"string"}},"required":["vehicle_id"]},"example":{"vehicle_id":"3613768"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/turo/v1/vehicle.features":{"post":{"operationId":"turo_vehicle.features","summary":"Specs + the full categorized feature list for one car (transmission, seats, doors, luggage capacity, fuel type, battery range, and features like Backup camera, All-wheel drive, Apple CarPlay, grouped by category).","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"vehicle_id":{"type":"string"}},"required":["vehicle_id"]},"example":{"vehicle_id":"3613768"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/turo/v1/vehicle.pricing":{"post":{"operationId":"turo_vehicle.pricing","summary":"Daily price calendar for one car across a date window: per-day price + day of week. Defaults to the next ~3 months if no window is given.","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"vehicle_id":{"type":"string"},"start_date":{"type":"string"},"end_date":{"type":"string"}},"required":["vehicle_id"]},"example":{"vehicle_id":"3613768"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/turo/v1/vehicle.similar":{"post":{"operationId":"turo_vehicle.similar","summary":"Cars similar to a given make/model near a location and dates — a make/model-seeded list of rentable Turo cars (price, rating, host, photo, location), and the most dependable way to get one. Pass make + model + location; vehicle_id is optional (used only to exclude that exact car).","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"make":{"type":"string"},"location":{"type":"string"},"model":{"type":"string"},"vehicle_id":{"type":"string"},"start_date":{"type":"string"},"end_date":{"type":"string"},"start_time":{"type":"string"},"end_time":{"type":"string"},"country":{"type":"string"},"max_results":{"type":"string"}},"required":["make","location"]},"example":{"make":"Tesla","model":"Model 3","location":"Miami, FL, USA"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/turo/v1/host.profile":{"post":{"operationId":"turo_host.profile","summary":"Full Turo host (driver) profile: first name, All-Star/Pro status, member-since, response rate & time, ratings from renters and from car owners, rental counts and account verifications (phone/email/ID). Last name only with include_pii=true.","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"host_id":{"type":"string"}},"required":["host_id"]},"example":{"host_id":"33962137"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/turo/v1/host.cars":{"post":{"operationId":"turo_host.cars","summary":"Every car a Turo host has listed, paginated — make/model/year, daily price, rating, review count, location and photo per car.","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"host_id":{"type":"string"},"page":{"type":"string"}},"required":["host_id"]},"example":{"host_id":"33962137"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/turo/v1/host.reviews":{"post":{"operationId":"turo_host.reviews","summary":"Reviews left for a Turo host by their guests, paginated — star rating, the review text, date and the host's reply. Reviewer first name is kept (public on Turo); last name only with include_pii=true.","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"host_id":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"}},"required":["host_id"]},"example":{"host_id":"33962137"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/turo/v1/location.autocomplete":{"post":{"operationId":"turo_location.autocomplete","summary":"Resolve a free-text place into Turo search locations (cities and airports) with id, type and coordinates — handy to confirm the place before searching.","tags":["Travel & Lodging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"}},"required":["location"]},"example":{"location":"Los Angeles"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/turo/v1/makes":{"post":{"operationId":"turo_makes","summary":"The full list of car makes Turo supports in a market (e.g. Tesla, BMW, Toyota, Ferrari) — useful as the allowed values for the search `make` filter.","tags":["Travel & Lodging"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"}}},"example":{"country":"US"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitch/v1/channel":{"post":{"operationId":"twitch_channel","summary":"Full channel/user profile by login: id, display name, description, created-at, profile and banner image, follower count, partner/affiliate/staff flags, and the current live stream (title, viewer count, game/category, started-at) if live.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"login":{"type":"string"}},"required":["login"]},"example":{"login":"shroud"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitch/v1/stream":{"post":{"operationId":"twitch_stream","summary":"Live status of a channel: whether it is live right now and, if so, the stream id, title, viewer count, game/category, started-at timestamp and a 1080p thumbnail. Returns is_live=false (honest-empty) for an offline channel.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"login":{"type":"string"}},"required":["login"]},"example":{"login":"shroud"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitch/v1/videos":{"post":{"operationId":"twitch_videos","summary":"A channel's past broadcasts / VODs (most recent first), up to 100 in one page: id, title, duration, view count, published-at, game/category and thumbnail. Note: Twitch integrity-gates pagination beyond the first page for keyless access.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"login":{"type":"string"},"limit":{"type":"string"},"type":{"type":"string"},"sort":{"type":"string"}},"required":["login"]},"example":{"login":"pokimane","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitch/v1/clips":{"post":{"operationId":"twitch_clips","summary":"Top clips of a channel, ranked by views, up to 100 in one page: id, slug, title, view count, created-at, duration, game/category, the clip creator and the clip URL. Filter the time window with `period`. Pagination beyond page one is integrity-gated.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"login":{"type":"string"},"limit":{"type":"string"},"period":{"type":"string"}},"required":["login"]},"example":{"login":"xqc","limit":5,"period":"ALL_TIME"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitch/v1/search_channels":{"post":{"operationId":"twitch_search_channels","summary":"Search Twitch channels by name/keyword. Returns matching channels with id, login, display name, description, follower count, partner/affiliate flags and live status (viewer count + game when live).","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"}},"required":["query"]},"example":{"query":"ninja","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitch/v1/search_categories":{"post":{"operationId":"twitch_search_categories","summary":"Search Twitch games/categories by name. Returns matching categories with id, name, display name, current live viewer count and box-art image.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"string"}},"required":["query"]},"example":{"query":"valorant","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitch/v1/top_games":{"post":{"operationId":"twitch_top_games","summary":"The top games/categories on Twitch right now, ranked by live viewers: id, name, display name, current viewer count, content tags and box-art image. Up to 30.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"string"}}},"example":{"limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitch/v1/top_streams":{"post":{"operationId":"twitch_top_streams","summary":"The top live streams on Twitch right now, ranked by viewers: stream id, title, viewer count, started-at, the broadcasting channel (login, display name) and the game/category. Up to 30.","tags":["Social Media"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"string"}}},"example":{"limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitch/v1/game":{"post":{"operationId":"twitch_game","summary":"Game/category detail by name plus its top live streams: category id, display name, total live viewers, description, avatar — and the top channels (up to 30) currently streaming it, each with title, viewer count and broadcaster.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"limit":{"type":"string"}},"required":["name"]},"example":{"name":"VALORANT","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitch/v1/schedule":{"post":{"operationId":"twitch_schedule","summary":"A channel's stream schedule: the next upcoming stream (start, title, category) plus the channel's recurring weekly schedule segments — each with start/end time, title, cancelled flag and the planned game/category. Returns honest-empty when the channel has not published a schedule.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"login":{"type":"string"}},"required":["login"]},"example":{"login":"lirik"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitch/v1/game_clips":{"post":{"operationId":"twitch_game_clips","summary":"Top clips for a whole game/category (site-wide, across all channels), ranked by views, up to 100 in one page: id, slug, title, view count, created-at, duration, the broadcaster the clip is from, the clip creator and the URL. Filter the time window with `period`. Pagination beyond page one is integrity-gated.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"limit":{"type":"string"},"period":{"type":"string"}},"required":["name"]},"example":{"name":"VALORANT","limit":5,"period":"ALL_TIME"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitch/v1/game_videos":{"post":{"operationId":"twitch_game_videos","summary":"Top past broadcasts / VODs for a whole game/category (site-wide, across all channels), up to 100 in one page: id, title, duration, view count, published-at, the owning channel and a thumbnail. Order by views (default) or newest. Pagination beyond page one is integrity-gated.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"limit":{"type":"string"},"sort":{"type":"string"}},"required":["name"]},"example":{"name":"Just Chatting","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitch/v1/team":{"post":{"operationId":"twitch_team","summary":"A Twitch team profile by name plus its member channels: team id, name, display name, description, logo/banner image — and the member channels (up to 100), each with login, display name, partner/affiliate status and current live status (viewer count + game when live).","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"limit":{"type":"string"}},"required":["name"]},"example":{"name":"tsm","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitter/v1/profile":{"post":{"operationId":"twitter_profile","summary":"User profile by @username — name, bio, followers, following, tweet/like counts, verified, created date, location, website, avatar/banner.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"}},"required":["username"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitter/v1/user_by_id":{"post":{"operationId":"twitter_user_by_id","summary":"User profile by numeric user_id (same fields as profile).","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string"}},"required":["user_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitter/v1/user_tweets":{"post":{"operationId":"twitter_user_tweets","summary":"A user's tweets — full text, engagement (likes/retweets/replies/quotes/views), media, quoted/retweeted, with cursor pagination.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"user_id":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["username"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitter/v1/user_replies":{"post":{"operationId":"twitter_user_replies","summary":"A user's tweets AND replies (timeline incl. replies). Each reply also carries reply_to_text (the parent tweet's text, ≤280 chars) + reply_to_author so a reply is interpretable without a second call — resolved from the conversation already in the response.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"user_id":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["username"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitter/v1/user_media":{"post":{"operationId":"twitter_user_media","summary":"A user's media tweets — photos & videos (with video_url + duration), engagement, pagination.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"user_id":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["username"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitter/v1/user_likes":{"post":{"operationId":"twitter_user_likes","summary":"Tweets a user has liked (if the account exposes likes).","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"user_id":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["username"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitter/v1/tweet":{"post":{"operationId":"twitter_tweet","summary":"A single tweet by id — full text, engagement, media, quoted/retweeted, author.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tweet_id":{"type":"string"}},"required":["tweet_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitter/v1/tweet_replies":{"post":{"operationId":"twitter_tweet_replies","summary":"A tweet PLUS its replies/comments (threaded conversation) with DEEP cursor pagination.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tweet_id":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["tweet_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitter/v1/search":{"post":{"operationId":"twitter_search","summary":"Search tweets or people. product=Top|Latest|People|Media. Supports X search operators in the query. Cursor pagination.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"product":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["query"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitter/v1/followers":{"post":{"operationId":"twitter_followers","summary":"A user's followers (each a full user object), paginated.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"user_id":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["username"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitter/v1/following":{"post":{"operationId":"twitter_following","summary":"Accounts a user follows (each a full user object), paginated.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"user_id":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["username"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitter/v1/list_tweets":{"post":{"operationId":"twitter_list_tweets","summary":"Latest tweets from a Twitter List by id, paginated.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"list_id":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["list_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitter/v1/trends":{"post":{"operationId":"twitter_trends","summary":"Current trending topics on X / Twitter (the Explore feed) — each with its name, location/category context, post-volume, and a search URL.","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/twitter/v1/community_search":{"post":{"operationId":"twitter_community_search","summary":"Search posts across X Communities by keyword — returns matching community tweets (same rich tweet shape as search).","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"product":{"type":"string"},"limit":{"type":"string"},"cursor":{"type":"string"}},"required":["query"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/udemy/v1/search":{"post":{"operationId":"udemy_search","summary":"Search Udemy courses by keyword (any topic, e.g. 'python', 'excel', 'machine learning'). Returns a paginated list of course cards — id, title, headline, instructors, rating, review count, level, duration, language — most-relevant first. Feed a result's course_id into detail / pricing / reviews / curriculum. Page with `page`; meta.has_more / meta.total_count tell you how many.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"page":{"type":"string"},"page_size":{"type":"string"}},"required":["query"]},"example":{"query":"python"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/udemy/v1/detail":{"post":{"operationId":"udemy_detail","summary":"Full course card for a Udemy course by URL, slug or id: title, headline, instructors, rating, review count, subscriber count, level, language, duration, price, category, description, what-you'll-learn, requirements and target audience.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"course_id":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string"}}},"example":{"course_id":"567828"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/udemy/v1/pricing":{"post":{"operationId":"udemy_pricing","summary":"Live price, list price and discount price for one or many Udemy courses by id (comma-separated). Fast, lightweight — use it to track current/sale pricing.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"course_ids":{"type":"string"}},"required":["course_ids"]},"example":{"course_ids":"567828"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/udemy/v1/reviews":{"post":{"operationId":"udemy_reviews","summary":"Paginated public student reviews for a course by id: star rating, review text, date and the instructor's reply. Page with `page` — meta.has_more / meta.review_count tell you how many.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"course_id":{"type":"string"},"page":{"type":"string"},"page_size":{"type":"string"}},"required":["course_id"]},"example":{"course_id":"567828"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/udemy/v1/curriculum":{"post":{"operationId":"udemy_curriculum","summary":"The course outline by id: chapters and lectures in order, with title, position, lecture asset type and whether the lecture is a free preview. Paginated.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"course_id":{"type":"string"},"page":{"type":"string"},"page_size":{"type":"string"}},"required":["course_id"]},"example":{"course_id":"567828"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/udemy/v1/by_instructor":{"post":{"operationId":"udemy_by_instructor","summary":"Browse every course published by a Udemy instructor, by their numeric instructor id. Returns a paginated list of course cards (id, title, rating, price, level, instructors) — use it to discover courses to feed into detail/pricing/reviews/curriculum. Get the instructor id from any course's instructors[] (detail action).","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"instructor_id":{"type":"string"},"page":{"type":"string"},"page_size":{"type":"string"}},"required":["instructor_id"]},"example":{"instructor_id":"9685726"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/udemy/v1/categories":{"post":{"operationId":"udemy_categories","summary":"The live Udemy category taxonomy (Development, Business, IT & Software, Design, …) with ids, titles and slugs. Pass a category_id to drill into its subcategories. Use this to map the Udemy catalogue structure.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"category_id":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/uk-tenders/v1/search":{"post":{"operationId":"uk_tenders_search","summary":"Search UK public-sector contract notices by phrase, status, value, deadline, CPV code and publication date. Every hit already carries the FULL notice text (no second call), plus the money: the published value range for live tenders, and the winning supplier, the awarded amount and the contract end date for awards.","tags":["Government & Tenders"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"phrase":{"type":"string"},"statuses":{"type":"string"},"notice_types":{"type":"string"},"published_from":{"type":"string"},"published_to":{"type":"string"},"published_within_days":{"type":"string"},"deadline_from":{"type":"string"},"min_value":{"type":"string"},"cpv_codes":{"type":"string"},"sort":{"type":"string"},"limit":{"type":"string"}},"required":["q"]},"example":{"q":"web scraping","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/uk-tenders/v1/notice":{"post":{"operationId":"uk_tenders_notice","summary":"One notice in full by id: the buyer's published contact details (name, e-mail, phone, address), the 'how to respond' instructions with the portal link, the procedure type, the number of times the notice has been viewed (a competition signal), and the complete award block — every winning supplier with their address, the amount and the contract start and end dates. None of this is in the search response.","tags":["Government & Tenders"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]},"example":{"id":"ec641d32-1f15-48f3-9458-bc4cd94b04c5"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/ulta/v1/search":{"post":{"operationId":"ulta_search","summary":"Find products on ulta.com (US). Browse a `category` — `/shop/makeup/face/foundation`, `/shop/hair/shampoo-conditioner/shampoo`, `/shop/skin-care/moisturizers` — for the precise, fully pageable result set with Ulta's own total, or give a free-text `query` ('mascara', 'vitamin c serum', 'dyson airwrap') to let Ulta's own type-ahead decide which category answers it. Every product comes back with Ulta's own product id and sku, the name, brand, image, list and sale price (a range when the shades differ), the star rating and review count, the shade/size count and Ulta's badges and promo text. Narrow with `brand`, `min_rating`, `sort` and any facet Ulta publishes for that category; the live facet vocabulary comes back WITH counts in every category response, so a filter value is never a guess.","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"category":{"type":"string"},"page":{"type":"string"},"max_results":{"type":"string"},"sort":{"type":"string"},"brand":{"type":"string"},"min_rating":{"type":"string"},"filters":{"type":"string"}}},"example":{"category":"/shop/makeup/face/foundation","max_results":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/ulta/v1/price":{"post":{"operationId":"ulta_price","summary":"Re-check ONE variant's price and stock, cheaply. Give it the product_id and the sku_id you already hold and it returns the current price, the regular price, whether that variant is in stock, and nothing else — no description, images, ingredients, variants or reviews. Built for refreshing a catalogue you already have rather than discovering products: it reads the same small module Ulta's own shade swatch fires, so it costs a fraction of a full product_detail. Note that sku_id is REQUIRED, because Ulta stocks and prices every shade and size separately — a product can be on sale and buyable in one size while another is sold out, so there is no single product-level answer.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"},"sku_id":{"type":"string"},"url":{"type":"string"}},"required":["product_id","sku_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/ulta/v1/product_detail":{"post":{"operationId":"ulta_product_detail","summary":"Get one Ulta Beauty product in full, by Ulta's product id or by its ulta.com URL — brand, name, the marketing copy in both plain text and its original Markdown, the full ingredient list, how-to-use, size, category path, list and sale price, availability, star rating and question count, the complete image AND video gallery with dimensions, Ulta's merchandising highlights and active promotions, one row per shade/size variant carrying that variant's OWN sku, price, sale price, stock flag, swatch and product images, and the customer reviews inline with the rating histogram, the recommended ratio, the most helpful positive and negative review, and the reviewer-reported attribute rollups. One call, everything the product page shows.","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"},"sku_id":{"type":"string"},"url":{"type":"string"},"reviews":{"type":"string"},"variant_prices":{"type":"string"}}},"example":{"product_id":"pimprod2057355","reviews":5,"variant_prices":"none"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/url-resolver/v1/resolve":{"post":{"operationId":"url_resolver_resolve","summary":"Follow the redirect chain to the final URL (hop-by-hop, every status observable).","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"max_hops":{"type":"string"}},"required":["url"]},"example":{"url":"http://github.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/url-resolver/v1/normalize":{"post":{"operationId":"url_resolver_normalize","summary":"Resolve then strip tracking params (utm_*/fbclid/gclid…) → canonical URL.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"follow":{"type":"string"}},"required":["url"]},"example":{"url":"https://www.example.com/?utm_source=a&fbclid=b&id=42","follow":false}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/url-resolver/v1/detect_affiliate":{"post":{"operationId":"url_resolver_detect_affiliate","summary":"Detect the affiliate network/params/merchant across the whole redirect chain, incl. first-party brand programs (influencer/seller deeplinks).","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"follow":{"type":"string"}},"required":["url"]},"example":{"url":"https://www.amazon.com/dp/B08N5WRWNW?tag=myaff-20","follow":false}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/url-resolver/v1/product_hint":{"post":{"operationId":"url_resolver_product_hint","summary":"Identify marketplace + product-id + the ReefAPI engine that can fetch the product.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"follow":{"type":"string"}},"required":["url"]},"example":{"url":"https://www.amazon.com/dp/B08N5WRWNW","follow":false}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/url-resolver/v1/preview":{"post":{"operationId":"url_resolver_preview","summary":"Link unfurl: OpenGraph + Twitter-card title/description/image/favicon (Slack/Discord style).","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]},"example":{"url":"https://www.example.com/"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/url-resolver/v1/safety":{"post":{"operationId":"url_resolver_safety","summary":"Heuristic URL-risk flags (ip-host, non-https, punycode, userinfo, high-abuse TLD, long/multi-shortener chain, cross-domain) + risk level/score.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]},"example":{"url":"https://www.amazon.com/dp/B08N5WRWNW"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/url-resolver/v1/full":{"post":{"operationId":"url_resolver_full","summary":"One call: resolve + normalize + detect_affiliate + product_hint + preview + safety.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"max_hops":{"type":"string"}},"required":["url"]},"example":{"url":"https://www.amazon.com/dp/B08N5WRWNW?tag=aff-20&utm_source=x"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/url-resolver/v1/batch":{"post":{"operationId":"url_resolver_batch","summary":"Resolve up to 50 URLs concurrently in one call — each URL is validated and resolved independently.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string"}},"required":["urls"]},"example":{"urls":["http://github.com","https://www.example.com/?utm_source=z"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/username-osint/v1/username":{"post":{"operationId":"username_osint_username","summary":"Find every public account for a username across 3000+ sites (powered by the Maigret OSINT engine) → for each site where the account exists: the platform + the public profile link. Also accepts a Steam numeric ID or profile URL (steamcommunity.com/profiles/...). Scan the top-N most-popular sites (default 300), filter by tag (gaming/social/coding/…), or deep-scan to extract linked identifiers.","tags":["Social Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"top":{"type":"string"},"tags":{"type":"string"},"sites":{"type":"string"},"deep":{"type":"string"}},"required":["username"]},"example":{"username":"torvalds","top":30}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/v2ex/v1/search":{"post":{"operationId":"v2ex_search","summary":"Full-text search across EVERY V2EX topic since 2010 (title + body + replies) — the historical archive the site's own JSON API does not expose. Filter by node, date range and sort by recency or relevance; each hit returns the full post body, author handle, node, reply count and markup-free match snippets.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"match":{"type":"string"},"sort":{"type":"string"},"order":{"type":"string"},"node":{"type":"string"},"since":{"type":"string"},"until":{"type":"string"},"limit":{"type":"string"},"offset":{"type":"string"},"resolve_nodes":{"type":"string"}},"required":["q"]},"example":{"q":"爬虫","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/v2ex/v1/node_topics":{"post":{"operationId":"v2ex_node_topics","summary":"The newest topics of one V2EX node (sub-forum) with the COMPLETE post body — a live freshness feed for a niche: 'jobs' for hiring posts, 'outsourcing' for project leads, 'qna' for buying-intent questions, 'programmer' for developer chatter. Returns the node's own metadata (topic count, subscriber count) alongside.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"node_name":{"type":"string"},"limit":{"type":"string"}},"required":["node_name"]},"example":{"node_name":"qna"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/v2ex/v1/latest":{"post":{"operationId":"v2ex_latest","summary":"The newest topics across the WHOLE of V2EX (all nodes), each with its full post body — a single-call firehose of what the Chinese dev community is posting right now (typically ~47 topics, the freshest usually minutes old).","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"string"}}},"example":{"limit":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/v2ex/v1/hot":{"post":{"operationId":"v2ex_hot","summary":"Today's most-discussed V2EX topics with full bodies — the site's own hot list, ordered by the traction the community itself gave them.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/v2ex/v1/topic":{"post":{"operationId":"v2ex_topic","summary":"One V2EX topic by id or URL: the full post body plus the COMPLETE reply thread (every reply, in order, with author handle and timestamp) — the discussion is where the buying intent, the tool recommendations and the salary numbers actually live.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"with_replies":{"type":"string"},"replies_limit":{"type":"string"}},"required":["id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/v2ex/v1/user_topics":{"post":{"operationId":"v2ex_user_topics","summary":"The newest topics posted by one V2EX member, with full bodies — follow a recruiter, a vendor or a prolific poster without watching every node.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"limit":{"type":"string"}},"required":["username"]},"example":{"username":"Livid"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/v2ex/v1/member":{"post":{"operationId":"v2ex_member","summary":"Public profile of a V2EX member by handle or id: tagline, bio, website, github/twitter handle, self-typed location, join date and PRO status. Only what the member published themselves — the API exposes no e-mail, phone or real name.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"}},"required":["username"]},"example":{"username":"Livid"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/v2ex/v1/nodes":{"post":{"operationId":"v2ex_nodes","summary":"The V2EX node taxonomy — all 1364 sub-forums with slug, Chinese and English title, topic count, subscriber count and parent node. Pass `name` for one node, or `query` to search the directory (matches slug, Chinese title and English title). This is how you find the `node_name` for `node_topics` and the `node` filter for `search`.","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"query":{"type":"string"},"limit":{"type":"string"}}},"example":{"query":"python"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/validate/v1/vat":{"post":{"operationId":"validate_vat","summary":"Validate an EU VAT number via VIES → validity + registered company name & address.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"vat_number":{"type":"string"},"country":{"type":"string"}},"required":["vat_number"]},"example":{"vat_number":"IE6388047V"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/validate/v1/iban":{"post":{"operationId":"validate_iban","summary":"Validate + parse an IBAN offline (ISO 13616 mod-97) → country, BBAN, bank/branch/account. Optional enrich=true adds BIC + bank name/city (openiban.com, proxied).","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"iban":{"type":"string"},"enrich":{"type":"string"}},"required":["iban"]},"example":{"iban":"DE89 3704 0044 0532 0130 00"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/validate/v1/email":{"post":{"operationId":"validate_email","summary":"Validate an email: syntax + live MX + disposable-domain + role-account flags.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"},"check_mx":{"type":"string"}},"required":["email"]},"example":{"email":"jane.doe@google.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/validate/v1/batch":{"post":{"operationId":"validate_batch","summary":"Validate up to 100 mixed items ({type:vat|iban|email,value}) in one call.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"string"},"check_mx":{"type":"string"}},"required":["items"]},"example":{"items":[{"type":"iban","value":"DE89370400440532013000"},{"type":"email","value":"test@mailinator.com","check_mx":false},{"type":"iban","value":"bad"}]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vehicle/v1/vin_decode":{"post":{"operationId":"vehicle_vin_decode","summary":"decode a VIN → make/model/year/trim/engine/specs (vPIC)","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"vin":{"type":"string"},"modelyear":{"type":"string"},"raw":{"type":"string"}},"required":["vin"]},"example":{"vin":"1HGCM82633A004352"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vehicle/v1/vin_decode_batch":{"post":{"operationId":"vehicle_vin_decode_batch","summary":"decode up to 50 VINs in one call (vPIC batch)","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"vins":{"type":"string"},"raw":{"type":"string"}},"required":["vins"]},"example":{"vins":"1HGCM82633A004352,2003;5UXWX7C5*BA,2011"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vehicle/v1/vin_decode_flat":{"post":{"operationId":"vehicle_vin_decode_flat","summary":"per-variable VIN decode — one row per NHTSA variable with its label (the long-form companion to vin_decode)","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"vin":{"type":"string"},"modelyear":{"type":"string"}},"required":["vin"]},"example":{"vin":"1HGCM82633A004352"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vehicle/v1/fuel_economy":{"post":{"operationId":"vehicle_fuel_economy","summary":"EPA fuel economy — MPG/MPGe (city/highway/combined), CO2, annual fuel cost, EV range. By year+make+model (auto-resolves trims) or EPA id","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"year":{"type":"string"},"make":{"type":"string"},"model":{"type":"string"}}},"example":{"year":"2021","make":"Toyota","model":"Camry"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vehicle/v1/fuel_economy_options":{"post":{"operationId":"vehicle_fuel_economy_options","summary":"list EPA trims (each → an id for fuel_economy) for a year+make+model","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"year":{"type":"string"},"make":{"type":"string"},"model":{"type":"string"}},"required":["year","make","model"]},"example":{"year":"2021","make":"Toyota","model":"RAV4"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vehicle/v1/fuel_prices":{"post":{"operationId":"vehicle_fuel_prices","summary":"current US national average fuel prices (regular/midgrade/premium/diesel/e85/electric/cng/lpg)","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vehicle/v1/canadian_specs":{"post":{"operationId":"vehicle_canadian_specs","summary":"dimensional & weight specs (length, width, height, wheelbase, curb weight, track) from NHTSA's Canadian vehicle database","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"year":{"type":"string"},"make":{"type":"string"},"model":{"type":"string"}},"required":["year"]},"example":{"year":"2011","make":"Acura"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vehicle/v1/recalls":{"post":{"operationId":"vehicle_recalls","summary":"safety recalls by make+model+modelYear, or by campaignNumber","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"make":{"type":"string"},"model":{"type":"string"},"modelYear":{"type":"string"},"campaignNumber":{"type":"string"}}},"example":{"make":"acura","model":"rdx","modelYear":"2012"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vehicle/v1/safety_ratings":{"post":{"operationId":"vehicle_safety_ratings","summary":"NCAP star ratings + crash-test media; by vehicleId, or year+make+model (auto-resolves variants), or drill-down","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"vehicleId":{"type":"string"},"modelYear":{"type":"string"},"make":{"type":"string"},"model":{"type":"string"}}},"example":{"vehicleId":"7523"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vehicle/v1/complaints":{"post":{"operationId":"vehicle_complaints","summary":"consumer complaints by make+model+modelYear","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"make":{"type":"string"},"model":{"type":"string"},"modelYear":{"type":"string"}},"required":["make","model","modelYear"]},"example":{"make":"acura","model":"rdx","modelYear":"2012"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vehicle/v1/models":{"post":{"operationId":"vehicle_models","summary":"models for a make (optionally a modelYear / vehicleType)","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"make":{"type":"string"},"modelYear":{"type":"string"},"vehicleType":{"type":"string"}},"required":["make"]},"example":{"make":"honda"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vehicle/v1/makes":{"post":{"operationId":"vehicle_makes","summary":"all makes, or makes for a vehicleType (car/truck/mpv/motorcycle/...)","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"vehicleType":{"type":"string"}}},"example":{"vehicleType":"car"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vehicle/v1/manufacturers":{"post":{"operationId":"vehicle_manufacturers","summary":"all manufacturers (paged) or details for one","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"manufacturer":{"type":"string"},"page":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vehicle/v1/wmi_decode":{"post":{"operationId":"vehicle_wmi_decode","summary":"decode a 3-char WMI to its manufacturer","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"wmi":{"type":"string"}},"required":["wmi"]},"example":{"wmi":"1HG"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vehicle/v1/manufacturer_wmis":{"post":{"operationId":"vehicle_manufacturer_wmis","summary":"all WMIs registered to a manufacturer","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"manufacturer":{"type":"string"}},"required":["manufacturer"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vehicle/v1/vehicle_types":{"post":{"operationId":"vehicle_vehicle_types","summary":"vehicle types produced by a make","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"make":{"type":"string"}},"required":["make"]},"example":{"make":"honda"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vehicle/v1/product_options":{"post":{"operationId":"vehicle_product_options","summary":"recall/complaint enumeration tree (modelYears → makes → models; issueType=r|c)","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"issueType":{"type":"string"},"modelYear":{"type":"string"},"make":{"type":"string"}}},"example":{"issueType":"r","modelYear":"2012"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vehicle/v1/plant_codes":{"post":{"operationId":"vehicle_plant_codes","summary":"equipment (tire) plant codes for a year","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"year":{"type":"string"},"equipmentType":{"type":"string"},"reportType":{"type":"string"}},"required":["year"]},"example":{"year":"2021"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vinted/v1/catalog_search":{"post":{"operationId":"vinted_catalog_search","summary":"keyword + filter search (brand/size/condition/category/color/material/price)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"search_text":{"type":"string"},"filters":{"type":"string"},"brand_ids":{"type":"string"},"size_ids":{"type":"string"},"status_ids":{"type":"string"},"catalog_ids":{"type":"string"},"color_ids":{"type":"string"},"material_ids":{"type":"string"},"price_from":{"type":"string"},"price_to":{"type":"string"},"currency":{"type":"string"},"order":{"type":"string"},"per_page":{"type":"string"},"page":{"type":"string"},"tld":{"type":"string"}}},"example":{"query":"nike","tld":"fr","per_page":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vinted/v1/item_detail":{"post":{"operationId":"vinted_item_detail","summary":"Full Vinted item detail — title, price, photos, description, size, color, condition, material, category and a seller summary.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"item_id":{"type":"string"},"url":{"type":"string"},"path":{"type":"string"},"tld":{"type":"string"}}},"example":{"id":"9801094900"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vinted/v1/seller":{"post":{"operationId":"vinted_seller","summary":"seller profile (login/rating/item_count/feedback breakdown) — PII redactable","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"user_id":{"type":"string"},"seller_id":{"type":"string"},"tld":{"type":"string"}},"required":["id"]},"example":{"id":"52590768"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vinted/v1/seller_items":{"post":{"operationId":"vinted_seller_items","summary":"a seller's wardrobe items","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"user_id":{"type":"string"},"seller_id":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"tld":{"type":"string"}},"required":["id"]},"example":{"id":"52590768"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vinted/v1/seller_feedback":{"post":{"operationId":"vinted_seller_feedback","summary":"feedback left for a seller (text/rating/reviewer)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"user_id":{"type":"string"},"seller_id":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"tld":{"type":"string"}},"required":["id"]},"example":{"id":"52590768"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vinted/v1/brand_search":{"post":{"operationId":"vinted_brand_search","summary":"resolve a brand name -> brand_id (+ item/favourite counts)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"search_text":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"},"tld":{"type":"string"}}},"example":{"query":"nike","tld":"fr"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vinted/v1/autocomplete":{"post":{"operationId":"vinted_autocomplete","summary":"search typeahead — partial query -> ranked Vinted search suggestions (localized per site)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"search_text":{"type":"string"},"q":{"type":"string"},"tld":{"type":"string"}},"required":["query"]},"example":{"query":"nike","tld":"fr"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vinted/v1/similar":{"post":{"operationId":"vinted_similar","summary":"items similar to a given item (items/{id}/more)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"item_id":{"type":"string"},"content_source":{"type":"string"},"tld":{"type":"string"}},"required":["id"]},"example":{"id":"9801094900"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vinted/v1/catalog_filters":{"post":{"operationId":"vinted_catalog_filters","summary":"dynamic facets (size/brand/status/color/price/material + option ids) for a query/category","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"search_text":{"type":"string"},"catalog_ids":{"type":"string"},"tld":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vinted/v1/categories":{"post":{"operationId":"vinted_categories","summary":"Full Vinted category tree — id, title, code, URL and child categories for the selected country site.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"tld":{"type":"string"}}},"example":{"tld":"fr"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vinted/v1/colors":{"post":{"operationId":"vinted_colors","summary":"color enum (id/title/hex/code)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"tld":{"type":"string"}}},"example":{"tld":"fr"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vinted/v1/conditions":{"post":{"operationId":"vinted_conditions","summary":"item-condition enum (status id/title)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"tld":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vinted/v1/countries":{"post":{"operationId":"vinted_countries","summary":"country enum (id/iso/currency)","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"tld":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vinted/v1/sizes":{"post":{"operationId":"vinted_sizes","summary":"size groups + size ids","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"tld":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vuln-intel/v1/package_vulns":{"post":{"operationId":"vuln_intel_package_vulns","summary":"All known vulnerabilities affecting a package (by name+ecosystem, optionally pinned to an installed version) OR a git commit — via OSV.dev. The dependency-audit core.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"package":{"type":"string"},"ecosystem":{"type":"string"},"version":{"type":"string"},"commit":{"type":"string"}},"required":["package","ecosystem"]},"example":{"package":"org.apache.logging.log4j:log4j-core","ecosystem":"Maven","version":"2.14.1"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vuln-intel/v1/vuln_detail":{"post":{"operationId":"vuln_intel_vuln_detail","summary":"Full detail for one vulnerability by OSV id, GHSA id, or CVE id. OSV is the base record; if it resolves to a GHSA the response is enriched with GitHub's numeric CVSS base score, EPSS exploitation probability, and CWEs.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]},"example":{"id":"GHSA-jfh8-c2jp-5v3q"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vuln-intel/v1/advisory_search":{"post":{"operationId":"vuln_intel_advisory_search","summary":"Search the GitHub Advisory Database (GHSA) by ecosystem, severity, CVE, free text, type. Cursor-paginated (meta.next_cursor).","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ecosystem":{"type":"string"},"severity":{"type":"string"},"cve_id":{"type":"string"},"query":{"type":"string"},"type":{"type":"string"},"sort":{"type":"string"},"direction":{"type":"string"},"per_page":{"type":"string"},"cursor":{"type":"string"}}},"example":{"ecosystem":"pip","severity":"critical","per_page":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vuln-intel/v1/kev_check":{"post":{"operationId":"vuln_intel_kev_check","summary":"Is a CVE in the CISA Known-Exploited-Vulnerabilities catalog (actively exploited in the wild)? Returns the KEV entry when listed.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cve_id":{"type":"string"}},"required":["cve_id"]},"example":{"cve_id":"CVE-2021-44228"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vuln-intel/v1/kev_list":{"post":{"operationId":"vuln_intel_kev_list","summary":"Browse / filter the full CISA KEV catalog by vendor, product, or ransomware flag, with page pagination.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"vendor":{"type":"string"},"product":{"type":"string"},"ransomware":{"type":"string"},"page":{"type":"string"},"per_page":{"type":"string"}}},"example":{"vendor":"Microsoft","per_page":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vuln-intel/v1/exploits":{"post":{"operationId":"vuln_intel_exploits","summary":"Public exploit / PoC lookup for a CVE via the Exploit-DB (Offensive Security) database (keyless, CVE-indexed). Answers 'is there a weaponized public exploit?' — has_public_exploit + each entry's edb_id, type (remote/local/webapps/dos), platform, verified flag, date_published, and deep links (exploit_db_url + upstream source_url).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cve_id":{"type":"string"},"verified_only":{"type":"string"}},"required":["cve_id"]},"example":{"cve_id":"CVE-2021-44228"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/vuln-intel/v1/batch":{"post":{"operationId":"vuln_intel_batch","summary":"Bulk-scan up to 100 package/commit queries in one call (OSV querybatch), each hydrated to full vulnerability detail by default.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string"},"hydrate":{"type":"string"}},"required":["queries"]},"example":{"queries":[{"package":"lodash","ecosystem":"npm","version":"4.17.15"},{"package":"django","ecosystem":"PyPI","version":"3.0.0"}]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/walmart/v1/search":{"post":{"operationId":"walmart_search","summary":"Search Walmart.com by keyword → a paginated, sortable list of products with item id, name, current & list price, savings, star rating + review count, availability, seller, category, fulfillment, image and the product link. Narrow with min_price/max_price and sort. 🔴 `brand` IS ALL-OR-NOTHING PER SEARCH, because Walmart publishes it that way: a clothing/shoes/bags/watches grid carries it on every row (measured 549 of 549 rows over 9 such searches — t-shirt 62/62, backpack 72/72, jeans 71/71, sneakers 65/65…), and every other kind of search carries it on no row at all (0 of ~880 rows over 12 searches — laptop, tv, headphones, printer, coffee maker, sofa, dog food, milk, toothpaste, vitamins, lipstick, office chair). On those searches Walmart simply does not put the brand in the listing it publishes, so this API returns null rather than guessing it out of the product name. Read `meta.field_coverage.brand` to see how many rows of YOUR call carried one, and use product_detail when you need brand guaranteed — it carries it for every product, in every category.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"},"max_results":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"},"facet":{"type":"string"}},"required":["query"]},"example":{"query":"laptop"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/walmart/v1/product_detail":{"post":{"operationId":"walmart_product_detail","summary":"Full product record by Walmart item id (or product URL): name, brand, model, UPC, manufacturer part number, current & list price, availability, seller, average rating + review count, short & long descriptions, the full specification table, product highlights, every variant with its resolved attributes (colour/size/…), the category breadcrumb, return policy, fulfillment and the gallery images.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"item_id":{"type":"string"},"url":{"type":"string"}}},"example":{"item_id":"709326941"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/walmart/v1/reviews":{"post":{"operationId":"walmart_reviews","summary":"Customer reviews for a Walmart product by item id (or product URL): the average rating, total review count, recommended-percentage, the 5★→1★ rating distribution and percentages, the most-mentioned aspects, and the review texts (rating, title, body, date, helpful counts, verified-purchase, purchased variant, photos).","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"item_id":{"type":"string"},"url":{"type":"string"},"max_results":{"type":"string"}}},"example":{"item_id":"20122959141"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/walmart/v1/category":{"post":{"operationId":"walmart_category","summary":"Browse a Walmart category / department by its query term (e.g. 'coffee maker', '4k tv') → the same product grid as search, framed as a category browse with the related category searches surfaced. Paginated and sortable.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"sort":{"type":"string"},"page":{"type":"string"},"max_results":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"}},"required":["query"]},"example":{"query":"4k tv"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/weather-intel/v1/environment_current":{"post":{"operationId":"weather_intel_environment_current","summary":"premium combined snapshot: current weather + AQ + active alerts + nearby hazards + risk_summary{level,reasons,confidence} for a coordinate","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lat":{"type":"string"},"lon":{"type":"string"},"units":{"type":"string"},"include":{"type":"string"},"radius_km":{"type":"string"}},"required":["lat","lon"]},"example":{"lat":52.52,"lon":13.405}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/weather-intel/v1/forecast":{"post":{"operationId":"weather_intel_forecast","summary":"global point forecast (MET Norway, ~9 days): hourly steps + daily aggregates with normalized weather-code, feels-like, sunrise/sunset/moon. Optional source=us_nws returns the US-official National Weather Service forecast for US coordinates (api.weather.gov, public domain)","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lat":{"type":"string"},"lon":{"type":"string"},"units":{"type":"string"},"hours":{"type":"string"},"days":{"type":"string"},"source":{"type":"string"}},"required":["lat","lon"]},"example":{"lat":41.0082,"lon":28.9784,"days":3}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/weather-intel/v1/air_quality":{"post":{"operationId":"weather_intel_air_quality","summary":"nearest-station air quality (OpenAQ v3): pollutants + computed AQI-US/EAQI-EU + station distance + measurement freshness; honest insufficient_data when no station","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lat":{"type":"string"},"lon":{"type":"string"},"radius_km":{"type":"string"}},"required":["lat","lon"]},"example":{"lat":51.5072,"lon":-0.1276,"radius_km":25}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/weather-intel/v1/alerts":{"post":{"operationId":"weather_intel_alerts","summary":"official severe-weather warnings by country/US-state or coordinate: EU MeteoAlarm (39 countries) AND US NWS (api.weather.gov, all 50 states + territories + marine zones, via Webshare). The source is chosen automatically from the location; coverage/coverage_note name exactly which authority answered","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"lat":{"type":"string"},"lon":{"type":"string"},"severity_min":{"type":"string"},"active_only":{"type":"string"},"limit":{"type":"string"}}},"example":{"country":"germany","active_only":false}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/weather-intel/v1/hazards_nearby":{"post":{"operationId":"weather_intel_hazards_nearby","summary":"GDACS multi-hazard events (earthquake/cyclone/flood/volcano/wildfire/drought) within a radius of a coordinate, distance-sorted","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lat":{"type":"string"},"lon":{"type":"string"},"radius_km":{"type":"string"},"days":{"type":"string"},"types":{"type":"string"},"min_alert_level":{"type":"string"},"limit":{"type":"string"}},"required":["lat","lon"]},"example":{"lat":36.2,"lon":140.5,"radius_km":2000,"days":30}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/weather-intel/v1/disasters":{"post":{"operationId":"weather_intel_disasters","summary":"global GDACS disaster events with type/alert-level/date/bbox filters, or a single-event detail via event_id+event_type","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"types":{"type":"string"},"min_alert_level":{"type":"string"},"days":{"type":"string"},"bbox":{"type":"string"},"country":{"type":"string"},"limit":{"type":"string"},"event_id":{"type":"string"},"event_type":{"type":"string"}}},"example":{"days":30}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/weather-intel/v1/earthquakes":{"post":{"operationId":"weather_intel_earthquakes","summary":"USGS earthquake catalog (earthquake.usgs.gov, public domain): filter by magnitude, radius, time window, depth, and PAGER alert — includes small and medium-magnitude events that disaster aggregators like GDACS omit. Results are distance-sorted around a coordinate. Pass event_id for a single-event detail.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"lat":{"type":"string"},"lon":{"type":"string"},"radius_km":{"type":"string"},"min_magnitude":{"type":"string"},"max_magnitude":{"type":"string"},"days":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"min_depth_km":{"type":"string"},"max_depth_km":{"type":"string"},"order":{"type":"string"},"pager_alert":{"type":"string"},"limit":{"type":"string"},"event_id":{"type":"string"}}},"example":{"min_magnitude":5.0,"days":30,"limit":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/weather-intel/v1/natural_events":{"post":{"operationId":"weather_intel_natural_events","summary":"NASA EONET natural-event catalog (eonet.gsfc.nasa.gov, NASA open data): wildfires, severe storms, volcanoes, floods, icebergs, dust/haze — a second independent hazard source alongside GDACS. Filter by category, status, and date range; optionally list the full EONET category taxonomy.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"status":{"type":"string"},"days":{"type":"string"},"bbox":{"type":"string"},"limit":{"type":"string"},"list_categories":{"type":"string"}}},"example":{"status":"open","limit":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/weather-intel/v1/fires":{"post":{"operationId":"weather_intel_fires","summary":"Live wildfire and thermal-anomaly hotspots from NASA FIRMS (firms.modaps.eosdis.nasa.gov, NASA open data): pixel-level VIIRS (375 m) and MODIS (1 km) near-real-time detections — the raw sensor data that disaster aggregators like GDACS and EONET do not include. Query by a coordinate radius or a bounding box; each hotspot includes brightness, Fire Radiative Power (FRP), confidence, day/night flag, and the exact acquisition timestamp.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"lat":{"type":"string"},"lon":{"type":"string"},"radius_km":{"type":"string"},"bbox":{"type":"string"},"sensor":{"type":"string"},"days":{"type":"string"},"min_confidence":{"type":"string"},"min_frp":{"type":"string"},"limit":{"type":"string"}}},"example":{"bbox":"-20,-35,55,20","days":1,"limit":50}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/weather-intel/v1/geocode":{"post":{"operationId":"weather_intel_geocode","summary":"Place name → coordinates (Open-Meteo Geocoding, GeoNames-backed, free/keyless): turns a city/town/region name into the lat/lon every other weather-intel action needs, with country, region (admin1/2), population, timezone and elevation. Pass 'id' (a GeoNames id from a prior result) for the single canonical record instead of a name search.","tags":["Utilities & AI"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"id":{"type":"string"},"language":{"type":"string"},"count":{"type":"string"}}},"example":{"name":"Istanbul","count":3}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/weather-intel/v1/historical":{"post":{"operationId":"weather_intel_historical","summary":"Historical weather (Open-Meteo Archive / ERA5 reanalysis, 1940→present, free/keyless) for a coordinate and date range: daily aggregates (min/max temp, precipitation, wind, weather-code, sunrise/sunset) and/or hourly variables. The live forecast actions exclude history — this is the long-record companion. Default daily set is returned when neither 'daily' nor 'hourly' is specified.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lat":{"type":"string"},"lon":{"type":"string"},"start_date":{"type":"string"},"end_date":{"type":"string"},"units":{"type":"string"},"daily":{"type":"string"},"hourly":{"type":"string"}},"required":["lat","lon","start_date","end_date"]},"example":{"lat":41.0082,"lon":28.9784,"start_date":"2024-01-01","end_date":"2024-01-07"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/weather-intel/v1/marine":{"post":{"operationId":"weather_intel_marine","summary":"Marine / ocean-wave forecast (Open-Meteo Marine, free/keyless) for a coordinate: significant wave height, period and direction plus swell and wind-wave components — hourly out to several days, plus daily maxima and the current sea state. On land (no marine grid cell) values are honestly null (never fabricated).","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lat":{"type":"string"},"lon":{"type":"string"},"units":{"type":"string"},"forecast_days":{"type":"string"},"hourly":{"type":"string"},"daily":{"type":"string"},"current":{"type":"string"}},"required":["lat","lon"]},"example":{"lat":54.544,"lon":10.402,"forecast_days":2}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/weather-intel/v1/air_quality_forecast":{"post":{"operationId":"weather_intel_air_quality_forecast","summary":"Air-quality FORECAST + pollen (Open-Meteo Air-Quality, CAMS-backed, free/keyless) for a coordinate: hourly forecast of PM2.5/PM10/O3/NO2/SO2/CO, the European AQI and US AQI, plus European pollen (alder/birch/grass/olive/ragweed/mugwort). Complements the OpenAQ nearest-station `air_quality` (which is measured, current only) with a forward forecast and pollen — and needs NO API key. Pollen is European-domain only; outside Europe it is honestly null.","tags":["Utilities & AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lat":{"type":"string"},"lon":{"type":"string"},"forecast_days":{"type":"string"},"hourly":{"type":"string"},"current":{"type":"string"}},"required":["lat","lon"]},"example":{"lat":52.52,"lon":13.405,"forecast_days":2}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/web-archive/v1/snapshots":{"post":{"operationId":"web_archive_snapshots","summary":"All Wayback captures for a URL (timestamp, status, mimetype, digest, archival size, snapshot_url), date/status/mime filtered, collapsible, RESUME-KEY PAGINATED.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"limit":{"type":"string"},"collapse":{"type":"string"},"match":{"type":"string"},"status":{"type":"string"},"mime":{"type":"string"},"filter":{"type":"string"},"resume_key":{"type":"string"}},"required":["url"]},"example":{"url":"github.com","limit":10,"collapse":"digest"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/web-archive/v1/available":{"post":{"operationId":"web_archive_available","summary":"Closest single Wayback snapshot to a given date (or the latest). Fast existence check.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"timestamp":{"type":"string"}},"required":["url"]},"example":{"url":"github.com","timestamp":"20120601"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/web-archive/v1/history":{"post":{"operationId":"web_archive_history","summary":"Lifespan + capture cadence for a URL: EXACT first_seen/last_seen + span, plus per-year capture counts and status/mime breakdown — the SEO/due-diligence summary.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"match":{"type":"string"}},"required":["url"]},"example":{"url":"github.com"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/web-archive/v1/domain_captures":{"post":{"operationId":"web_archive_domain_captures","summary":"All archived URLs under a domain (the domain + its subdomains), one row per unique URL — the 'every page this site ever had' view. Resume-key paginated.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"limit":{"type":"string"},"status":{"type":"string"},"mime":{"type":"string"},"filter":{"type":"string"},"resume_key":{"type":"string"}},"required":["url"]},"example":{"url":"github.com","limit":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/web-archive/v1/batch":{"post":{"operationId":"web_archive_batch","summary":"Closest-snapshot existence + capture-count for up to 20 URLs in one call (bulk archival presence — competitor/portfolio sweeps).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string"},"timestamp":{"type":"string"}},"required":["urls"]},"example":{"urls":["github.com","python.org"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/web-archive/v1/cc_search":{"post":{"operationId":"web_archive_cc_search","summary":"Common Crawl index lookup for a URL — alternate/broader coverage with richer fields (detected language, encoding, WARC offset/filename). Cross-source corroboration.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"collection":{"type":"string"},"match":{"type":"string"},"limit":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"filter":{"type":"string"}},"required":["url"]},"example":{"url":"github.com","limit":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/web-archive/v1/cc_indexes":{"post":{"operationId":"web_archive_cc_indexes","summary":"List the available Common Crawl monthly indexes (id, name, date range) — pick a collection for cc_search.","tags":["Developer Tools"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/web-extract/v1/scrape":{"post":{"operationId":"web_extract_scrape","summary":"Fetch one URL and return its content in the formats you choose (markdown, plain text, cleaned HTML, raw HTML, metadata, links, images, or structured JSON-LD data). Automatically upgrades thin single-page-app pages to a full browser render when needed. Works on any public page — news articles, product pages, documentation, blogs.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"formats":{"type":"string"},"render":{"type":"string"},"only_main_content":{"type":"string"},"include_tags":{"type":"string"},"exclude_tags":{"type":"string"},"target_selector":{"type":"string"}},"required":["url"]},"example":{"url":"https://en.wikipedia.org/wiki/Web_scraping","formats":["markdown","metadata"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/web-extract/v1/map":{"post":{"operationId":"web_extract_map","summary":"Discover a site's complete URL surface: reads robots.txt, sitemap.xml (and sitemap indexes), and the homepage's internal links — returns a deduplicated URL list with a page-type label for each (home, pricing, docs, blog, product, legal, contact, about). Use this to index any site or audit its structure.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"search":{"type":"string"},"limit":{"type":"string"},"include_subdomains":{"type":"string"}},"required":["url"]},"example":{"url":"https://stripe.com","limit":50}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/web-extract/v1/crawl":{"post":{"operationId":"web_extract_crawl","summary":"Crawl a site starting from a seed URL (up to 25 pages): follows internal links breadth-first with configurable depth, include/exclude URL patterns, and returns every visited page in the formats you choose. Ideal for content indexing, site audits, and building knowledge bases from documentation or blog sites.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"max_pages":{"type":"string"},"max_depth":{"type":"string"},"same_domain_only":{"type":"string"},"include_patterns":{"type":"string"},"exclude_patterns":{"type":"string"},"formats":{"type":"string"}},"required":["url"]},"example":{"url":"https://example.com","max_pages":2,"max_depth":1}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/web-extract/v1/extract":{"post":{"operationId":"web_extract_extract","summary":"Pull structured data from any public page: returns JSON-LD objects (Product, Article, Organization, etc.), microdata presence, parsed table rows, heading outline, prices, emails, and phone numbers. Supply an optional field-to-path schema to extract specific values directly — great for e-commerce pricing, article metadata, and business listings.","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"schema":{"type":"string"},"deterministic_only":{"type":"string"}},"required":["url"]},"example":{"url":"https://en.wikipedia.org/wiki/Python_(programming_language)"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/web-extract/v1/batch":{"post":{"operationId":"web_extract_batch","summary":"Scrape up to 10 URLs concurrently in one call (each SSRF-guarded). Shared formats. Firecrawl /batch-scrape parity (bounded).","tags":["Developer Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string"},"formats":{"type":"string"},"only_main_content":{"type":"string"},"timeout":{"type":"string"}},"required":["urls"]},"example":{"urls":["https://example.com","https://en.wikipedia.org/wiki/HTML"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/wikipedia/v1/summary":{"post":{"operationId":"wikipedia_summary","summary":"page summary: extract, description, thumbnail, coordinates, wikibase QID, urls (lang= any of 360+ editions)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"lang":{"type":"string"}},"required":["title"]},"example":{"title":"Albert Einstein"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/wikipedia/v1/page":{"post":{"operationId":"wikipedia_page","summary":"full article: plain-text body + internal links + image list + categories + external links (content=false → structure only)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"lang":{"type":"string"},"content":{"type":"string"},"links_limit":{"type":"string"},"images_limit":{"type":"string"}},"required":["title"]},"example":{"title":"Albert Einstein"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/wikipedia/v1/search":{"post":{"operationId":"wikipedia_search","summary":"full-text search → ranked pages (snippet/pageid/wordcount) + totalhits; enrich= adds extract/thumbnail/QID","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"lang":{"type":"string"},"limit":{"type":"string"},"offset":{"type":"string"},"enrich":{"type":"string"}},"required":["query"]},"example":{"query":"quantum computing"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/wikipedia/v1/entity_facts":{"post":{"operationId":"wikipedia_entity_facts","summary":"Wikidata facts for a QID or title: label/description/aliases + resolved human-readable facts{prop:value} + key_facts + identifiers + image/coords","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"qid":{"type":"string"},"title":{"type":"string"},"query":{"type":"string"},"lang":{"type":"string"},"value_cap":{"type":"string"}}},"example":{"id":"Q937"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/wikipedia/v1/pageviews":{"post":{"operationId":"wikipedia_pageviews","summary":"daily/monthly traffic for an article over a date range → series + total + average","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"lang":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"days":{"type":"string"},"granularity":{"type":"string"},"access":{"type":"string"},"agent":{"type":"string"}},"required":["title"]},"example":{"title":"Albert Einstein","start":"20240101","end":"20240131"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/wikipedia/v1/related":{"post":{"operationId":"wikipedia_related","summary":"pages related to a title; enrich= adds extract/thumbnail","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"lang":{"type":"string"},"limit":{"type":"string"},"enrich":{"type":"string"}},"required":["title"]},"example":{"title":"Albert Einstein"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/wikipedia/v1/autocomplete":{"post":{"operationId":"wikipedia_autocomplete","summary":"typeahead title suggestions","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"lang":{"type":"string"},"limit":{"type":"string"}},"required":["q"]},"example":{"q":"Einst"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/wikipedia/v1/geosearch":{"post":{"operationId":"wikipedia_geosearch","summary":"Wikipedia pages near a coordinate or around a title","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"lat":{"type":"string"},"lon":{"type":"string"},"coord":{"type":"string"},"title":{"type":"string"},"radius":{"type":"string"},"limit":{"type":"string"},"lang":{"type":"string"}}},"example":{"lat":48.8584,"lon":2.2945,"radius":1000}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/wikipedia/v1/on_this_day":{"post":{"operationId":"wikipedia_on_this_day","summary":"historical events/births/deaths/holidays for a month-day (kind=all|selected|events|births|deaths|holidays)","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"month":{"type":"string"},"day":{"type":"string"},"date":{"type":"string"},"kind":{"type":"string"},"limit":{"type":"string"},"lang":{"type":"string"}}},"example":{"month":3,"day":14,"kind":"selected"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/wikipedia/v1/top_articles":{"post":{"operationId":"wikipedia_top_articles","summary":"most-viewed articles for a given date (trending)","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string"},"limit":{"type":"string"},"access":{"type":"string"},"include_special":{"type":"string"},"lang":{"type":"string"}}},"example":{"date":"2024-01-15"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/wikipedia/v1/category_members":{"post":{"operationId":"wikipedia_category_members","summary":"list the pages, sub-categories or files that belong to a Wikipedia category (cmtype=page|subcat|file); paginate with meta.next/cmcontinue","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"lang":{"type":"string"},"limit":{"type":"string"},"cmtype":{"type":"string"},"cmcontinue":{"type":"string"}},"required":["category"]},"example":{"category":"Physicists"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/wikipedia/v1/langlinks":{"post":{"operationId":"wikipedia_langlinks","summary":"full cross-language map for a title: every edition's {lang, title, url, langname, autonym} plus a langmap{lang:title} lookup (the page action only returns the count)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"lang":{"type":"string"},"limit":{"type":"string"}},"required":["title"]},"example":{"title":"Albert Einstein"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/wikipedia/v1/random":{"post":{"operationId":"wikipedia_random","summary":"one or more random articles; enrich= adds extract/thumbnail/QID","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"lang":{"type":"string"},"limit":{"type":"string"},"enrich":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/wikipedia/v1/revisions":{"post":{"operationId":"wikipedia_revisions","summary":"edit history of an article: revid, parentid, timestamp, user, comment, size, tags; from/to window the range","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"lang":{"type":"string"},"limit":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"}},"required":["title"]},"example":{"title":"Albert Einstein"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/wikipedia/v1/html":{"post":{"operationId":"wikipedia_html","summary":"rendered article HTML (REST Parsoid) — or raw wiki markup with format=wikitext","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"lang":{"type":"string"},"format":{"type":"string"}},"required":["title"]},"example":{"title":"Albert Einstein"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/wikipedia/v1/featured":{"post":{"operationId":"wikipedia_featured","summary":"Wikimedia featured-content feed for a date: tfa (today's featured article), image-of-the-day, in-the-news, most-read and on-this-day (blocks vary by language/date)","tags":["Media, Film & Knowledge"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string"},"lang":{"type":"string"}}},"example":{"date":"2024-03-14"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/worldbank/v1/indicator":{"post":{"operationId":"worldbank_indicator","summary":"time-series for one+ indicators (code or shortcut) across one+ countries/all; date/mrv/mrnev, rank","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"indicator":{"type":"string"},"date":{"type":"string"},"mrv":{"type":"string"},"mrnev":{"type":"string"},"drop_nulls":{"type":"string"},"rank":{"type":"string"},"per_page":{"type":"string"},"max_pages":{"type":"string"},"frequency":{"type":"string"},"gapfill":{"type":"string"}},"required":["country","indicator"]},"example":{"country":"US","indicator":"NY.GDP.MKTP.CD","date":"2015:2022"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/worldbank/v1/country":{"post":{"operationId":"worldbank_country","summary":"country metadata for codes/all or filtered by region/income_level/lending_type","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"region":{"type":"string"},"income_level":{"type":"string"},"lending_type":{"type":"string"},"exclude_aggregates":{"type":"string"},"all":{"type":"string"}},"required":["country"]},"example":{"country":"US"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/worldbank/v1/search_indicators":{"post":{"operationId":"worldbank_search_indicators","summary":"local keyword search over the indicator catalog (WDI default; full=all sources)","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"source":{"type":"string"},"full":{"type":"string"},"topic":{"type":"string"},"limit":{"type":"string"}},"required":["query"]},"example":{"query":"gdp growth"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/worldbank/v1/indicator_metadata":{"post":{"operationId":"worldbank_indicator_metadata","summary":"definition/source/organization/topics for one+ indicator codes/aliases","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"indicator":{"type":"string"}},"required":["indicator"]},"example":{"indicator":"gdp"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/worldbank/v1/country_profile":{"post":{"operationId":"worldbank_country_profile","summary":"one-call headline snapshot (most-recent ~10 key metrics) for one+ countries","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"metrics":{"type":"string"}},"required":["country"]},"example":{"country":"FR"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/worldbank/v1/shortcuts":{"post":{"operationId":"worldbank_shortcuts","summary":"list the metric->indicator-code map, or metric=&country= to fetch directly","tags":["Finance & Data"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"metric":{"type":"string"},"country":{"type":"string"},"date":{"type":"string"},"mrv":{"type":"string"},"mrnev":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/worldbank/v1/reference":{"post":{"operationId":"worldbank_reference","summary":"reference lists: regions | income_levels | lending_types | sources | topics","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string"}},"required":["kind"]},"example":{"kind":"income_levels"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/worldbank/v1/topic_indicators":{"post":{"operationId":"worldbank_topic_indicators","summary":"browse every indicator in a World Bank topic (Health, Economy, Climate, etc.) by topic id or name; optional keyword filter","tags":["Finance & Data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"topic":{"type":"string"},"query":{"type":"string"},"limit":{"type":"string"},"per_page":{"type":"string"},"max_pages":{"type":"string"}},"required":["topic"]},"example":{"topic":"health","limit":25}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/yandex-maps/v1/search":{"post":{"operationId":"yandex_maps_search","summary":"Search Yandex Maps for businesses by text/category. Returns up to ~25 orgs with name, address, coordinates, rating, review count, categories, phone, website, social links and opening hours.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"city":{"type":"string"},"region_id":{"type":"string"},"ll":{"type":"string"},"z":{"type":"string"}},"required":["text"]},"example":{"text":"kahve","city":"istanbul"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/yandex-maps/v1/detail":{"post":{"operationId":"yandex_maps_detail","summary":"Full business card for one org by org_id (or a Yandex Maps org URL): name, address, coordinates, rating, categories, phones, website, social links, opening hours, features and photo count.","tags":["Reputation & Reviews"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"org_id":{"type":"string"},"url":{"type":"string"}}},"example":{"org_id":"1242233919"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/yandex-maps/v1/reviews":{"post":{"operationId":"yandex_maps_reviews","summary":"Paginated public customer reviews for an org: author handle, level, star rating, text, date and the business's reply. 50 reviews per page — page with `page`; meta.total_pages / meta.review_count tell you how many.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"org_id":{"type":"string"},"page":{"type":"string"}},"required":["org_id"]},"example":{"org_id":"1242233919"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/yandex-maps/v1/nearby":{"post":{"operationId":"yandex_maps_nearby","summary":"Find businesses of a category around a coordinate. Returns geo-anchored orgs (same shape as search) closest to the given 'lon,lat' center.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ll":{"type":"string"},"text":{"type":"string"},"z":{"type":"string"}},"required":["ll","text"]},"example":{"ll":"28.985,41.036","text":"eczane"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/yandex-maps/v1/geocode":{"post":{"operationId":"yandex_maps_geocode","summary":"Geocode an address/place name to coordinates via Yandex. Returns the matched toponym with latitude/longitude and a normalized address. Pass a complete address; Yandex resolves it directly (don't over-qualify a place already named).","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string"}},"required":["address"]},"example":{"address":"Taksim Meydanı"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/yellowpages/v1/search":{"post":{"operationId":"yellowpages_search","summary":"Search the Yellow Pages business directory by category/keyword and US location. Returns up to 30 businesses per page with name, phone, address, categories, star rating, review count, years in business, a 'From Business' snippet and the detail URL. Paginate with `page`; meta.total_results gives the full match count.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"search_terms":{"type":"string"},"geo_location_terms":{"type":"string"},"page":{"type":"string"}},"required":["search_terms","geo_location_terms"]},"example":{"search_terms":"plumber","geo_location_terms":"Austin, TX"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/yellowpages/v1/detail":{"post":{"operationId":"yellowpages_detail","summary":"Full business profile from a Yellow Pages detail URL (the `url` of a search result): name, description, full address, geo coordinates, phone, website, email, rating + review count, years in business / founding year, payment methods, languages, opening hours, the list of services offered and recent customer reviews.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/yellowpages/v1/category":{"post":{"operationId":"yellowpages_category","summary":"Browse every business in a Yellow Pages category for a US city — e.g. all restaurants in Chicago, all dentists in Miami. Same business fields as search, paginated. Use this when you want a city-wide category list rather than a keyword search.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"location":{"type":"string"},"page":{"type":"string"}},"required":["category","location"]},"example":{"category":"restaurants","location":"Chicago, IL"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/yelp/v1/business/reviews":{"post":{"operationId":"yelp_business_reviews","summary":"Fetch all reviews (with full pagination — newest, oldest, highest rated or elite first) plus the complete Yelp business profile — rating, review count, categories, price, phone, address, hours, amenities and photos. Accepts up to 39 businesses per call via their Yelp business ID.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"encBizIds":{"type":"string"},"maxReviews":{"type":"string"},"sortBy":{"type":"string"},"ratings":{"type":"string"},"language":{"type":"string"},"includeDetail":{"type":"string"},"includeNotRecommended":{"type":"string"},"reviewsPerPage":{"type":"string"}},"required":["encBizIds"]},"example":{"encBizIds":["gZz9A8k8ORC_xl0aHxtY4w"],"maxReviews":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/yelp/v1/business/details":{"post":{"operationId":"yelp_business_details","summary":"Get the full Yelp business profile without reviews — name, categories, star rating, review count, price level, phone, full address, coordinates, hours, amenities and photo. Faster and cheaper than business/reviews when you only need the listing. Accepts up to 39 businesses per call via their Yelp business ID.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"encBizIds":{"type":"string"},"includePii":{"type":"string"}},"required":["encBizIds"]},"example":{"encBizIds":["gZz9A8k8ORC_xl0aHxtY4w"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/yelp/v1/search":{"post":{"operationId":"yelp_search","summary":"Search Yelp by keyword or category in a location — just like typing 'Pizza in San Francisco, CA' on the Yelp website — with the same filters the site offers (price, rating, open-now, sort order and feature attributes). Returns a ranked list of businesses, each with its Yelp business ID, name, Yelp URL, star rating, review count, price level, categories, address and photo. Pass the business ID directly into business/reviews or business/details. Paginate with the offset parameter.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"term":{"type":"string"},"location":{"type":"string"},"limit":{"type":"string"},"offset":{"type":"string"},"sort_by":{"type":"string"},"price":{"type":"string"},"open_now":{"type":"string"},"min_rating":{"type":"string"},"attributes":{"type":"string"}},"required":["term","location"]},"example":{"term":"Pizza","location":"San Francisco, CA","limit":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/yelp/v1/popular_dishes":{"post":{"operationId":"yelp_popular_dishes","summary":"Get a restaurant's popular dishes from Yelp — the 'Popular dishes' section shown on the Yelp business page — returning each dish's name and photo. Identify the restaurant by its Yelp business URL, its Yelp business ID (from the search or business details actions), or its Yelp slug. Restaurant pages only; returns an empty list when Yelp shows no popular dishes for that restaurant.","tags":["Reputation & Reviews"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"business_url":{"type":"string"},"business_id":{"type":"string"},"slug":{"type":"string"},"limit":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/yelp/v1/menus":{"post":{"operationId":"yelp_menus","summary":"Get a restaurant's menu from Yelp when Yelp hosts it — returning menu sections with each item's name, description, price and photo. Identify the restaurant by its Yelp business URL, Yelp business ID, or slug. Only menus hosted on Yelp are returned; many restaurants link to an external menu, which Yelp has no structured data for — `menu_available` is false in those cases.","tags":["Reputation & Reviews"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"business_url":{"type":"string"},"business_id":{"type":"string"},"slug":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/yelp/v1/business/photos":{"post":{"operationId":"yelp_business_photos","summary":"Get a Yelp business's photos — the images shown on its Yelp page, with captions and categories (food, menu, interior, etc.) where Yelp provides them. Identify the business by its Yelp business URL, Yelp business ID, or slug.","tags":["Reputation & Reviews"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"business_url":{"type":"string"},"business_id":{"type":"string"},"slug":{"type":"string"},"limit":{"type":"string"}}},"example":{"slug":"tonys-pizza-napoletana-san-francisco","limit":8}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/yelp/v1/review_highlights":{"post":{"operationId":"yelp_review_highlights","summary":"Get a Yelp business's review highlights — the recurring phrases reviewers mention (e.g. 'happy hour', 'great service'), each with a sample snippet from a real review. A fast at-a-glance read on what the business is known for. Identify the business by its Yelp business URL, Yelp business ID, or slug.","tags":["Reputation & Reviews"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"business_url":{"type":"string"},"business_id":{"type":"string"},"slug":{"type":"string"},"limit":{"type":"string"}}},"example":{"slug":"tonys-pizza-napoletana-san-francisco","limit":6}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/yelp/v1/business/url-to-id":{"post":{"operationId":"yelp_business_url_to_id","summary":"Convert any yelp.com/biz/… business page URL into the Yelp business ID used by business/details, business/reviews, popular_dishes and menus.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"business_url":{"type":"string"}},"required":["business_url"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/yelp/v1/business/search":{"post":{"operationId":"yelp_business_search","summary":"Find a Yelp business by name (plus optional location) and return its Yelp business ID, name and Yelp URL. Pass the business ID straight into business/reviews or business/details. No Yelp account required.","tags":["Reputation & Reviews"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"location":{"type":"string"},"limit":{"type":"string"},"resolveAll":{"type":"string"}},"required":["name"]},"example":{"name":"Blue Bottle Coffee","location":"San Francisco"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/youtube/v1/search":{"post":{"operationId":"youtube_search","summary":"search videos/channels/playlists/shorts with filters (upload date, duration, sort order, features)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"type":{"type":"string"},"limit":{"type":"string"},"continuation":{"type":"string"},"upload_date":{"type":"string"},"duration":{"type":"string"},"sort_by":{"type":"string"},"features":{"type":"string"}},"required":["query"]},"example":{"query":"lofi hip hop","type":"video","limit":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/youtube/v1/video_detail":{"post":{"operationId":"youtube_video_detail","summary":"video metadata: title/views/likes/date/channel/description (+ duration/keywords/thumbnails/caption-langs best-effort)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"video_id":{"type":"string"}},"required":["video_id"]},"example":{"video_id":"dQw4w9WgXcQ"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/youtube/v1/video_details":{"post":{"operationId":"youtube_video_details","summary":"BATCH engagement enrichment — pass up to 50 video_ids in ONE call, get likes + description (+ optional comment_count) per video. Built to enrich channel_videos/channel_shorts lists (which don't carry likes) without one call per video.","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"video_ids":{"type":"string"},"include_comment_count":{"type":"string"}},"required":["video_ids"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/youtube/v1/comments":{"post":{"operationId":"youtube_comments","summary":"video comments (text/author/likes/replies), paginated, sortable by top or newest","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"video_id":{"type":"string"},"limit":{"type":"string"},"continuation":{"type":"string"},"sort":{"type":"string"}},"required":["video_id"]},"example":{"video_id":"dQw4w9WgXcQ","limit":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/youtube/v1/channel":{"post":{"operationId":"youtube_channel","summary":"channel detail: subs/videoCount/description/links","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"channel_id":{"type":"string"},"handle":{"type":"string"},"url":{"type":"string"}},"required":["channel_id"]},"example":{"channel_id":"UCX6OQ3DkcsbYNE6H8uQQuVA"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/youtube/v1/transcript":{"post":{"operationId":"youtube_transcript","summary":"video transcript/captions (timed segments + full text) select any language the video has via 'lang'; format=text|segments","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"video_id":{"type":"string"},"lang":{"type":"string"},"format":{"type":"string"}},"required":["video_id"]},"example":{"video_id":"dQw4w9WgXcQ","lang":"en"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/youtube/v1/playlist":{"post":{"operationId":"youtube_playlist","summary":"list a playlist's videos (id/title/channel/duration/position), paginated","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"playlist_id":{"type":"string"},"limit":{"type":"string"},"continuation":{"type":"string"}},"required":["playlist_id"]},"example":{"playlist_id":"PL15B1E77BB5708555","limit":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/youtube/v1/channel_videos":{"post":{"operationId":"youtube_channel_videos","summary":"a channel's uploads (Videos tab): video_id/title/views/duration, paginated","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"channel_id":{"type":"string"},"handle":{"type":"string"},"url":{"type":"string"},"limit":{"type":"string"},"continuation":{"type":"string"}},"required":["channel_id"]},"example":{"channel_id":"UCX6OQ3DkcsbYNE6H8uQQuVA","limit":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/youtube/v1/channel_shorts":{"post":{"operationId":"youtube_channel_shorts","summary":"a channel's Shorts tab (video_id/title/views/views_int/thumbnails), paginated — the Shorts that the Videos tab (channel_videos) omits; works for shorts-only channels","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"channel_id":{"type":"string"},"handle":{"type":"string"},"url":{"type":"string"},"limit":{"type":"string"},"continuation":{"type":"string"}},"required":["channel_id"]},"example":{"channel_id":"UCX6OQ3DkcsbYNE6H8uQQuVA","limit":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/youtube/v1/related":{"post":{"operationId":"youtube_related","summary":"recommended/related videos for a video_id (from the watch page)","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"video_id":{"type":"string"},"limit":{"type":"string"}},"required":["video_id"]},"example":{"video_id":"dQw4w9WgXcQ","limit":15}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/youtube/v1/channel_about":{"post":{"operationId":"youtube_channel_about","summary":"full channel About panel: total views, joined date, country, links, description","tags":["Media, Film & Knowledge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"channel_id":{"type":"string"},"handle":{"type":"string"},"url":{"type":"string"}},"required":["channel_id"]},"example":{"channel_id":"UCX6OQ3DkcsbYNE6H8uQQuVA"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zalando/v1/search":{"post":{"operationId":"zalando_search","summary":"Search Zalando by keyword — returns product cards with name, brand, SKU, price, color, images and product URL. Filterable by brand, price range and category; paginated.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"country":{"type":"string"},"page":{"type":"string"},"category":{"type":"string"},"order":{"type":"string"},"brand":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"}},"required":["q"]},"example":{"q":"nike","country":"de"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zalando/v1/category":{"post":{"operationId":"zalando_category","summary":"Browse Zalando products by category (e.g. herrenschuhe-sneaker) — returns listing cards with name, brand, price and images. Filterable and paginated.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"country":{"type":"string"},"page":{"type":"string"},"order":{"type":"string"},"brand":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"}},"required":["category"]},"example":{"category":"herrenschuhe-sneaker","country":"de"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zalando/v1/sale":{"post":{"operationId":"zalando_sale","summary":"On-sale / discounted Zalando products — the outlet grid with original price, current price, discount percent (0-100) and discount amount (money off). Scope to a category, otherwise lands on the country's sale/outlet section. Paginated.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"category":{"type":"string"},"page":{"type":"string"},"brand":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zalando/v1/new_arrivals":{"post":{"operationId":"zalando_new_arrivals","summary":"Newest Zalando products in a category, sorted newest-first. Scope to a category (e.g. damenschuhe-sneaker), otherwise lands on the country's primary section. Paginated.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"category":{"type":"string"},"page":{"type":"string"},"brand":{"type":"string"},"min_price":{"type":"string"},"max_price":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zalando/v1/product":{"post":{"operationId":"zalando_product","summary":"Full Zalando product detail by URL or SKU — name, brand, price, color, gallery images, available sizes, rating and attributes.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"sku":{"type":"string"},"country":{"type":"string"}}},"example":{"url":"https://www.zalando.de/nike-sportswear-air-force-1-07-sneaker-low-white-ni112n022-a11.html","country":"de"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zalando/v1/similar":{"post":{"operationId":"zalando_similar","summary":"Products similar to a given Zalando item — pulled from the product page recommendation cards.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"sku":{"type":"string"},"country":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zalando/v1/variants":{"post":{"operationId":"zalando_variants","summary":"All size variants for a Zalando product with in-stock flags — useful for monitoring stock availability.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"sku":{"type":"string"},"country":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zalando/v1/brands":{"post":{"operationId":"zalando_brands","summary":"Distinct brands present in a given Zalando listing — the brands found across the product cards of the supplied category or keyword search (one listing page, not Zalando's full brand directory). Useful for building brand filter chips for that listing. Pass category or q; defaults to the country's primary section.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"category":{"type":"string"},"q":{"type":"string"},"page":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zalando/v1/categories":{"post":{"operationId":"zalando_categories","summary":"Top-level Zalando category links for a country, live-discovered from that TLD's own localized homepage navigation — so each country returns its real localized paths (fr: femme/homme/enfant, it: donna/uomo/bambini, es: mujer/hombre, nl: dames/heren, pl: kobiety/mezczyzni …), feed these paths to the category / sale / new_arrivals actions.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"gender":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zalando/v1/filters":{"post":{"operationId":"zalando_filters","summary":"Discover which sort and filter options are available for Zalando listings, including price range, brand and sort order.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"category":{"type":"string"},"q":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zalando/v1/reviews":{"post":{"operationId":"zalando_reviews","summary":"Customer reviews and overall rating summary for a Zalando product (when reviews are embedded on the product page).","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"sku":{"type":"string"},"country":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zalando/v1/attributes":{"post":{"operationId":"zalando_attributes","summary":"Product attribute clusters for a Zalando item — material composition, care instructions and other structured attributes from the product page.","tags":["E-commerce & Marketplaces"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"sku":{"type":"string"},"country":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zappos/v1/search":{"post":{"operationId":"zappos_search","summary":"Search the Zappos catalog. Give a `query` ('running shoes', 'hiking boots', 'nike air max', 'womens dresses') and get back 100 products per page, each with Zappos' own product id, style id and colour id, price and list price, discount, units in stock, star rating, review count, badges, the full image set, and the product's OTHER colourways inline. Narrow with brand, colour, gender, size, width, department, category, material, style, feature, occasion, pattern, theme, price bucket and an on-sale switch; sort by price, rating, newest or best sellers. Every filter value your query actually supports — with the number of products behind it — is returned in `filters_available`, so you never have to guess.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"max_results":{"type":"string"},"page":{"type":"string"},"sort":{"type":"string"},"brand":{"type":"string"},"color":{"type":"string"},"gender":{"type":"string"},"size":{"type":"string"},"width":{"type":"string"},"category":{"type":"string"},"department":{"type":"string"},"material":{"type":"string"},"style":{"type":"string"},"feature":{"type":"string"},"occasion":{"type":"string"},"pattern":{"type":"string"},"theme":{"type":"string"},"price_range":{"type":"string"},"on_sale":{"type":"string"}},"required":["query"]},"example":{"query":"running shoes","max_results":40}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zappos/v1/product_detail":{"post":{"operationId":"zappos_product_detail","summary":"Get one Zappos product in full, by its product id (or its zappos.com URL) — brand, category, gender, the marketing description and every specification bullet, the parsed physical measurements (weight, heel height, shaft, circumference, platform height, bag depth and strap drop where Zappos lists them), size charts, the customer rating with its star histogram and the runs-small / runs-wide / arch-support breakdowns, and the two customer reviews Zappos embeds. Every colourway is returned with its own style id, colour id, price, list price, image set and stock, and the selected colourway is broken down to the SIZE x WIDTH level: one row per purchasable variant with Zappos' stock id, the Amazon ASIN, the manufacturer UPC, that variant's own price and list price, and how many units are in stock right now.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"},"color_id":{"type":"string"},"style_id":{"type":"string"},"url":{"type":"string"},"include_all_color_variants":{"type":"string"}},"required":["product_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zara/v1/search":{"post":{"operationId":"zara_search","summary":"Search the Zara catalogue and get back the products on sale right now — each with Zara's own product id, name, price (with the was-price and discount percentage when it is reduced), currency, availability, colourway with hex code, the other colours it comes in, the product images at full resolution, the department and product family, and the link to the page. Choose the country store with `market` (that is what sets the currency), narrow with section, colour, category or brand, sort by price, and page through the results. Every filter value the query actually supports comes back in `filters_available` with counts, so you never have to guess one.","tags":["Other"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"market":{"type":"string"},"section":{"type":"string"},"brand":{"type":"string"},"color":{"type":"string"},"category":{"type":"string"},"sort":{"type":"string"},"max_results":{"type":"string"},"page":{"type":"string"}},"required":["query"]},"example":{"query":"dress","max_results":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zara/v1/product_detail":{"post":{"operationId":"zara_product_detail","summary":"Get one Zara product in full, by its product id or its zara.com URL — the name and the full description, the price with its currency and any discount, the product reference as printed on the label, EVERY colourway it is made in and, inside each one, EVERY size with Zara's own SKU number, that size's own price and whether it is in stock right now. Also the complete image gallery at full resolution, the fibre composition broken down per garment part, care instructions, country of origin and traceability, safety warnings, certified and sustainable material claims, physical measurements where Zara publishes them, the size system, the department and product family, and the date the product first went on sale. Choose the country store with `market` — id, price, currency and stock are all per-market.","tags":["Other"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"},"url":{"type":"string"},"market":{"type":"string"},"include_composition":{"type":"string"},"find_market":{"type":"string"}}},"example":{"product_id":"545422590","market":"us"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zillow/v1/new_listings":{"post":{"operationId":"zillow_new_listings","summary":"New US inventory straight from Zillow's own published feed — the listings that appeared in the last couple of days, refreshed within the hour. Returns identity and location (zpid, canonical url, address as Zillow writes it, region, postal code, country, changed_at); pass a zpid to `property_detail` for price, beds, sqft, status and Zestimate.","tags":["Real Estate"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"region":{"type":"string"},"country":{"type":"string"},"postal_prefix":{"type":"string"},"changed_after":{"type":"string"},"max_results":{"type":"string"},"page":{"type":"string"}}},"example":{"category":"for_sale","max_results":5}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zillow/v1/search":{"post":{"operationId":"zillow_search","summary":"Search listings by location (for sale / for rent / recently sold), with structured filters: price, beds, baths, home type, sqft, lot, year built, HOA, days-on-market and keywords. Read `returns` before using status=for_rent (rentals come back as BUILDINGS with a units[] breakdown, not as individual apartments) or status=sold (about a dozen US states publish no sale price at all).","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"},"status":{"type":"string"},"max_pages":{"type":"string"},"fetch_all":{"type":"string"},"max_results":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"beds_min":{"type":"string"},"baths_min":{"type":"string"},"home_type":{"type":"string"},"sqft_min":{"type":"string"},"sqft_max":{"type":"string"},"lot_min":{"type":"string"},"lot_max":{"type":"string"},"year_built_min":{"type":"string"},"year_built_max":{"type":"string"},"max_hoa":{"type":"string"},"days_on_max":{"type":"string"},"keywords":{"type":"string"}},"required":["location"]},"example":{"location":"Austin, TX"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zillow/v1/search_by_coordinates":{"post":{"operationId":"zillow_search_by_coordinates","summary":"Search listings inside exact map bounds (returns more than the standard ~860-result cap), with the same structured filters as search.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"map_bounds":{"type":"string"},"status":{"type":"string"},"max_pages":{"type":"string"},"fetch_all":{"type":"string"},"max_results":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"beds_min":{"type":"string"},"baths_min":{"type":"string"},"home_type":{"type":"string"},"sqft_min":{"type":"string"},"sqft_max":{"type":"string"},"lot_min":{"type":"string"},"lot_max":{"type":"string"},"year_built_min":{"type":"string"},"year_built_max":{"type":"string"},"max_hoa":{"type":"string"},"days_on_max":{"type":"string"},"keywords":{"type":"string"}},"required":["map_bounds"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zillow/v1/search_by_url":{"post":{"operationId":"zillow_search_by_url","summary":"Run any copied Zillow URL: a search URL replays that exact search (with its filters); a property URL routes to the full property detail.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zillow/v1/property_detail":{"post":{"operationId":"zillow_property_detail","summary":"Full property record: Zestimate (+history), price & tax history, schools, walk/transit/bike scores, agent, photos, RESO facts. Batch several with zpids[].","tags":["Real Estate"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"zpid":{"type":"string"},"zpids":{"type":"string"},"url":{"type":"string"}}},"example":{"zpid":"29377187"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zillow/v1/comps":{"post":{"operationId":"zillow_comps","summary":"Comparable homes near a property (synthesized similar-listing search, scored by distance/beds/sqft).","tags":["Real Estate"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"zpid":{"type":"string"},"url":{"type":"string"},"radius_deg":{"type":"string"},"max_comps":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zillow/v1/sold":{"post":{"operationId":"zillow_sold","summary":"Recently-sold listings (last 12 months) by location or map bounds, with the same structured filters as search. The sale price fills in disclosure states and is genuinely absent in non-disclosure ones - read `returns` before building on it.","tags":["Real Estate"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"},"map_bounds":{"type":"string"},"max_pages":{"type":"string"},"fetch_all":{"type":"string"},"max_results":{"type":"string"},"price_min":{"type":"string"},"price_max":{"type":"string"},"beds_min":{"type":"string"},"baths_min":{"type":"string"},"home_type":{"type":"string"},"sqft_min":{"type":"string"},"sqft_max":{"type":"string"},"lot_min":{"type":"string"},"lot_max":{"type":"string"},"year_built_min":{"type":"string"},"year_built_max":{"type":"string"},"max_hoa":{"type":"string"},"days_on_max":{"type":"string"},"keywords":{"type":"string"}}},"example":{"location":"Seattle, WA"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zillow/v1/agent":{"post":{"operationId":"zillow_agent","summary":"Listing agent + broker attribution for one property (agentInfo).","tags":["Real Estate"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"zpid":{"type":"string"},"url":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zillow/v1/agent_profile":{"post":{"operationId":"zillow_agent_profile","summary":"An agent's full portfolio: profile info + their for-sale/sold listings + reviews.","tags":["Real Estate"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"profile_url":{"type":"string"},"zuid":{"type":"string"},"url":{"type":"string"}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zillow/v1/agents_by_location":{"post":{"operationId":"zillow_agents_by_location","summary":"Real-estate agent directory for a location, with review summaries.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"}},"required":["location"]},"example":{"location":"Austin, TX"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zillow/v1/autocomplete":{"post":{"operationId":"zillow_autocomplete","summary":"Location autocomplete — suggest Zillow regions and addresses for a free-text query (city, ZIP, neighborhood, county or street). Use it to resolve a fuzzy term before searching, or to power a search box.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]},"example":{"query":"Austin"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zillow/v1/market_trends":{"post":{"operationId":"zillow_market_trends","summary":"Region market metrics: ZHVI home-value index, median sale/list price, inventory, days-to-pending, % sold above list, rent index.","tags":["Real Estate"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string"}},"required":["location"]},"example":{"location":"Austin, TX"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zillow/v1/walk_transit_bike":{"post":{"operationId":"zillow_walk_transit_bike","summary":"Zillow Walk Score, Transit Score and Bike Score for a property — walkability, public-transit access and bikeability (0-100) with a description for each.","tags":["Real Estate"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"zpid":{"type":"string"},"url":{"type":"string"}}},"example":{"zpid":"29377187"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/zillow/v1/home_value_chart":{"post":{"operationId":"zillow_home_value_chart","summary":"Zillow home-value history — the Zestimate value-over-time series for a property (monthly home value, up to the last 10 years, with the latest forecast point).","tags":["Real Estate"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"zpid":{"type":"string"},"url":{"type":"string"},"time_period":{"type":"string"}}},"example":{"zpid":"29377187"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/ziprecruiter/v1/search":{"post":{"operationId":"ziprecruiter_search","summary":"Search live ZipRecruiter job listings by keyword and location, with pagination and an optional remote-only filter. Each result includes the title, company, location, salary (when posted), posting date, a snippet, the on-site job URL and the apply link. Covers the United Kingdom (ziprecruiter.co.uk), Ireland (ziprecruiter.ie) and Germany (ziprecruiter.de).","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"location":{"type":"string"},"country":{"type":"string"},"page":{"type":"string"},"max_results":{"type":"string"},"remote":{"type":"string"}},"required":["query"]},"example":{"query":"software engineer","location":"London","country":"gb","max_results":20}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/ziprecruiter/v1/job_detail":{"post":{"operationId":"ziprecruiter_job_detail","summary":"Full ZipRecruiter job posting by job ID (or URL): title, company, location, salary range, employment type, remote flag, posting & expiry dates, the full description, an extracted requirements list and the apply link.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string"},"url":{"type":"string"},"country":{"type":"string"}},"required":["job_id"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}},"/ziprecruiter/v1/jobs_by_company":{"post":{"operationId":"ziprecruiter_jobs_by_company","summary":"List a specific employer's open jobs on ZipRecruiter. Pass a company name; the engine searches and keeps only listings whose employer matches (ZipRecruiter's country sites have no dedicated company page, so this is a best-effort name match over the search results). Optionally narrow by location.","tags":["Jobs & Hiring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"string"},"location":{"type":"string"},"country":{"type":"string"},"page":{"type":"string"},"max_results":{"type":"string"}},"required":["company"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"Envelope":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"},"data":{"description":"Action result (shape varies per action)"},"meta":{"type":"object","description":"api, endpoint, mode, latency_ms, record_count, completeness_pct, cache_hit"},"error":{"type":"object","nullable":true,"properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"}}}}}}}}