API Error Codes
General rules of interaction with API
- You should try to minimize the number of unnecessary API requests, especially for the campaign/info and campaign/stat methods.
- There is no need to constantly request the information that you can store on your side.
- There is no need to constantly request information on inactive campaigns — there is simply no point in it, the answers will always be the same.
- A reasonable number of API requests for 1 campaign is 1-2-3, up to a maximum of 10-20 per day. The reasonable number of requests for the campaign/stat method is no more than 1 per hour. Thus, a reasonable number of requests for an account (token) is hundreds, up to a maximum of 1000 per day. If you plan to make a significantly larger number of requests — we are 99% sure that you are using an algorithm that can be significantly optimized. If you are absolutely certain that you need more requests, first coordinate this with the Helpdesk.
- If you received a response with error_code=37 and error=Temporary unavailable, try again later, you should repeat the same request no earlier than 5 minutes later.
- In case of systematic violation of these rules, access to the API may be restricted.
Common Codes:
1 - no request parameters
7 - access denied
16 - unknown error
37 - temporarily unavailable, try again later
38 - no entities matching the request parameters
41 - daily API request limit has been reached more details
Creating Advertising Campaigns:
9 - incorrect campaign type
10 - invalid url
11 - less than 1 visit
12 - no instruction for internal clicks
13 - no keyword
14 - no link location
15 - no instruction for clicking on ads
17 - the search engine is not supported 36 - multiline statement is empty
42 - invalid json list string (keywords, links)
Removing Advertising Campaigns:
18 - executions awaiting confirmation
19 - not enough credits in the account
40 - executions awaiting confirmation, forced payment error
Adding Executions to Advertising Campaigns:
20 - not enough money in the account
Launching Advertising Campaigns:
21 - campaign has already been launched
Stopping Advertising Campaigns:
22 - campaign has already been stopped
Statistics of Advertising Campaigns:
23 - incorrect period
24 - no site id and category
25 - loading statistics for some ids failed with an error
Categories of Advertising Campaigns:
26 - less than 2 characters in category name
27 - a category with this name already exists
28 - the category is not found
29 - error setting unique ip for the category
Editing Advertising Campaigns:
30 - no click instruction
Geo-data of Advertising Campaigns:
31 - no country codes
Category of Advertising Campaigns:
32 - you cannot change the category