Make Your First Company Intent API Request

Use the Company Intent endpoint to retrieve intent signals for specific companies, keyword sets, or keywords.

Prerequisites to Make a Company Intent API Request

• Your account must have access to the Intent API beta.
• Generate a bearer token using Authenticate with Demandbase APIs. Your API key set must include Intent API access.
• Identify at least one company ID, keyword set ID, or keyword to include in your request.

Make a Company Intent API Request

The following example retrieves company intent signals for a specified company and date range.

Replace YOUR_ACCESS_TOKEN with your bearer token and update the request parameters as needed.

curl --request POST \
  --url https://uapi.demandbase.com/data/intent/v1/companies/intent/query \
  --header "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  --header "Content-Type: application/json" \
  --header "Accept: application/json" \
  --data '{
    "companyIds": ["726263"],
    "startDate": "2026-07-01",
    "endDate": "2026-07-22",
    "pageSize": 5,
    "sortBy": "endDate",
    "sortOrder": "DESC"
  }'

Important:

• startDate and endDate are required and must use the yyyy-MM-dd format.
• Include at least one of companyIds, keywordSetIds, or keywords.
• The maximum date range is 12 months.
• pageSize accepts values from 1 to 100 and defaults to 25.

Example Company Intent API Response

A successful request returns 200 OK with matching intent signals.

{
  "data": [
    {
      "companyId": "726263",
      "domain": "example.com",
      "keyword": "Zero Trust",
      "numPeopleResearching": 8,
      "intentStrength": "HIGH",
      "isTrending": true,
      "trendingScore": 10,
      "numTrendingDays": 3,
      "startDate": "2026-07-01",
      "endDate": "2026-07-07",
      "keywordSetId": 7303,
      "keywordSetName": "Security Keywords"
    }
  ],
  "pagination": {
    "totalCount": 1
  }
}

The response includes:

• data: Intent signals matching the request filters and date range.
• pagination.totalCount: Total number of matching records.

If data is empty, the request succeeded but no matching intent signals were found.

Important: During the beta, the Company Intent endpoint returns only the first page of results. To retrieve different results, narrow your filters or shorten the date range.

For the complete request and response schema, see Retrieve company intent data.