Quick Start

This guide will help you get started with Parsewise API in minutes. You'll learn how to get a token and send requests to the AI chat.

Step 1: Get API Token

1. Log in to Parsewise admin panel
2. Select a shop from the sidebar
3. Go to API section (shield icon)
4. Click Create Token
5. Enter token name and select a role:
   - Viewer — access to chat and search
   - Editor — plus product management
6. Copy the token — it's shown only once!

Step 2: Send Your First Request

Use the token for request authorization. Add it to the header Authorization:

curl -X POST "https://api.parsewise.ru/v1/chat" \
  -H "Authorization: Bearer pw_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello! What products do you have?"}'

Step 3: Get Response

A successful response looks like this:
{
  "chat_id": 123,
  "message_id": 456,
  "response": "Hello! We have great running shoes...",
  "product_ids": [12, 45, 78]
}
FieldDescription
chat_idChat ID to continue the conversation
message_idMessage ID
responseAI text response
product_idsArray of recommended product IDs

Step 4: Continue the Dialog

To make AI remember context, pass `chat_id` from the previous response:
curl -X POST "https://api.parsewise.ru/v1/chat" \
  -H "Authorization: Bearer pw_your_token" \
  -H "Content-Type: application/json" \
  -d '{"message": "Something cheaper?", "chat_id": 123}'

Step 5: Get Product Information

Use product IDs from the response to get full information:
curl "https://api.parsewise.ru/v1/products?ids=12,45,78" \
  -H "Authorization: Bearer pw_your_token"

What's Next?

Great, now you have an API client and made your first request. Here are some useful links:

Was this page helpful?