---
title: Adding Parts of the Directory search form to my own website
description: "**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 already…"
url: "https://dcfopdxtfms3x.cloudfront.net/kb/adding-parts-of-the-directory-search-form-to-my-own-website/"
updated: "2026-08-18"
category: Directory Publishers
---

# 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 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. 1. <input type="hidden" name="resume_search" value="0" />
   2. <input type="text" name="searchtags[]" />
   3. <button type="submit">Search!</button>
2. </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:

1. [https://www.espeakers.com/s/xxxx/v3/search/setup/%7B%22topic_id%22:%22123%22%7D](https://www.espeakers.com/s/xxxx/v3/search/setup/%7B%22topic_id%22:%22123%22%7D)

The is the URI encoded version of:

1. [https://www.espeakers.com/s/xxxx/v3/search/setup/%7B%22topic_id%22:%22123%22%7D](https://www.espeakers.com/s/xxxx/v3/search/setup/%7B%22topic_id%22:%22123%22%7D)

xxxx should be replaced by your unique code, and 123 should be replaced 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 Result for a Keyword**Use the following URL to link to search results for a free-form keyword:

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

This is the URI encoded version of:

1. [https://www.espeakers.com/s/xxxx/speaker/search?searchtags[]=KEYWORD](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:

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

This is the URI encoded version of:

1. [https://www.espeakers.com/s/xxxx/v3/search/setup/%7B%22awards%22:%22csp%22%7D](https://www.espeakers.com/s/xxxx/v3/search/setup/%7B%22awards%22:%22csp%22%7D)

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:

1. capshof CAPS Canada - Hall of Fame
2. cpae NSA - CPAE Speaker Hall of Fame®
3. csp CSP Certified Speaking Professional™
4. fpsa PSA United Kingdom - Felow
5. icfacc ICF - ACC Associate Certified Coach
6. icdpcc ICF - PCC Professional Certified Coach
7. icfmcc ICF - MCC Master Certified Coach
8. nsaa PSA Australia - Hall of Fame
9. dtm Toastmasters - DTM Distinguished Toastmaster
10. cspgsf GSF - Global Speaking Fellow
11. mpiok MPI - Chapter Speaker
12. cspnsaa PSA Australia - CSP Certified Speaking Professional
13. sa_hof PSA Southern Africa - Hall of Fame
14. sa_founder PSA Southern Africa - Founders Award
15. cic_cmp CMP - Certified Meeting Professional
16. uk_hof PSA United Kingdom - Hall of Fame
17. 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:

1. [https://www.espeakers.com/s/xxx/index/sitelists](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. {
   1. "idustries": {
      1. "1": {
         1. "name": "Advertising",
         2. "n_speakers": 3,
         3. "tag": "industry_1"
      2. },
      3. "2": {
         1. "name": "Agriculture",
         2. "n_speakers": 3,
         3. "tag": "industry_2"
      4. }
   2. },
   3. "topics": {
      1. "273": {
         1. "name": "Accountability",
         2. "n_speakers": 6,
         3. "tag": "topic_273"
      2. },
      3. "255": {
         1. "name": "Adventurers",
         2. "_speakers": 13,
         3. "tag": "topic_255"
      4. },
   4. "speakers": {
      1. "3438": {
         1. "name": "Craig Karges",
         2. "tag": "speaker_3438"
      2. },
      3. "3507": {
         1. "name": "Steve Uzzell",
         2. "tag": "speaker_3507"
      4. }
   5. }
2. }

xxxx should be replaced by your unique code.
