Overview

batches api batches allow you to schedule searches to run en masse you can add up to 15,000 searches (a search is simply a call to the search api) per batch (100 per batch if using the include html=true request parameter) and you can have up to 10,000 batches on your account at any one time batches can be scheduled to run monthly, weekly, daily, hourly or run manually on demand and you can get result sets in json, json lines or csv formats value serp can also call a webhook https //docs trajectdata com/valueserp/batches api/batches/webhook on your side when batches complete batch & result set expiry batches will be deleted from your account after 2 months of inactivity i e you must start https //docs trajectdata com/valueserp/batches api/batches/start a batch at least once every two months for it to remain active result sets are available for download for 14 days so your app should download and process the result set data within this 14 day window the value serp batches api allows you to create https //docs trajectdata com/valueserp/batches api/batches/create , update https //docs trajectdata com/valueserp/batches api/batches/update and delete https //docs trajectdata com/valueserp/batches api/batches/delete batches you can also use the batches api to add searches https //docs trajectdata com/valueserp/batches api/searches/create to a batch and retrieve result sets https //docs trajectdata com/valueserp/batches api/results/list the batches api is free of charge there is no charge for usage of the batches api and requests to it will not decrement your plans monthly searches quota when you start https //docs trajectdata com/valueserp/batches api/batches/start a batch the searches within the batch will be charged as per requests made via the search api https //docs trajectdata com/valueserp/search api so a batch with 200 searches in it, run once, will cost 200 credits the value serp dashboard also provides a visual editor https //app valueserp com/batches for batches and is a great way to get familiar with the key concepts in batches before creating them programmatically through the batches api batches terminology to help you get started here's some of the terminology you'll encounter whilst interacting with batches on value serp batch you can have 10,000 batches active on your account at any one time a batch holds (up to 15,000) searches a batch can have a schedule and can be set to start automatically or manually when a batch is started, its searches are run through the value serp search api and a result set is generated batches can notify you when a new result set is available via email or webhook post value serp will automatically delete batches that have not been run for 2 months if you start multiple batches they are queued and processed sequentially to control the order of processing you can assign each batch a priority higher priority batches are started before lower priority ones learn more about priorities https //docs trajectdata com/valueserp/batches api/priorities search a batch can contain up to 15,000 searches (100 when adding searches with include html=true ) a search is simply a collection of parameters relating to an individual request to the search api result set when batches complete (that is, when all of their searches have been evaluated) a result set is generated you can use the batches api to retrieve result sets and ingest them into your app value serp retains result sets for 14 days so you should download your result set data within this 14 day window value serp provides api's to retrieve result sets in json and csv formats next steps create batch https //docs trajectdata com/valueserp/batches api/batches/create adding searches to a batch https //docs trajectdata com/valueserp/batches api/searches/create list result sets https //docs trajectdata com/valueserp/batches api/results/list