API access

Sooqly has a versioned HTTP API under sooqly.ae/api/v1; partners use it with an API key that we issue.

Getting a key

Ask through the contact form and say what you want to build. We issue keys; there is no self-service yet. You see the key once: store it safely. Send it in the X-API-Key header.

Rate limits

• With a key: the limit of your key's tier, 300, 600, 1,500, 3,000, 6,000 requests per minute.
• Without a key: 60 requests per minute per IP address.

Above the limit we answer 429 with a Retry-After header.

Scopes

A key can only call what its scopes allow:

• catalog:read
• search:read
• deals:read
• assistant:invoke
• visual-search:invoke
• data:price-history
• data:market-index

The data API

The price history and UAE Price Index endpoints are paid per request:

• 1,000 requests per month are included;
• above that, AED 50.00 per thousand requests, invoiced monthly.

Documentation

The API follows one OpenAPI description, with camelCase fields, cursor pagination and one error format. Ask us for it with your key request.