🔍 Search APIs_

Overview

The Search APIs allow you to search for companies and users within the DBus World platform. Search queries must be at least 2 characters long.

Endpoints

Search Companies

Endpoint: GET /search/companies

Search for companies by name.

Parameters:

• q (query) - Search query (minimum 2 characters)

Example Request:

<code>GET /api/search/companies?q=transport
</code>

Response:

<code>{
  &quot;success&quot;: true,
  &quot;companies&quot;: [
    {
      &quot;id&quot;: 456,
      &quot;name&quot;: &quot;City Transport Company&quot;,
      &quot;member_count&quot;: 25
    }
  ]
}
</code>

Error Responses:

• 400 - Search query too short (less than 2 characters)

Search Users

Endpoint: GET /search/users

Search for users with public profiles by name.

Parameters:

• q (query) - Search query (minimum 2 characters)

Example Request:

<code>GET /api/search/users?q=john
</code>

Response:

<code>{
  &quot;success&quot;: true,
  &quot;users&quot;: [
    {
      &quot;id&quot;: 123,
      &quot;name&quot;: &quot;John Doe&quot;,
      &quot;avatar_url&quot;: &quot;https://example.com/avatar.jpg&quot;,
      &quot;company&quot;: &quot;City Transport Company&quot;
    }
  ]
}
</code>

Error Responses:

• 400 - Search query too short (less than 2 characters)

Search Guidelines

• Minimum Query Length: 2 characters
• Rate Limiting: 30 requests per hour per IP
• User Search: Only returns users with public profiles
• Company Search: Returns all companies matching the query
• Results Limit: Maximum 10 results per search

← Back to API Documentation