SelSup Developers

Public API · API Reference

Competitors

Endpoints for Competitors, including exact routes, parameters, request bodies, and expandable response schemas.

4 endpoints/api/competitorStableMachine-readable description ↗
{ }

This page is backed by an editable standalone contract. Validate write operations with test data before production use.

/api/competitor

Ready-to-use workflows

Ready-to-use workflows

01

Start using Competitors

Use a dedicated API token and validate read operations with test data first.

  1. Keep the token server-side and send it in the Authorization header.
  2. Check required parameters and expand the request or response schema.
  3. Handle the HTTP status and the stable error field in application errors.

Data model

Data structures

Models are listed once here and can also be expanded directly from the endpoints that use them.

Competitor6 fields
idinteger · int64

Id.

read-only
modelIdinteger · int64

Model Id.

servicestring

Service.

Required
urlstring

Url.

Required
serviceIdstring

Service Id.

clientIdinteger · int64

Client Id.

read-only

Error contract

How application errors are returned

The error code is identical in every locale, while the user-facing message is translated by the server. Build application logic around error and use localMessage for display only.

error

Stable machine-readable code for integration logic.

localMessage

Display-ready message in the API token user's language.

params

Values interpolated by the server into the localized message template.

localMessage uses the lang field of the user who owns the API token. The documentation language and Accept-Language header do not change it; Russian is used when the user has no language configured.

RUUser locale is ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
ENUser locale is en
{
  "error": "error_brand_already_exists",
  "localMessage": "Brand Base already exists",
  "params": {
    "name": "Base"
  }
}

Endpoints

Endpoints

PUT

Update

/api/competitor/{competitorId}
Token with write access

Update using PUT /api/competitor/{competitorId}.

Path parameters

FieldTypeRequiredDescription
competitorId integer · int64 Yes Competitor Id.

Request body

application/json
Object fieldsCompetitor
FieldTypeRequiredDescription
id integer · int64 No Id.
modelId integer · int64 No Model Id.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Yes Service.
url string Yes Url.
serviceId string No Service Id.
clientId integer · int64 No Client Id.
curl --request PUT 'https://api.selsup.ru/api/competitor/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "service": "NONE",
  "url": "https://example.com",
  "id": 1001,
  "modelId": 1001,
  "serviceId": "string",
  "clientId": 1001
}'

Success response

200

The response has no body.

Errors8

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_competitor_id_required
Competitor id is required

Endpoint-specific error. Use the stable error_competitor_id_required code in application logic; localMessage contains the translation shown above.

400error_competitor_required
Competitor is required

Endpoint-specific error. Use the stable error_competitor_required code in application logic; localMessage contains the translation shown above.

400error_competitor_service_required
Competitor service is required

Endpoint-specific error. Use the stable error_competitor_service_required code in application logic; localMessage contains the translation shown above.

400error_competitor_url_required
Competitor URL is required

Endpoint-specific error. Use the stable error_competitor_url_required code in application logic; localMessage contains the translation shown above.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

DELETE

Delete

/api/competitor/{competitorId}
Token with write access

Delete using DELETE /api/competitor/{competitorId}.

Path parameters

FieldTypeRequiredDescription
competitorId integer · int64 Yes Competitor Id.
curl --request DELETE 'https://api.selsup.ru/api/competitor/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200

The response has no body.

Errors5

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_competitor_id_required
Competitor id is required

Endpoint-specific error. Use the stable error_competitor_id_required code in application logic; localMessage contains the translation shown above.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

GET

Get All

/api/competitor/{modelId}
Token with read access

Get All using GET /api/competitor/{modelId}.

Path parameters

FieldTypeRequiredDescription
modelId integer · int64 Yes Model Id.
curl --request GET 'https://api.selsup.ru/api/competitor/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure Competitor[]
FieldTypeRequiredDescription
id integer · int64 No Id.
modelId integer · int64 No Model Id.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Yes Service.
url string Yes Url.
serviceId string No Service Id.
clientId integer · int64 No Client Id.
[
  "string"
]
Errors5

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_model_id_required
Model id is required

Endpoint-specific error. Use the stable error_model_id_required code in application logic; localMessage contains the translation shown above.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

POST

Create

/api/competitor/{modelId}
Token with write access

Create using POST /api/competitor/{modelId}.

Path parameters

FieldTypeRequiredDescription
modelId integer · int64 Yes Model Id.

Request body

application/json
Object fieldsCompetitor
FieldTypeRequiredDescription
id integer · int64 No Id.
modelId integer · int64 No Model Id.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Yes Service.
url string Yes Url.
serviceId string No Service Id.
clientId integer · int64 No Client Id.
curl --request POST 'https://api.selsup.ru/api/competitor/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "service": "NONE",
  "url": "https://example.com",
  "id": 1001,
  "modelId": 1001,
  "serviceId": "string",
  "clientId": 1001
}'

Success response

200
Object fields Competitor
FieldTypeRequiredDescription
id integer · int64 No Id.
modelId integer · int64 No Model Id.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Yes Service.
url string Yes Url.
serviceId string No Service Id.
clientId integer · int64 No Client Id.
{
  "service": "NONE",
  "url": "https://example.com",
  "id": 1001,
  "modelId": 1001,
  "serviceId": "string",
  "clientId": 1001
}
Errors7

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_competitor_required
Competitor is required

Endpoint-specific error. Use the stable error_competitor_required code in application logic; localMessage contains the translation shown above.

400error_competitor_service_required
Competitor service is required

Endpoint-specific error. Use the stable error_competitor_service_required code in application logic; localMessage contains the translation shown above.

400error_competitor_url_required
Competitor URL is required

Endpoint-specific error. Use the stable error_competitor_url_required code in application logic; localMessage contains the translation shown above.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

Authorization

Token for test requests

The token stays in this browser's localStorage and is sent only in the Authorization header of requests to api.selsup.ru.

Try it

Real request parameters

Live API response

Send a request to see the SelSup response.