Get PDP Question Set

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

import requests

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

response = requests.get(url)

print(response.text)

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

}

HttpResponse<String> response = Unirest.get("https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public")
  .asString();

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

import requests

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

response = requests.get(url)

print(response.text)

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

}

HttpResponse<String> response = Unirest.get("https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public")
  .asString();

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

organizationId

string

required

ID of the organization that owns the question set.

url

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.

organizationId

string

required

ID of the organization that owns the question set.

url

string

required

The canonicalized PDP URL the question set belongs to.

productTitle

string

Title of the product, or null when unknown.

requests

integer

Number of times the question set has been requested.

createdAt

string

required

ISO 8601 timestamp of when the question set was created.

questions

object[]

required

The suggested questions, ordered by rank.

Show PdpQuestionDto

string

required

ID of the question.

text

string

required

The question text.

rank

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.

Message Events Introduction

​Request

​Response

​Examples

​Success response

​Error response

Path Parameters

Query Parameters

Response

Request

Response

Examples

Success response

Error response