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.

Create a Marketplace Search Box #

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. 

Link Directly To A Search Topic #

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. 

Link directly to the Results for a Keyword #

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

Link Directly to a List of Awarded speakers #

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.