> ## Documentation Index > Fetch the complete documentation index at: https://docs.orbbit.co/llms.txt > Use this file to discover all available pages before exploring further. # Search Branded Foods > Search packaged foods by name, brand, category, barcode, or an ingredient they contain; every filter is optional and they combine as AND. Requires the `search-branded-foods` scope. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/branded-foods openapi: 3.1.0 info: title: Orbbit Data API version: '1.0' description: >- Commodity prices, packaged-food labels, and online store catalogs over one read-only REST API. servers: - url: https://api.orbbit.co description: Production security: - bearer: [] tags: - name: Commodities - name: Branded Food - name: Shopify paths: /v1/branded-foods: get: tags: - Branded Food summary: Search Branded Foods description: >- Search packaged foods by name, brand, category, barcode, or an ingredient they contain; every filter is optional and they combine as AND. Requires the `search-branded-foods` scope. operationId: BrandedFoodsController_search parameters: - name: description required: false in: query description: >- Product name contains this, ignoring case; empty or absent means no filter schema: type: string - name: brand required: false in: query description: Brand owner, brand name, or sub-brand contains this, ignoring case schema: type: string - name: category required: false in: query description: >- Exact category, ignoring case — see GET /v1/branded-foods/categories for the accepted values schema: type: string - name: upc required: false in: query description: Exact barcode (GTIN/UPC) schema: type: string - name: ingredient required: false in: query description: Ingredient statement contains this, ignoring case schema: type: string - name: limit required: false in: query description: Page size, 1–200; defaults to 50 schema: type: integer minimum: 1 maximum: 200 default: 50 - name: cursor required: false in: query description: The next_cursor of the previous page; absent means the first page schema: type: string responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/SearchBrandedFoodsResponseDto' example: data: - id: data_branded_food_01k2x7f3m9q8r4t6v0w2y5z8ab fdc_id: 2345678 description: SHARP CHEDDAR CHEESE short_description: null brand_owner: Kraft Heinz Foods Company brand_name: CRACKER BARREL subbrand_name: null category: Cheese gpc_class_code: 10000013 upc: '021000601366' package_weight: 7 oz/198 g serving_size: 28 serving_size_unit: GRM serving_size_unit_normalized: g household_serving_text: 1 oz preparation_state_code: null market_country: United States market_country_normalized: US trade_channels: - NO_TRADE_CHANNEL ingredients: >- CHEDDAR CHEESE (PASTEURIZED MILK, CHEESE CULTURE, SALT, ENZYMES, ANNATTO (COLOR)). nutrition: calories: 110 fat: 9 saturated_fat: 6 trans_fat: 0 cholesterol: 30 sodium: 180 carbohydrates: 0 fiber: 0 sugars: 0 added_sugar: 0 protein: 7 calcium: 200 iron: 0 potassium: 20 vitamin_d: 0 nutrients: [] attributes: [] caffeine_statement: null footnote: null data_source: GDSN published_on: '2024-10-31' available_on: '2024-10-31' modified_on: '2024-09-12' discontinued_on: null source: usda-fdc fetched_at: '2026-08-23T03:29:33.000Z' next_cursor: data_branded_food_01k2x7f3m9q8r4t6v0w2y5z8ab '400': description: The request was malformed content: application/json: schema: $ref: '#/components/schemas/PublicApiErrorDto' example: error: type: invalid_request message: 'Unknown series: butter-spot' '401': description: The API key is missing, malformed, unknown, or revoked content: application/json: schema: $ref: '#/components/schemas/PublicApiErrorDto' example: error: type: unauthorized message: 'Missing or malformed Authorization: Bearer header' '403': description: The key is valid but not scoped to this endpoint content: application/json: schema: $ref: '#/components/schemas/PublicApiErrorDto' example: error: type: forbidden message: This key is not scoped to search-branded-foods security: - bearer: [] components: schemas: SearchBrandedFoodsResponseDto: type: object properties: data: type: array items: type: object properties: id: type: string fdc_id: type: number description: type: string short_description: anyOf: - type: string - type: 'null' brand_owner: anyOf: - type: string - type: 'null' brand_name: anyOf: - type: string - type: 'null' subbrand_name: anyOf: - type: string - type: 'null' category: anyOf: - type: string - type: 'null' gpc_class_code: anyOf: - type: number - type: 'null' upc: anyOf: - type: string - type: 'null' package_weight: anyOf: - type: string - type: 'null' serving_size: anyOf: - type: number - type: 'null' serving_size_unit: anyOf: - type: string - type: 'null' serving_size_unit_normalized: anyOf: - type: string - type: 'null' household_serving_text: anyOf: - type: string - type: 'null' preparation_state_code: anyOf: - type: string - type: 'null' market_country: anyOf: - type: string - type: 'null' market_country_normalized: anyOf: - type: string - type: 'null' trade_channels: anyOf: - type: array items: {} - type: 'null' ingredients: anyOf: - type: string - type: 'null' nutrition: type: object properties: calories: anyOf: - type: number - type: 'null' fat: anyOf: - type: number - type: 'null' saturated_fat: anyOf: - type: number - type: 'null' trans_fat: anyOf: - type: number - type: 'null' cholesterol: anyOf: - type: number - type: 'null' sodium: anyOf: - type: number - type: 'null' carbohydrates: anyOf: - type: number - type: 'null' fiber: anyOf: - type: number - type: 'null' sugars: anyOf: - type: number - type: 'null' added_sugar: anyOf: - type: number - type: 'null' protein: anyOf: - type: number - type: 'null' calcium: anyOf: - type: number - type: 'null' iron: anyOf: - type: number - type: 'null' potassium: anyOf: - type: number - type: 'null' vitamin_d: anyOf: - type: number - type: 'null' required: - calories - fat - saturated_fat - trans_fat - cholesterol - sodium - carbohydrates - fiber - sugars - added_sugar - protein - calcium - iron - potassium - vitamin_d nutrients: anyOf: - type: array items: {} - type: 'null' attributes: anyOf: - type: array items: {} - type: 'null' caffeine_statement: anyOf: - type: string - type: 'null' footnote: anyOf: - type: string - type: 'null' data_source: anyOf: - type: string - type: 'null' published_on: anyOf: - type: string - type: 'null' available_on: anyOf: - type: string - type: 'null' modified_on: anyOf: - type: string - type: 'null' discontinued_on: anyOf: - type: string - type: 'null' source: type: string fetched_at: anyOf: - type: string - type: 'null' required: - id - fdc_id - description - short_description - brand_owner - brand_name - subbrand_name - category - gpc_class_code - upc - package_weight - serving_size - serving_size_unit - serving_size_unit_normalized - household_serving_text - preparation_state_code - market_country - market_country_normalized - trade_channels - ingredients - nutrition - nutrients - attributes - caffeine_statement - footnote - data_source - published_on - available_on - modified_on - discontinued_on - source - fetched_at next_cursor: anyOf: - type: string - type: 'null' required: - data - next_cursor PublicApiErrorDto: type: object properties: error: type: object properties: type: type: string message: type: string required: - type - message required: - error securitySchemes: bearer: type: http scheme: bearer description: Your API key, which starts with `orbbit_data_`. ````