Viesearch / API Documentation
647,970,853 Searches  3,461,118 Submissions  871,539 Sites  4,961 Featured  1,083 Categories  349,464 Editors
API Documentation

Viesearch API Documentation

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!

Basic Usage

Search API

Submission API

Basic Usage

How do I use the Viesearch API?

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:

Example: /arts_and_entertainment?q=your_search_term&format=rss


Common categories:

- /arts_and_entertainment

- /business

- /computers_and_internet

- /games

- /health_and_fitness

- /home

- /jobs_and_employment

- /kids_and_teens

- /marketing_and_advertising

- /news

- /real_estate

- /reference_and_education

- /regional

- /science

- /shopping

- /society

- /sports_and_recreation

- /travel

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:


1. "featured" - Premium Listing ($base_price * 2):

  - Thumbnail preview image

  - Instant review (skips pending queue)

  - Premium placement in search results

  - Shown in featured locations


2. "express" - Express Listing ($base_price):

  - Text-only listing

  - Instant review (skips pending queue)

  - Standard placement in search results


3. "reciprocal" - Free with Reciprocal Link:

  - Text-only listing in search

  - Requires valid RECPR_URL parameter

  - Thumbnail shown only on Friends page when sending traffic

  - Joins standard review queue


4. "normal" - Basic Free Listing:

  - Text-only listing

  - Standard placement in results

  - Joins standard review queue

  - No thumbnail preview

What happens after submission?

After submitting a URL:

1. You'll receive an email verification request

2. Once verified, your submission enters our review queue

3. Our editors manually review all submissions

4. Approved sites are added to the search index


Note: Featured and Express submissions receive priority review.

Are there submission limits?

Yes, to maintain quality:

- Maximum of 100 submissions per day per IP

- Each submission must be unique

- All submissions must comply with our content guidelines

- Bulk submissions should use standard spacing between requests