Here are some frequently asked questions about Viesearch API. If you cannot find an answer to your question,
feel free to contact us. We are always happy to help!
The Viesearch API is public and requires no authentication. For search results, make a GET request to /?q=your_search_term&format=rss to receive results in RSS format.
Search API
What feed formats are available?
Currently we support RSS format through the format=rss parameter. This returns standardized RSS 2.0 feeds that can be consumed by any RSS reader or parser.
How do I search within categories?
To search within a specific category, use the category slug in the URL path:
You can find the full list of category slugs by browsing our directory.
Can I get results without a search term?
Yes, you can get the latest listings in any category by omitting the q parameter:
Example: /arts_and_entertainment?format=rss
Submission API
How do I submit URLs programmatically?
You can submit URLs by sending a POST request to /submit. All submissions will be reviewed by our editors before being added to the index.
What parameters are required for submission?
Required POST parameters:
- OWNER_NAME: Your full name (no business names)
- OWNER_EMAIL: Valid email address
- URL: Website URL
- TITLE: Website title
- DESCRIPTION: Website description
- LINK_TYPE: Use "normal" for standard submissions
Optional parameters:
- CATEGORY_ID: Numeric category ID
- RECPR_URL: For reciprocal links
- LINK_COUPON: For promotional codes
What listing types are available?
We offer several listing types: - Featured: Premium placement with thumbnail preview - Express: Priority review text-only listing - Reciprocal: Free listing with reciprocal link requirement - Normal: Standard free text-only listing Featured and Express listings receive priority review. There are four LINK_TYPE options when submitting a POST request to /submit: