API
The UCLIQ API provides a robust interface for managing offers, schedulers, and associated data. Designed for integration
with public offer listing sites and internal systems, it allows you to automate tasks like retrieving offers, managing
payouts, and scheduling changes.
This guide explains how to use the API, including setup, endpoints, and key operations.
Overview of the UCLIQ API
The UCLIQ API offers the following capabilities:
- Access and manage offers, goals, and payouts.
- Filter offers for specific verticals, countries, or targeting groups.
- Automate scheduling of updates like payout adjustments.
- Enable integration with third-party platforms such as OfferVault.
The API supports JSON data exchange and uses secure API tokens for authentication.
Getting Started
Generate API Token
1. Log in to the UCLIQ Manager Portal.
2. Navigate to System > Control Center > Platform > API Tokens.
3. Click + Add Token.
4. Select the desired permissions:
Read-only for retrieving data.
Write for updating or creating entries.
5. Save and copy the token securely.
This token is required for all API requests.
General Rules for API Calls
Authentication: Include the token in the request header using X-AUTH-TOKEN.
HTTP Methods:
- GET for retrieving data.
- POST for creating new entries.
- PATCH for updating entries.
- DELETE for removing entries.
Archived Data: Archived offers, goals, and payouts cannot be retrieved or modified.
Offer Management
Retrieve Offer Listings
- Endpoint: GET /manager/api/customer/v1/offers
- Headers: X-AUTH-TOKEN
- Response: A list of offers, including details like title, description, payout, and targeting information.
Example response:
{
"id": 1,
"title": "Demo Offer 1",
"description": "Offer details here",
"currency": "USD",
"payout": "$10.1",
"vertical": ["Demo BizOps"],
"country": ["US"],
"denied_country": []
}
Filter Offers by Tags
- Add a parameter to filter offers by tags:
GET /manager/api/customer/v1/offers?tag[]=value
Retrieve Offer Details
- Endpoint: GET /manager/api/customer/v1/offers/{OfferId}
TIPS
Secure API Tokens: Store tokens securely and avoid sharing them publicly.
Use Filters: Narrow down data retrieval by using tags or parameters to avoid unnecessary payloads.
Test Your Integration: Use tools like Postman to test API calls before integrating them into production.
Respect Rate Limits: Ensure your requests align with the platform's rate-limiting policies.
Troubleshooting
- 401 Unauthorized: Check if the API token has the correct permissions and is included in the header.
- 400 Bad Request: Verify the request format, endpoint, and parameters.
- 500 Server Error: Retry the request or contact UCLIQ support for assistance.
Examples of Use Cases
1. Automating Offer Updates
Schedule payout changes for specific offers to optimize performance.
2. Integrating with Third-Party Platforms
Share offer details with sites like OfferVault to attract more publishers.
3. Real-Time Analytics
Retrieve offer data for internal dashboards to monitor performance.
For more details or help with API integration, refer to the full API documentation or contact UCLIQ support.