ShareASale Affiliate Program API & Data Feeds
WyzAnt provides our partners with multiple ways to access our Tutor data.
WyzAnt Feeds provide a complete snapshot of WyzAnt's active Tutors while
WyzAnt's Search API allows you to perform realtime searches against
the WyzAnt Tutor database. Results from both the Feeds and API calls are formatted
in XML or JSON and the details can be found here.
The WyzAnt Feeds are intended to be consumed by a back-end process and imported
into a database. The Feeds contain all active WyzAnt Tutors at the time the Feed
is retrieved. The Feed filesize is quite large and therefore it is expected that
each partner will access the Feed at most once per day.
To access your Feed use the URL below swapping out the parameter placeholders with
the appropriate values as described in the table.
http://data.wyzant.com/feeds/downloadFeed?apiKey={APIKey}&feedFormat={FeedFormat}&shareSaleID={ShareASaleID}(&maxResults={numResults})
Feed Parameters
|
APIKey
|
Your personal API Key is:
[email partners@wyzant.com to get your api key].
|
|
FeedFormat
|
Either 'XML' or 'JSON' (without the quotes) depending on the desired formatting
of your results set.
|
|
ShareASale ID
|
Your ShareASale ID.
|
|
MaxResults (optional)
|
For testing purposes you may include a MaxResults value to limit the number of results
returned. If this value is omitted then a full listing of all of WyzAnt's active
tutors will be returned.
|
You can use our API to add custom WyzAnt content across your channels. Our API provides
real-time search results across all of our active tutors based on a number of criteria.
Below is an explanation of how to execute a search against our API. If you have
any questions about working with our API, please contact us at
partners@wyzant.com.
Search API
To run a search against our API, simply execute a HTTP POST against the following
URL and pass the desired search parameters as form arguments:
http://data.wyzant.com/api/search
Click here
to launch a simple test form.
Search Parameters
|
PartnerAPIKey
|
string (WyzAnt-generated GUID)
|
This is your WyzAnt-assigned key to access our data. It is encoded into generated
links so you get credit for conversions you send to WyzAnt.
|
|
ChannelName (optional)
|
string
|
Use ChannelName to assign links generated by this search to any one of your user-defined
channels. If no ChannelName parameter is supplied then the Default channel will
be used.
|
|
SearchString
|
string
|
This specifies a string to search for in the database. Tutor ad titles, free responses,
and subjects/subject qualifications will all be searched for the string entered here.
|
|
ShareASale ID
|
string
|
Your ShareASale ID.
|
|
Zip (optional)
|
string
|
This sets the US Zip Code of your search. If no value is supplied, the entire database
is searched with no preferences given for location.
|
|
Distance (optional)
|
int32
|
The distance in miles to from the center of the value supplied by the 'Zip' parameter
to search. Distance is caluclated as a radius from the center of the supplied 'Zip'
parameter. For instance, if the 'Zip' parameter is '60647' and the distance is '20,'
only tutors within a twenty mile radius of the center of the 60647 zip code will
be returned. The default value for the 'Distance' parameter is '40'. If the 'Zip'
parameter is not supplied then the 'Distance' parameter is ignored.
|
|
IsMale (optional)
|
boolean
|
Use this parameter to search tutors of a specific gender. Valid values are: 'true'
(only return male tutors) and 'false' (only return female tutors). If this parameter
is not supplied then both male and female tutors will be returned (default).
|
|
MaxHourly (optional)
|
decimal
|
If supplied then only tutors with an hourly fee equal to or less than the supplied
value will be returned.
|
|
MinHourly (optional)
|
decimal
|
If supplied then only tutors with an hourly fee equal to or greater than the supplied
value will be returned.
|
|
MinAge (optional)
|
int32
|
If supplied then only tutors who are 'MinAge' years or older will be returned.
|
|
MaxAge (optional)
|
int32
|
If supplied then only tutors who are 'MaxAge' years or younger will be returned.
|
|
MaxResults (optional)
|
int32
|
If supplied then no more than 'MaxResults' tutors will be returned.
|
|
ResultsFormat (optional)
|
string
|
Specifies the desired formatting for the results set. Results can be returned in
either XML or JSON (default).
|