Create up to 1000 Keyword requests, that are asynchronous by default, and receive a list of incomplete Keyword objects, where their IDs can be used to download the respective full data, later.
Click here to check out a JSON response example. ABOUT THE CREDIT SYSTEM
The base value for every Keyword request is 3 CREDITS, but this value can change based on priority:
LOW PRIORITY = multiplies costs by 1
NORMAL PRIORITY = multiplies costs by 1
REALTIME PRIORITY = multiplies costs by 2
INSTANT PRIORITY = multiplies costs by 5
NOTE 1: Every Keyword request will have its callback called separately. NOTE 2: To use the custom region search, do not set the region parameter, otherwise the region will be used by default.
Responses
400
Bad input parameter. The error message should indicate which parameter is wrong and why. We use this error to indicate some request parameters did not pass the validation test. Wrong region, wrong search engine, etc. This error means your request is wrong in some way, retrying the same request will probably not fix it.
402
Credit limit exceeded or insufficient credits. The user exceeded their available hourly or daily requests and should try again later. Or the user account has no credits left to complete the request.
403
Bad API Key. Your key may have been mistyped or you do not have access to our API. Retrying the request will not solve the issue.
429
Too many requests or connections. Your server made too many requests or opened too many connections. Please slow it down and close the unused connections. Enabling the 'keep-alive' mechanism may help to reuse connections.
500
Internal server error. This is a generic error for some unexpected action that might happen at our side. This error should never appear to you, but if it does, you should retry later and contact us if it persists.
502
Internal server error due a database timeout. This error should never appear to you, but if it does, you should retry later and contact us if it persists.
504
Internal server error similar to error 502. This error should never appear to you, but if it does, you should retry later and contact us if it persists.
Updated 2 months ago
Language
NodeShellRubyJavaScriptObjective-C
Credentials
Query
Query
API Request
Examples
Response
Click Try It! to start a request and see the response here! Or choose an example: