Piloterr

Piloterr Bhphotovideo API

The Bhphotovideo API from Piloterr — 2 operation(s) for bhphotovideo.

GitHub OpenAPI

Operations 4

GET /v2/bhphotovideo/product B&H Photo Video Product #
POST /v2/bhphotovideo/product B&H Photo Video Product #
POST /v2/bhphotovideo/search B&H Photo Video Search #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/piloterr-com/openapi/piloterr-com-bhphotovideo-api-openapi.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/piloterr-com:piloterr-com-bhphotovideo-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

piloterr-com-bhphotovideo-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Piloterr API Reference Bhphotovideo API
  description: Complete API reference documentation.
  version: 1.0.0
servers:
- url: https://api.piloterr.com
  description: API Server
tags:
- name: Bhphotovideo
paths:
  /v2/bhphotovideo/product:
    get:
      summary: B&H Photo Video Product
      description: 'Read a B&H Photo Video product from its URL or id. Returns price, rating, specifications, and box contents.


        **Credit cost:** 1 credit per call'
      operationId: get-bhphotovideo-product
      security:
      - ApiKeyAuth: []
      parameters:
      - name: query
        in: query
        required: true
        description: 'Product URL or id.


          Example:


          ```

          1948568-REG

          ```'
        schema:
          type: string
          description: 'Product URL or id.


            Example:


            ```

            1948568-REG

            ```'
      - name: return_page_source
        in: query
        required: false
        description: When true, return the raw HTML. The string false stays false.
        schema:
          type: boolean
          description: When true, return the raw HTML. The string false stays false.
      - $ref: '#/components/parameters/fields'
      - $ref: '#/components/parameters/is_async'
      - $ref: '#/components/parameters/soft_fail'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  mpn:
                    type: string
                  sku:
                    type: string
                  url:
                    type: string
                  gtin:
                    type: string
                  brand:
                    type: string
                  price:
                    type: number
                  title:
                    type: string
                  rating:
                    type: number
                  currency:
                    type: string
                  in_stock:
                    type: boolean
                  product_id:
                    type: string
                  review_count:
                    type: integer
                  price_display:
                    type: string
                  original_price:
                    type: number
                  original_price_display:
                    type: string
              examples:
                SANDISK 128GB Extreme PRO on B&H:
                  value:
                    mpn: SDSDXXJ-128G-GSCIN
                    sku: SA128EPSD
                    url: https://www.bhphotovideo.com/c/product/1948568-REG/sandisk_sdsdxxj_128g_gscin_128gb_extreme_pro_uhs_i.html
                    gtin: '619659184812'
                    brand: SANDISK
                    price: 51.99
                    title: SANDISK 128GB Extreme PRO UHS-I SDXC Memory Card
                    rating: 4.8
                    currency: USD
                    in_stock: true
                    product_id: 1948568-REG
                    review_count: 25
                    price_display: $51.99
                    original_price: 52.99
                    original_price_display: $52.99
        '400':
          description: Bad Request — missing or invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Bad Request
        '401':
          description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                invalidKey:
                  value:
                    error: Invalid API Key
                planRateLimit:
                  value:
                    error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
                keyQuota:
                  value:
                    error: 'Rate limit exceeded for the API key: quota monthly'
        '402':
          description: Payment Required — your subscription or credit balance is insufficient.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Payment required
        '500':
          description: Internal Server Error — something went wrong on our side.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Internal Error
      tags:
      - Bhphotovideo
    post:
      summary: B&H Photo Video Product
      description: 'Read a B&H Photo Video product from its URL or id. Returns price, rating, specifications, and box contents.


        **Credit cost:** 1 credit per call'
      operationId: post-bhphotovideo-product
      security:
      - ApiKeyAuth: []
      parameters:
      - $ref: '#/components/parameters/fields'
      - $ref: '#/components/parameters/is_async'
      - $ref: '#/components/parameters/soft_fail'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  description: 'Product URL or id.


                    Example:


                    ```

                    1948568-REG

                    ```'
                return_page_source:
                  type: boolean
                  description: When true, return the raw HTML. The string false stays false.
              required:
              - query
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  mpn:
                    type: string
                  sku:
                    type: string
                  url:
                    type: string
                  gtin:
                    type: string
                  brand:
                    type: string
                  price:
                    type: number
                  title:
                    type: string
                  rating:
                    type: number
                  currency:
                    type: string
                  in_stock:
                    type: boolean
                  product_id:
                    type: string
                  review_count:
                    type: integer
                  price_display:
                    type: string
                  original_price:
                    type: number
                  original_price_display:
                    type: string
              examples:
                SANDISK 128GB Extreme PRO on B&H:
                  value:
                    mpn: SDSDXXJ-128G-GSCIN
                    sku: SA128EPSD
                    url: https://www.bhphotovideo.com/c/product/1948568-REG/sandisk_sdsdxxj_128g_gscin_128gb_extreme_pro_uhs_i.html
                    gtin: '619659184812'
                    brand: SANDISK
                    price: 51.99
                    title: SANDISK 128GB Extreme PRO UHS-I SDXC Memory Card
                    rating: 4.8
                    currency: USD
                    in_stock: true
                    product_id: 1948568-REG
                    review_count: 25
                    price_display: $51.99
                    original_price: 52.99
                    original_price_display: $52.99
        '400':
          description: Bad Request — missing or invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Bad Request
        '401':
          description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                invalidKey:
                  value:
                    error: Invalid API Key
                planRateLimit:
                  value:
                    error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
                keyQuota:
                  value:
                    error: 'Rate limit exceeded for the API key: quota monthly'
        '402':
          description: Payment Required — your subscription or credit balance is insufficient.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Payment required
        '500':
          description: Internal Server Error — something went wrong on our side.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Internal Error
      tags:
      - Bhphotovideo
  /v2/bhphotovideo/search:
    get:
      summary: B&H Photo Video Search
      description: 'Search B&H Photo Video by keyword or search URL. Returns BH numbers, dollar prices, and a next page URL.


        **Credit cost:** 1 credit per call'
      operationId: get-bhphotovideo-search
      security:
      - ApiKeyAuth: []
      parameters:
      - name: query
        in: query
        required: true
        description: 'Keyword or a bhphotovideo.com search URL.


          Example:


          ```

          sandisk extreme pro

          ```'
        schema:
          type: string
          description: 'Keyword or a bhphotovideo.com search URL.


            Example:


            ```

            sandisk extreme pro

            ```'
      - name: page
        in: query
        required: false
        description: 'Page number, starting at 1. Example: 2.'
        schema:
          type: number
          description: 'Page number, starting at 1. Example: 2.'
      - name: return_page_source
        in: query
        required: false
        description: When true, return the raw HTML. The string false stays false.
        schema:
          type: boolean
          description: When true, return the raw HTML. The string false stays false.
      - $ref: '#/components/parameters/fields'
      - $ref: '#/components/parameters/is_async'
      - $ref: '#/components/parameters/soft_fail'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        mpn:
                          type: string
                        sku:
                          type: string
                        url:
                          type: string
                        price:
                          type: number
                        title:
                          type: string
                        currency:
                          type: string
                        product_id:
                          type: string
                        review_count:
                          type: integer
                        price_display:
                          type: string
                        original_price:
                          type: number
                        original_price_display:
                          type: string
                  pagination:
                    type: object
                    properties:
                      next:
                        type: string
                      page:
                        type: integer
                      per_page:
                        type: integer
                      total_pages:
                        nullable: true
                      total_results:
                        nullable: true
              examples:
                B&H search for sandisk extreme pro:
                  value:
                    results:
                    - mpn: SDSDXXJ-128G-GSCIN
                      sku: SA128EPSD
                      url: https://www.bhphotovideo.com/c/product/1948568-REG/sandisk_sdsdxxj_128g_gscin_128gb_extreme_pro_uhs_i.html
                      price: 51.99
                      title: SANDISK 128GB Extreme PRO UHS-I SDXC Memory Card
                      currency: USD
                      product_id: 1948568-REG
                      review_count: 25
                      price_display: $51.99
                      original_price: 52.99
                      original_price_display: $52.99
                    pagination:
                      next: https://www.bhphotovideo.com/c/search?pn=2&q=sandisk%20extreme%20pro
                      page: 1
                      per_page: 28
                      total_pages: null
                      total_results: null
        '400':
          description: Bad Request — missing or invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Bad Request
        '401':
          description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                invalidKey:
                  value:
                    error: Invalid API Key
                planRateLimit:
                  value:
                    error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
                keyQuota:
                  value:
                    error: 'Rate limit exceeded for the API key: quota monthly'
        '402':
          description: Payment Required — your subscription or credit balance is insufficient.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Payment required
        '500':
          description: Internal Server Error — something went wrong on our side.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Internal Error
      tags:
      - Bhphotovideo
    post:
      summary: B&H Photo Video Search
      description: 'Search B&H Photo Video by keyword or search URL. Returns BH numbers, dollar prices, and a next page URL.


        **Credit cost:** 1 credit per call'
      operationId: post-bhphotovideo-search
      security:
      - ApiKeyAuth: []
      parameters:
      - $ref: '#/components/parameters/fields'
      - $ref: '#/components/parameters/is_async'
      - $ref: '#/components/parameters/soft_fail'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  description: 'Keyword or a bhphotovideo.com search URL.


                    Example:


                    ```

                    sandisk extreme pro

                    ```'
                page:
                  type: number
                  description: 'Page number, starting at 1. Example: 2.'
                return_page_source:
                  type: boolean
                  description: When true, return the raw HTML. The string false stays false.
              required:
              - query
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        mpn:
                          type: string
                        sku:
                          type: string
                        url:
                          type: string
                        price:
                          type: number
                        title:
                          type: string
                        currency:
                          type: string
                        product_id:
                          type: string
                        review_count:
                          type: integer
                        price_display:
                          type: string
                        original_price:
                          type: number
                        original_price_display:
                          type: string
                  pagination:
                    type: object
                    properties:
                      next:
                        type: string
                      page:
                        type: integer
                      per_page:
                        type: integer
                      total_pages:
                        nullable: true
                      total_results:
                        nullable: true
              examples:
                B&H search for sandisk extreme pro:
                  value:
                    results:
                    - mpn: SDSDXXJ-128G-GSCIN
                      sku: SA128EPSD
                      url: https://www.bhphotovideo.com/c/product/1948568-REG/sandisk_sdsdxxj_128g_gscin_128gb_extreme_pro_uhs_i.html
                      price: 51.99
                      title: SANDISK 128GB Extreme PRO UHS-I SDXC Memory Card
                      currency: USD
                      product_id: 1948568-REG
                      review_count: 25
                      price_display: $51.99
                      original_price: 52.99
                      original_price_display: $52.99
                    pagination:
                      next: https://www.bhphotovideo.com/c/search?pn=2&q=sandisk%20extreme%20pro
                      page: 1
                      per_page: 28
                      total_pages: null
                      total_results: null
        '400':
          description: Bad Request — missing or invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Bad Request
        '401':
          description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                invalidKey:
                  value:
                    error: Invalid API Key
                planRateLimit:
                  value:
                    error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
                keyQuota:
                  value:
                    error: 'Rate limit exceeded for the API key: quota monthly'
        '402':
          description: Payment Required — your subscription or credit balance is insufficient.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Payment required
        '500':
          description: Internal Server Error — something went wrong on our side.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Internal Error
      tags:
      - Bhphotovideo
components:
  parameters:
    fields:
      name: fields
      in: query
      required: false
      description: Comma-separated list of response fields to return, with dot notation for nested fields (e.g. `name,location.city`).
      schema:
        type: string
    is_async:
      name: is_async
      in: query
      required: false
      description: 'Run the request as a background job: the API answers `202` with a `job_id` to poll on `GET /v1/jobs/{id}`.'
      schema:
        type: boolean
        default: false
    soft_fail:
      name: soft_fail
      in: query
      required: false
      description: Return HTTP 200 even when the request fails; the error is in the `error` field of the body.
      schema:
        type: boolean
        default: false
  schemas:
    ErrorResponse:
      type: object
      required:
      - error
      properties:
        error:
          type: string
          description: Human-readable error message.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your API key. Include it in the x-api-key header for every request.