Search API

Search API allows you to perform semantic product search. AI understands the meaning of the query and finds relevant products even with typos and synonyms.

POST/api/v1/search

Semantic Search

Performs AI product search by text query. Unlike regular keyword search, semantic search understands the meaning of the query.

Request Parameters

Name
query
Type
string
Description
Search query (max 1000 characters)
Name
limit
Type
integer
Description
Maximum number of results (1-50, default: 10)
Name
include_hidden
Type
boolean
Description
Include hidden products (default: false)

Response

Name
products
Type
array
Description
Array of found products
Name
query
Type
string
Description
Original search query
Name
total
Type
integer
Description
Number of products found

Request

curl -X POST "https://api.parsewise.ru/v1/search" \
  -H "Authorization: Bearer pw_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "comfortable running shoes under $100",
    "limit": 5
  }'

Response

{
  "products": [
    {
      "id": 12,
      "title": "Nike Air Zoom Pegasus",
      "description": "Lightweight running shoes...",
      "price": "$89.90",
      "media": [
        {"url": "https://...", "type": "image"}
      ]
    },
    {
      "id": 45,
      "title": "Adidas Ultraboost",
      "description": "Comfort for long runs...",
      "price": "$95.00",
      "media": [
        {"url": "https://...", "type": "image"}
      ]
    }
  ],
  "query": "comfortable running shoes under $100",
  "total": 2
}

GET/api/v1/products

Get Products

Returns a list of products. You can get specific products by ID or the entire catalog with pagination.

Query Parameters

Name
ids
Type
string
Description
Product IDs comma-separated (e.g.: `1,2,3`)
Name
limit
Type
integer
Description
Number of products (1-100, default: 50)
Name
offset
Type
integer
Description
Offset for pagination (default: 0)

Request

# Get products by ID
curl "https://api.parsewise.ru/v1/products?ids=12,45,78" \
  -H "Authorization: Bearer pw_your_token"

# Get all products with pagination
curl "https://api.parsewise.ru/v1/products?limit=20&offset=0" \
  -H "Authorization: Bearer pw_your_token"

Response

[
  {
    "id": 12,
    "title": "Nike Air Zoom Pegasus",
    "description": "Lightweight running shoes...",
    "price": "$89.90",
    "hidden": false,
    "media": [
      {"url": "https://...", "type": "image"}
    ]
  }
]

GET/api/v1/products/{product_id}

Get Single Product

Returns information about a specific product by its ID.

URL Parameters

Name
product_id
Type
integer
Description
Product ID

Request

curl "https://api.parsewise.ru/v1/products/12" \
  -H "Authorization: Bearer pw_your_token"

Response

{
  "id": 12,
  "title": "Nike Air Zoom Pegasus",
  "description": "Lightweight running shoes with responsive cushioning...",
  "price": "$89.90",
  "hidden": false,
  "media": [
    {"url": "https://...", "type": "image"},
    {"url": "https://...", "type": "image"}
  ]
}

Comparison with Regular Search

Criteria	Regular Search	Semantic Search
Typos	Doesn't find	Finds
Synonyms	Doesn't understand	Understands
Natural language	Not supported	Full support
Context	Ignores	Considers

Semantic search is especially effective for natural language queries, such as: "something for running in the rain" or "birthday gift for mom".