ReefAPI

ReefAPI Other API

The Other API from ReefAPI — 57 operation(s) for other.

GitHub OpenAPI

Operations 57

POST /alibaba/v1/product_detail Full wholesale detail for one alibaba.com listing — the complete quantity price… #
POST /autodoc/v1/vehicle_lookup Walk Autodoc's vehicle tree — this is where every other action starts, because… #
POST /autodoc/v1/product_detail One part in full, by Autodoc's numeric article id (or its URL). #
POST /autodoc/v1/oem_lookup Cross-reference a vehicle manufacturer's ORIGINAL part number to everything… #
POST /autodoc/v1/categories Autodoc's part-category vocabulary — all 199 leaf categories with the slug and… #
POST /boyner/v1/product/detail Full Boyner product by `url` OR `product_id`: title, brand, price (current +… #
POST /decathlon/v1/product_detail Get one Decathlon product in full, by handle, product id or decathlon.com URL… #
POST /elcorteingles/v1/product_detail Get one El Corte Inglés product in full, by URL, product code or EAN-13. #
POST /flo/v1/category/products Browse a FLO category (`category` slug + optional `cinsiyet` gender), paginated… #
POST /flo/v1/product/detail Full FLO product by its page `url`: title, brand, price, original_price… #
POST /forum/v1/latest Newest topics from one forum, each with its creation time. #
POST /forum/v1/sites Every forum this API can read, with its platform and market #
POST /forum/v1/topic The full text of one topic: the opening post and every reply #
POST /n11/v1/product/detail Full n11 product by `url` or `product_id`: title, brand, price, discount… #
POST /n11/v1/product/reviews Customer reviews for a product by `url` or `product_id` — the review set n11… #
POST /n11/v1/category Browse an n11 category by its `url` (…/ or …-c-), paginated + sortable #
POST /n11/v1/seller Seller (mağaza) profile + its products by nickname or store `url` #
POST /n11/v1/resolve Resolve an n11 short-link (`token` or `url`, e.g. #
POST /sephora/v1/price Re-check ONE shade's price and stock, cheaply. #
POST /sephora/v1/product_detail Get one Sephora product in full, by its product id (or its sephora.com URL). #
POST /swappa/v1/price Re-check ONE listing's price, availability and condition, cheaply. #
POST /swappa/v1/product_detail Get one Swappa listing in full, by its listing code or its swappa.com URL — the… #
POST /target/v1/product_detail Get one Target product in full, by Target's own id or by its target.com URL. #
POST /twitter/v1/profile User profile by @username — name, bio, followers, following, tweet/like counts… #
POST /twitter/v1/user_by_id User profile by numeric user_id (same fields as profile) #
POST /twitter/v1/user_tweets A user's tweets — full text, engagement (likes/retweets/replies/quotes/views)… #
POST /twitter/v1/user_replies A user's tweets AND replies (timeline incl. #
POST /twitter/v1/user_media A user's media tweets — photos & videos (with video_url + duration)… #
POST /twitter/v1/user_likes Tweets a user has liked (if the account exposes likes) #
POST /twitter/v1/tweet A single tweet by id — full text, engagement, media, quoted/retweeted, author #
POST /twitter/v1/tweet_replies A tweet PLUS its replies/comments (threaded conversation) with DEEP cursor… #
POST /twitter/v1/followers A user's followers (each a full user object), paginated #
POST /twitter/v1/following Accounts a user follows (each a full user object), paginated #
POST /twitter/v1/list_tweets Latest tweets from a Twitter List by id, paginated #
POST /ulta/v1/price Re-check ONE variant's price and stock, cheaply. #
POST /ulta/v1/product_detail Get one Ulta Beauty product in full, by Ulta's product id or by its ulta.com… #
POST /zappos/v1/product_detail Get one Zappos product in full, by its product id (or its zappos.com URL)… #
POST /zara/v1/product_detail Get one Zara product in full, by its product id or its zara.com URL — the name… #

Documentation

📖
Documentation
https://reefapi.com/docs
📖
APIReference
https://reefapi.com/apis
📖
Quickstart
https://reefapi.com/docs#quickstart

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/reefapi/refs/heads/main/openapi/reefapi-other-api-openapi.yml

Other Resources

🔗
DeveloperPortal
https://reefapi.com/docs
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/reefapi/refs/heads/main/data-model/reefapi-data-model.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/reefapi/refs/heads/main/errors/reefapi-problem-types.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/reefapi/refs/heads/main/conventions/reefapi-conventions.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/reefapi-other-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

reefapi-other-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Reef Other API
  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: Other
paths:
  /alibaba/v1/search:
    post:
      operationId: alibaba_search
      summary: Search alibaba.com wholesale listings by keyword — 48 supplier offers per page…
      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…
      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…
      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
  /autodoc/v1/vehicle_lookup:
    post:
      operationId: autodoc_vehicle_lookup
      summary: Walk Autodoc's vehicle tree — this is where every other action starts, because…
      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…
      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).
      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.
      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…
      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…
      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
  /boyner/v1/search:
    post:
      operationId: boyner_search
      summary: Search Boyner by keyword (`query`), paginated (`page`, 24/page).
      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 +…'
      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
  /decathlon/v1/search:
    post:
      operationId: decathlon_search
      summary: Search or browse the decathlon.com (US) catalogue.
      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…
      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
  /elcorteingles/v1/search:
    post:
      operationId: elcorteingles_search
      summary: Search or browse elcorteingles.es.
      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.
      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
  /flo/v1/search:
    post:
      operationId: flo_search
      summary: Search FLO by keyword (`query`), paginated.
      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…
      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…'
      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.
      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.
      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
  /n11/v1/product/detail:
    post:
      operationId: n11_product_detail
      summary: 'Full n11 product by `url` or `product_id`: title, brand, price, discount…'
      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…
      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.
      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.
      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
  /sephora/v1/search:
    post:
      operationId: sephora_search
      summary: Search the Sephora catalog.
      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.
      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).
      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
  /swappa/v1/search:
    post:
      operationId: swappa_search
      summary: Search Swappa for live listings.
      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
                ed

# --- truncated at 32 KB (57 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/reefapi/refs/heads/main/openapi/reefapi-other-api-openapi.yml