Get PDP Question Set

curl --request GET \
  --url https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public

const options = {method: 'GET'};

fetch('https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{}

GET

knowledge

pdp-questions

{organizationId}

public

Get PDP Question Set

curl --request GET \
  --url https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public

const options = {method: 'GET'};

fetch('https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{}

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.

This is the only public endpoint in the REST API. It does not require the x-api-key header.

Request

string

required

ID of the organization that owns the question set.

string

required

The product detail page URL. The server canonicalizes the URL before matching.

Response

The response is a PdpQuestionsSetDto.

string

required

ID of the question set.

string

required

ID of the organization that owns the question set.

string

required

The canonicalized PDP URL the question set belongs to.

string

Title of the product, or null when unknown.

integer

Number of times the question set has been requested.

string

required

ISO 8601 timestamp of when the question set was created.

object[]

required

The suggested questions, ordered by rank.

Show PdpQuestionDto

string

required

ID of the question.

string

required

The question text.

integer

required

Priority of the question. 1 is the highest priority.

Examples

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"

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();

Success response

{
  "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

{
  "message": "No question set found for this URL"
}

Path Parameters

organizationId

string

required

Query Parameters

url

string

required

Response

200 - application/json

The response is of type object.

​Request

​Response

​Examples

​Success response

​Error response

Path Parameters

Query Parameters

Response

Request

Response

Examples

Success response

Error response