Sona Labs API Reference (1.0.0)

Use the Profile360 endpoint to enrich data for one person based on their email address. To process multiple profiles in a single request, use the Bulk Profile360 endpoint instead.

Profile360 relies on the information you pass through the endpoint's parameters to identify and enrich the correct user record. The more specific and accurate the email you provide, the more likely Profile360 will return complete and verified profile data. If you submit a general or invalid email, you may still receive a 200 response, but the response data will indicate that no profile was found or enriched.

By default, this endpoint returns publicly available identity and professional details, such as name, job title, and profile photo. Attributes like company information, visitor journey, and ad conversions are only included when available in the connected data sources.

Calling this endpoint consumes credits under your Sona pricing plan.

Use the Account360 endpoint to retrieve comprehensive account intelligence for a company based on its domain. This endpoint provides a holistic view of account activity, engagement signals, and firmographic data in a single API call.

Account360 aggregates data across multiple dimensions including visitor activity, intent signals, technology stack, and engagement history. The more interaction data available for a domain in your connected sources, the richer the insights returned. If you query a domain with limited or no tracked activity, you may receive a 200 response with empty arrays for activity-based fields like journey, people, and intent signals.

By default, this endpoint returns account details, buying stage indicators, ICP scoring, and technology information. Fields like website visitors, intent signals, and people are populated based on available tracking data from your connected data sources.

Calling this endpoint consumes credits under your Sona pricing plan.

Use the Company Search endpoint to discover and filter companies based on various firmographic criteria. This endpoint allows you to search through thousands of company records using parameters like domain, name, industry, and location to find organizations that match your ideal customer profile.

Company Search supports flexible filtering by combining multiple parameters to narrow down results. You can search by specific domains, company names, industries, or geographic locations. The endpoint returns paginated results with detailed company information including firmographic data, technology stack, social media profiles, and estimated revenue ranges.

The response includes comprehensive company details such as employee count ranges, founding year, headquarters location, industry classifications, and technology categories. Each company record also provides social media URLs, website traffic estimates, and advertising activity indicators when available in the database.

Calling this endpoint consumes credits under your Sona pricing plan.

Use the Company Enrichment endpoint to enrich data for a single company. To enrich data for multiple companies with a single API call, use the Bulk Company Enrichment endpoint instead.

The API relies on the company domain you provide via the website parameter to identify and retrieve comprehensive company information from the database. Providing an accurate and complete domain ensures the highest match rate and data quality.

By default, this endpoint returns a wide range of company attributes including firmographic data, social media profiles, technology usage, and revenue estimates. The response includes company details such as founding year, employee count, location, industry classification, and estimated annual revenue ranges.

Important: Calling this endpoint consumes credits as part of your pricing plan.

Use the Company Logo endpoint to retrieve the logo image URL for a specific company. This lightweight endpoint is designed for quickly fetching company logos without consuming the full enrichment credits required by the Company Enrichment endpoint.

The API identifies the company based on the domain you provide and returns a direct URL to the company's logo image hosted on our CDN. This endpoint is ideal for populating UI elements, building company directories, or displaying visual brand identifiers in your application.

Important: Calling this endpoint consumes credits as part of your pricing plan, though typically at a lower rate than full company enrichment.

Use the People Search endpoint to discover professionals working at a specific company. This endpoint allows you to filter and retrieve detailed employee information based on various professional and demographic criteria, making it ideal for building targeted prospecting lists, identifying decision-makers, and enriching your CRM data.

How it works:The API searches for people associated with a company domain you provide via the website parameter. You can further refine results using flexible filters based on job titles, names, locations, skills, and other professional attributes. The endpoint returns paginated results with comprehensive profile information including contact details, social media profiles, and professional history.

Note: Calling this endpoint consumes credits under your Sona pricing plan. Email addresses marked as email_not_unlocked@domain.com require additional credits to unlock full contact information.