> ## 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.

# Get a Store

> One store in full: profile, Common Crawl rank, and category mix.

Requires the `get-store` scope.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/stores/{id}
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/stores/{id}:
    get:
      tags:
        - Shopify
      summary: Get a Store
      description: |-
        One store in full: profile, Common Crawl rank, and category mix.

        Requires the `get-store` scope.
      operationId: StoresController_getStore
      parameters:
        - name: id
          required: true
          in: path
          description: A store id as returned by GET /v1/stores
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetStoreResponseDto'
              example:
                data:
                  id: shopify_store_01k3a1b2c3d4e5f6g7h8j9k0mn
                  domain: example-coffee.com
                  name: Example Coffee Co.
                  country: US
                  industry: cpg
                  category: coffee_and_tea
                  product_count: 84
                  variant_count: 212
                  min_price: 7.5
                  median_price: 18
                  max_price: 129
                  crawled_at: '2026-08-31T00:00:00.000Z'
                  source: shopify
                  shopify_domain: example-coffee.myshopify.com
                  description: Small-batch coffee roasted in Portland.
                  city: Portland
                  province: Oregon
                  currency: USD
                  published_products_count: 84
                  common_crawl:
                    release: CC-MAIN-2026-33
                    harmonic_rank: 1843221
                    host_count: 3
                  categories:
                    - category: coffee_and_tea
                      product_count: 71
                      share: 0.845
                    - category: soft_drinks_and_refreshments
                      product_count: 13
                      share: 0.155
        '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 get-store
        '404':
          description: No record has this ID
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiErrorDto'
              example:
                error:
                  type: not_found
                  message: >-
                    Unknown branded food:
                    data_branded_food_01k0000000000000000000000
      security:
        - bearer: []
components:
  schemas:
    GetStoreResponseDto:
      type: object
      properties:
        data:
          type: object
          properties:
            id:
              type: string
            domain:
              type: string
            name:
              anyOf:
                - type: string
                - type: 'null'
            country:
              anyOf:
                - type: string
                - type: 'null'
            industry:
              anyOf:
                - type: string
                - type: 'null'
            category:
              anyOf:
                - type: string
                - type: 'null'
            product_count:
              anyOf:
                - type: number
                - type: 'null'
            variant_count:
              anyOf:
                - type: number
                - type: 'null'
            min_price:
              anyOf:
                - type: number
                - type: 'null'
            median_price:
              anyOf:
                - type: number
                - type: 'null'
            max_price:
              anyOf:
                - type: number
                - type: 'null'
            crawled_at:
              anyOf:
                - type: string
                - type: 'null'
            source:
              type: string
            shopify_domain:
              anyOf:
                - type: string
                - type: 'null'
            description:
              anyOf:
                - type: string
                - type: 'null'
            city:
              anyOf:
                - type: string
                - type: 'null'
            province:
              anyOf:
                - type: string
                - type: 'null'
            currency:
              anyOf:
                - type: string
                - type: 'null'
            published_products_count:
              anyOf:
                - type: number
                - type: 'null'
            common_crawl:
              type: object
              properties:
                release:
                  anyOf:
                    - type: string
                    - type: 'null'
                harmonic_rank:
                  anyOf:
                    - type: number
                    - type: 'null'
                host_count:
                  anyOf:
                    - type: number
                    - type: 'null'
              required:
                - release
                - harmonic_rank
                - host_count
            categories:
              type: array
              items:
                type: object
                properties:
                  category:
                    type: string
                  product_count:
                    type: number
                  share:
                    type: number
                required:
                  - category
                  - product_count
                  - share
          required:
            - id
            - domain
            - name
            - country
            - industry
            - category
            - product_count
            - variant_count
            - min_price
            - median_price
            - max_price
            - crawled_at
            - source
            - shopify_domain
            - description
            - city
            - province
            - currency
            - published_products_count
            - common_crawl
            - categories
      required:
        - data
    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_`.

````