> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yourhomie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get PDP Question Set

> Fetch the public set of suggested product questions for a product page.

Fetch the suggested questions for a specific product detail page (PDP). This endpoint is public and CORS-enabled, so you can call it directly from the browser on a storefront.

<Info>
  This is the only public endpoint in the REST API. It does **not** require the `x-api-key` header.
</Info>

## Request

<ParamField path="organizationId" type="string" required>
  ID of the organization that owns the question set.
</ParamField>

<ParamField query="url" type="string" required>
  The product detail page URL. The server canonicalizes the URL before matching.
</ParamField>

## Response

The response is a `PdpQuestionsSetDto`.

<ResponseField name="id" type="string" required>
  ID of the question set.
</ResponseField>

<ResponseField name="organizationId" type="string" required>
  ID of the organization that owns the question set.
</ResponseField>

<ResponseField name="url" type="string" required>
  The canonicalized PDP URL the question set belongs to.
</ResponseField>

<ResponseField name="productTitle" type="string">
  Title of the product, or `null` when unknown.
</ResponseField>

<ResponseField name="requests" type="integer">
  Number of times the question set has been requested.
</ResponseField>

<ResponseField name="createdAt" type="string" required>
  ISO 8601 timestamp of when the question set was created.
</ResponseField>

<ResponseField name="questions" type="object[]" required>
  The suggested questions, ordered by rank.

  <Expandable title="PdpQuestionDto">
    <ResponseField name="id" type="string" required>
      ID of the question.
    </ResponseField>

    <ResponseField name="text" type="string" required>
      The question text.
    </ResponseField>

    <ResponseField name="rank" type="integer" required>
      Priority of the question. `1` is the highest priority.
    </ResponseField>
  </Expandable>
</ResponseField>

## Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -G https://api.yourhomie.ai/v1/knowledge/pdp-questions/11111111-2222-3333-4444-555555555555/public \
    --data-urlencode "url=https://shop.example.com/p/produkt-abc-12345"
  ```

  ```javascript JavaScript (fetch) theme={null}
  const organizationId = "11111111-2222-3333-4444-555555555555";
  const pdpUrl = "https://shop.example.com/p/produkt-abc-12345";

  const res = await fetch(
    `https://api.yourhomie.ai/v1/knowledge/pdp-questions/${organizationId}/public?url=${encodeURIComponent(pdpUrl)}`,
  );

  const questionSet = await res.json();
  ```
</CodeGroup>

### Success response

```json theme={null}
{
  "id": "49113e90-6e30-42d1-8c02-a697c6b47f01",
  "organizationId": "11111111-2222-3333-4444-555555555555",
  "productTitle": null,
  "url": "https://shop.example.com/p/produkt-abc-12345",
  "requests": 12,
  "createdAt": "2025-10-16T11:44:41.140Z",
  "questions": [
    {
      "id": "f5ae1f7e-9680-497a-b2d6-afbbb1203408",
      "text": "What are the dimensions of the product?",
      "rank": 1
    },
    {
      "id": "8e0ab7fe-0e23-4efe-835b-8106f9cca314",
      "text": "What material is it made of?",
      "rank": 2
    }
  ]
}
```

### Error response

```json theme={null}
{
  "message": "No question set found for this URL"
}
```


## OpenAPI

````yaml api-reference/openapi.json GET /v1/knowledge/pdp-questions/{organizationId}/public
openapi: 3.0.0
info:
  title: homie AI API
  description: The homie AI API description
  version: 0.0.1
  contact: {}
servers:
  - url: https://api.yourhomie.ai
    description: Production server
security: []
tags:
  - name: Chat
    description: ''
  - name: Knowledge
    description: Public, CORS-enabled endpoints for PDP question sets
paths:
  /v1/knowledge/pdp-questions/{organizationId}/public:
    get:
      tags:
        - PDP Questions
      summary: Get PDP Question Set
      operationId: KnowledgePdpQuestionsController_publicGetQuestions_v1
      parameters:
        - name: organizationId
          required: true
          in: path
          schema:
            type: string
        - name: url
          required: true
          in: query
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object

````