Diffbot

Diffbot Product API

The Product API from Diffbot — 1 operation(s) for product.

GitHub OpenAPI

Operations 1

GET /product Product #

Documentation

📖
Documentation
https://www.diffbot.com/docs/bulk/
📖
APIReference
https://www.diffbot.com/docs/bulk/create
📖
Documentation
https://www.diffbot.com/docs/dql/
📖
APIReference
https://www.diffbot.com/docs/dql/get
📖
Documentation
https://www.diffbot.com/docs/enhance/
📖
APIReference
https://www.diffbot.com/docs/enhance/get
📖
Documentation
https://www.diffbot.com/docs/web-search/
📖
APIReference
https://www.diffbot.com/docs/web-search/get
📖
Documentation
https://www.diffbot.com/docs/account
📖
APIReference
https://www.diffbot.com/docs/account

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/diffbot/refs/heads/main/openapi/diffbot-product-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/diffbot-product-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

diffbot-product-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Extract Product API
  description: Diffbot's Extraction APIs include various endpoints to extract JSON data/fields from different types of web pages. The Analyze endpoint is used when the page type is unknown, and will attempt to identify the page type and send it to the appropriate extraction API.
  termsOfService: https://www.diffbot.com/terms/
  contact:
    email: support@diffbot.com
  version: 1.1.0
servers:
- url: https://api.diffbot.com/v3
tags:
- name: Product
paths:
  /product:
    get:
      tags:
      - Product
      summary: Product
      description: Automatically extract pricing, product specs, images, and more from an e-commerce product page.
      operationId: product
      parameters:
      - name: url
        in: query
        description: Target URL to extract
        required: true
        schema:
          type: string
          default: https://www.microcenter.com/product/628738/evga-nvidia-geforce-rtx-3090-ftw3-ultra-triple-fan-24gb-gddr6x-pcie-40-graphics-card
      - name: fields
        in: query
        description: Specify optional fields to be returned from any fully-extracted pages (e.g. `fields=querystring,links`)
        schema:
          type: string
          enum:
          - links
          - extlinks
          - meta
          - querystring
          - breadcrumb
      - name: timeout
        in: query
        description: Sets a value in milliseconds to wait for the retrieval/fetch of content from the requested URL. The default timeout for the third-party response is 30 seconds (30000).
        schema:
          type: integer
          format: int32
      - name: callback
        in: query
        description: Use for jsonp requests. Needed for cross-domain ajax.
        schema:
          type: string
      - name: proxy
        in: query
        description: 'Specify an IP address of a [custom proxy](https://docs.diffbot.com/reference/using-proxies#how-to-use-proxies) that will be used to fetch the target page. (Ex: `&proxy` or `&proxy=0.0.0.0`)'
        schema:
          type: string
          default: ''
      - name: proxyAuth
        in: query
        description: 'Used to specify the authentication parameters that will be used with a custom proxy specified in the &proxy parameter. (Ex: `proxyAuth=username:password`)'
        schema:
          type: string
      - name: useProxy
        in: query
        description: Set to `default` to use [Diffbot's datacenter proxy](https://docs.diffbot.com/reference/using-proxies#how-to-use-proxies) for this request. `none` will instruct Extract to not use proxies, even if proxies have been enabled for this particular URL globally.
        schema:
          type: string
      - name: discussion
        in: query
        description: Pass `discussion=false` to disable automatic extraction of product reviews.
        schema:
          type: boolean
      responses:
        '200':
          description: Successful API Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  request:
                    type: object
                    properties:
                      pageUrl:
                        type: string
                      api:
                        type: string
                      version:
                        type: integer
                  humanLanguage:
                    type: string
                  objects:
                    type: array
                    items:
                      type: object
                      properties:
                        images:
                          type: array
                          items:
                            type: object
                            properties:
                              xpath:
                                type: string
                              naturalHeight:
                                type: integer
                              width:
                                type: integer
                              diffbotUri:
                                type: string
                              title:
                                type: string
                              url:
                                type: string
                              naturalWidth:
                                type: integer
                              primary:
                                type: boolean
                              height:
                                type: integer
                        offerPrice:
                          type: string
                        productId:
                          type: string
                        diffbotUri:
                          type: string
                        upc:
                          type: string
                        productOrigin:
                          type: string
                        mpn:
                          type: string
                        gs1Code:
                          type: string
                        multipleProducts:
                          type: boolean
                        availability:
                          type: boolean
                        type:
                          type: string
                        title:
                          type: string
                        offerPriceDetails:
                          type: object
                          properties:
                            symbol:
                              type: string
                            amount:
                              type: number
                            text:
                              type: string
                        specs:
                          type: object
                          properties:
                            mfr_part_:
                              type: string
                            upc:
                              type: string
                            sku:
                              type: string
                        normalizedSpecs:
                          type: object
                          properties:
                            sku:
                              type: array
                              items:
                                type: object
                                properties:
                                  cleanLiteral:
                                    type: string
                        humanLanguage:
                          type: string
                        pageUrl:
                          type: string
                        text:
                          type: string
                        category:
                          type: string
                        sku:
                          type: string
                        brand:
                          type: string
                  type:
                    type: string
                  title:
                    type: string
              example:
                request:
                  pageUrl: https://www.microcenter.com/product/628738/evga-nvidia-geforce-rtx-3090-ftw3-ultra-triple-fan-24gb-gddr6x-pcie-40-graphics-card
                  api: product
                  version: 3
                humanLanguage: en
                objects:
                - images:
                  - xpath: /html[1]/body[1]/main[1]/article[1]/div[3]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]/a[1]/img[1]
                    naturalHeight: 200
                    width: 260
                    diffbotUri: image|3|735477840
                    title: Product Image View 2
                    url: https://90a1c75758623581b3f8-5c119c3de181c9857fcb2784776b17ef.ssl.cf2.rackcdn.com/628738_177923_01_front_thumbnail.jpg
                    naturalWidth: 200
                    primary: true
                    height: 260
                  offerPrice: $1,919.99
                  productId: '843368067137'
                  diffbotUri: product|3|-1003574237
                  upc: '843368067137'
                  productOrigin: us
                  mpn: 24G-P5-3987-KR
                  gs1Code: U.S. and Canada
                  multipleProducts: true
                  availability: true
                  type: product
                  title: EVGA NVIDIA GeForce RTX 3090 FTW3 Ultra Triple-Fan 24GB GDDR6X PCIe 4.0 Graphics Card
                  offerPriceDetails:
                    symbol: $
                    amount: 1919.99
                    text: $1,919.99
                  specs:
                    mfr_part_: 24G-P5-3987-KR
                    upc: '843368067137'
                    sku: '177923'
                  normalizedSpecs:
                    sku:
                    - cleanLiteral: '843368067137'
                  humanLanguage: en
                  pageUrl: https://www.microcenter.com/product/628738/evga-nvidia-geforce-rtx-3090-ftw3-ultra-triple-fan-24gb-gddr6x-pcie-40-graphics-card
                  text: The EVGA GeForce RTX 3090 is colossally powerful in every way imaginable, giving you a whole new tier of performance at 8K resolution. It's powered by the NVIDIA Ampere architecture, which doubles down on ray tracing and AI performance with enhanced RT Cores, Tensor Cores, and new streaming multiprocessors. Combined with the next generation of design, cooling, and overclocking with EVGA Precision X1, the EVGA GeForce RTX 3090 Series redefines the definition of ultimate performance.
                  category: Computers
                  sku: '177923'
                  brand: EVGA
                type: product
                title: EVGA NVIDIA GeForce RTX 3090 FTW3 Ultra Triple-Fan 24GB GDDR6X PCIe 4.0 Graphics Card - Micro Center
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: integer
                  error:
                    type: string
              example:
                errorCode: 500
                error: Internal Server Error
      security:
      - tokenscheme: []
components:
  securitySchemes:
    tokenscheme:
      type: apiKey
      name: token
      in: query
x-readme:
  explorer-enabled: true
  proxy-enabled: true
  samples-enabled: true