Adding Parts of the Directory Search Form to My Own Website

Adding Parts of the Directory Search Form to My Own Website

The most common means of integrating your eSpeakers Whitelabeled directory in your website is via a  simple link . However, there may be places where you want to send your customers over to your directory with some search results already chosen.  

These instructions are technical and intended for webmasters.

Use the following code to create a marketplace search box. 

Your web designer will still need to do work to style this and to fit in within your site. 

  1. <form action=" http://www.espeakers.com/s/xxxx/speaker/search ">
  2.    <input type="hidden" name="resume_search" value="0" />
  3.    <input type="text" name="searchtags[]" />
  4.    <button type="submit">Search!</button>
  5. </form>

xxxx should be replaced by your unique code. 

See below for an example of using this as a complete URI rather than a form. You can use javascript on your page to create any type of forms or links you wish. 


Use the following URL to link to search results for a specific topic id: 

https://www.espeakers.com/s/xxxx/v3/search/setup/%7B%22topic_id%22%3A%22123%22%7D

This is the URI encoded version of 

https://www.espeakers.com/s/xxxx/v3/search/setup/{ "topic_id":"123"}

xxxx should be replaced by your unique code, and  123 should be replace by the id number of the topic you're searching for. Everything after  /setup/ is URI-encoded JSON. 

See the section below on SITELISTS for instructions on seeing a list of available topics and their id numbers. 


Use the following URL to link to search results for a free-form keyword: 

  https://www.espeakers.com/s/xxxx/speaker/search?searchtags%5B%5D%3DKEYWORD%0A

This is the URI encoded version of 

https://www.espeakers.com/s/xxxx/speaker/search?searchtags []=KEYWORD

xxxx should be replaced by your unique code, and  KEYWORD should be replaced with the word or phrase you want to search for. Everything after the  ? should be replaced by the URI-encoded version of  searchtags[]=KEYWORD


Use the following URL to link to search results for common industry awards 

https://www.espeakers.com/s/xxxx/v3/search/setup/%7B%22awards%22%3A%22csp%22%7D

This is the URI encoded version of 

https://www.espeakers.com/s/xxxx/v3/search/setup/{ "awards":"csp"}

Everything after  /setup/ is URI-encoded JSON.  xxxx should be replaced by your unique code and  csp can be replaced with one of these values: 

  • capshof CAPS Canada - Hall of Fame 
  • cpae NSA - CPAE Speaker Hall of FameĀ® 
  • csp CSP Certified Speaking Professionalā„¢ 
  • fpsa PSA United Kingdom - Fellow 
  • icfacc ICF - ACC Associate Certified Coach 
  • icdpcc ICF - PCC Professional Certified Coach 
  • icfmcc ICF - MCC Master Certified Coach 
  • nsaa PSA Australia - Hall of Fame 
  • dtm Toastmasters - DTM Distinguished Toastmaster 
  • cspgsf GSF - Global Speaking Fellow 
  • mpiok MPI - chapter speaker 
  • cspnsaa PSA Australia - CSP Certified Speaking Professional 
  • sa_hof PSA Southern Africa - Hall of Fame 
  • sa_founder PSA Southern Africa - Founders Award 
  • cic_cmp CMP - Certified Meeting Professional 
  • uk_hof PSA United Kingdom - Hall of Fame 
  • tedx TEDx Speaker


Getting values to build a select for topic, speakers, or industry experience

If you want to show a dropdown list of available topics, speakers, or industry experience as a part (or all) of a form, you can get the data in JSON form at this url: 

  https://www.espeakers.com/s/xxx/index/sitelists

This returns a json object which is easy to consume with javascript to build  select elements. The data looks like: 

  1. {  
  2.  "industries":{  
  3.     "1":{  
  4.        "name":"Advertising",
  5.        "n_speakers":3,
  6.        "tag":"industry_1"
  7.     },
  8.     "2":{  
  9.        "name":"Agriculture",
  10.        "n_speakers":3,
  11.        "tag":"industry_2"
  12.     }
  13.  },
  14.  "topics":{  
  15.     "273":{  
  16.        "name":"Accountability",
  17.        "n_speakers":6,
  18.        "tag":"topic_273"
  19.     },
  20.     "255":{  
  21.        "name":"Adventurers",
  22.        "n_speakers":13,
  23.        "tag":"topic_255"
  24.     },
  25.  "speakers":{  
  26.     "3438":{  
  27.        "name":"Craig Karges",
  28.        "tag":"speaker_3438"
  29.     },
  30.     "3507":{  
  31.        "name":"Steve Uzzell",
  32.        "tag":"speaker_3507"
  33.     }
  34. }

xxxx should be replaced by your unique code.


    • Related Articles

    • Adding Parts of the Directory search form to my own website

      DIRECTORY PUBLISHER The most common means of integrating your eSpeakers Whitelabeled directory in your website is via a simple link. However, there may be places where you want to send your customers over to your directory with some search results ...
    • Directory Management For Webmasters

      If you are involved in the technology of your organization's website, then this section is for you. You'll learn how to easily add an eSpeakers directory to your existing website, how to control how it looks, and how to use elements of your directory ...
    • Use the Directory Sitemap for Search Engine Indexing

      If you'd like search engines to more quickly learn about your profile pages, you can do that with a webmaster tool called a  sitemap . This is an industry standard way for you to submit a list of pages to a search engine saying, "Please check these ...
    • Adding and removing speakers from my directory

      ing the eSpeakers Directory for your website, you can add to or remove speakers from your site. Your Directory will only search and show speakers you have chosen to display on your website.   You choose which speakers you want on your site by ...
    • Rank Higher In eSpeakers Search Results

      When event organizers -- your potential buyers -- are searching for speakers on a directory powered by eSpeakers, they typically begin their search by selecting a topic and a fee range. When the directory presents the buyer with a list of matching ...