Find Products

Find products by details returns a list of products that matched the query parameter. The value can match with the product’s name, or description. Results can be narrowed with the types and owners filters, which take the values the results publish in type and owner. Use Filter Values to list the values each one accepts. Once you have the IDs, you can use them to filter your search queries with an Entity query filter.

curl -X POST 'https://api.bigdata.com/v1/knowledge-graph/products' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: <your-api-key>' \
  --data '{
  "query": "iPhone",
  "owners": ["Apple Inc."]
}'

from dotenv import load_dotenv
from bigdata_client import Bigdata
import os

load_dotenv()

# Initialize the Bigdata API
username = os.environ.get("BIGDATA_USERNAME")
password = os.environ.get("BIGDATA_PASSWORD")
bigdata = Bigdata(username, password)

results = bigdata.knowledge_graph.find_products("iPhone")

for product in results:
    print(f"Entity ID: {product.id}")
    print(f"Product Name: {product.name}")
    print(f"Description: {product.description}\n")

Output:

{
  "results": [
    {
      "id": "7373D4",
      "name": "iPhone",
      "description": "iPhone is a line of smartphones designed and marketed by Apple Inc. It runs Apple's iOS mobile operating system.The first generation iPhone, aka Iphone 2G was revealed on January 9, 2007.",
      "type": "Mobile Phones",
      "owner": "Apple Inc."
    },
...
  ],
  "metadata": {
    "request_id": "2a25111e-0043-4fe2-946e-668aa5af928a",
    "timestamp": "2026-07-02T13:24:45.163695+00:00"
  }
}

Entity ID: 7373D4
Product Name: iPhone
Description: iPhone is a line of smartphones designed and marketed by Apple Inc. It runs Apple's iOS mobile operating system.The first generation iPhone, aka Iphone 2G was revealed on January 9, 2007.

Entity ID: 990836
Product Name: iPhone 16
Description: iPhone 16 is a mobile phone developed by Apple Inc. Rumors surrounding the product started around January 1, 2024, but was officially launched on September 09, 2024.

...

Getting Started

Research Service

Search Service

Monitors

Upload proprietary content

Knowledge Graph

Watchlist

Troubleshooting