Search Campaigns

Why Search Campaigns?

If you would like to review the properties of a campaign, the Kevel API enables you to perform a search on a campaign's name and then have a list of properties returned to you for that campaign. The result will be a JSON list of all campaigns for which the value of campaignName is contained in the name property (aka wildcard search).



This endpoint accepts a string key/value pair as its payload instead of a JSON object.

API Syntax

When using the Search Campaigns API endpoint, it is important to understand the syntax required to make the request. Because the Kevel API is a RESTful API, there is a specific request format that must be followed to ensure the endpoint can process the request. The format is:



  • POST - the type of API request being made.
  • - the URL for the request.
  • v1 - the API version.
  • campaign - the API endpoint being called.
  • search - the request being made to the endpoint.

Request Syntax

When making a request to this endpoint, please keep the following rules in mind:

  • You will need to pass in a single string with a key of campaignName. The value should be the term you want to search for.
  • To search for a single, exact word: "campaignName=Nike"
  • To search for multiple words, use url encoding: campaignName=20th%20Century%20Fox
  • To search for a substring, url encode the character % as a prefix and suffix. For example, to find all campaigns with names that contain the string bank, you should search for %25bank%25.
  • If nothing is found, you will see items is blank, like "Items": [].



If you are searching for a campaign name that contains multiple words, you must URL encode the term you are searching for. For example, in curl you can use the --data-urlencode flag and search for "campaignName=Nike Shoes"