Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: ZoomInfo Authentication Scoop Search API
description: The ZoomInfo API is a set of HTTPS endpoints you can use to programmatically retrieve and integrate ZoomInfo data into your existing technology stack and ...
contact:
name: ZoomInfo API Support
url: https://www.zoominfo.com/about/help-center
email: support@zoominfo.com
version: '1.0'
x-last-validated: '2026-04-18'
servers:
- url: https://api.zoominfo.com
description: ZoomInfo API Production Server
security:
- bearerAuth: []
tags:
- name: Scoop Search
description: 'Use [Scoop Search](#3099d72f-6857-4432-89c2-736410680e60) to retrieve scoop-related data using valid query parameters.
* To build your request, retrieve a list of valid query parameters using [Scoop Search Inputs](#1888a5e1-6a96-4cc2-910b-70e574370996).
* For requests that require you to specify supported values (e.g., job titles, industry codes and so on), use the [Lookup](#efe7b4b8-1ef2-4fcd-a20f-9da68f6b2055) endpoints.
* Use [Scoop Search Outputs](#185aa18e-02fa-440e-a691-b8e2c391a456) to retrieve a list of expected response fields that will be returned from [Scoop Search](#3099d72f-6857-4432-89c2-736410680e60).'
paths:
/search/scoop:
parameters: []
post:
tags:
- Scoop Search
summary: Zoominfo Scoop Search
description: "Returns a list of Scoops from ZoomInfo's data which meet the specified search criteria.\n\n- Input parameters may require specific values, some of which are too extensive to list in the parameter descriptions. You can retrieve these values using the [Lookup](#28358f09-9863-42af-a93c-6710a8cacf9d) endpoints.\n- If you do not provide a date range for when the scoop was published, the last 30 days of scoop records matching the request are returned\n \n\n**Input params**\n\n| Parameter | DataType | Description |\n| --- | --- | --- |\n| rpp | Integer | Limits the results returned to the given number of results per page. Default is 25. |\n| page | Integer | Provides the results for the given page, used in conjunction with `rpp` |\n| sortOrder | String | Provide `sortBy` if specifying `sortOrder`. Valid values are `asc`, `ascending`, `desc`, and `descending`. By default, results are sorted in descending order. |\n| sortBy | String | Sort results by valid output fields: `scoopId`, `originalPublishedDate`, `description`, `url`, `urlText` |\n| companyId | String | ZoomInfo unique identifier for the company. Will accept a comma-separated list. |\n| companyName | String | Company name |\n| companyWebsite | String | URL to the company website in [http://www.example.com](http://www.example.com) format |\n| companyDescription | String | Text description unique to the company you want to use as search criteria |\n| parentId | String | ZoomInfo Company ID for parent company |\n| ultimateParentId | String | ZoomInfo Company ID for ultimate parent company |\n| companyType | String | Company type (private, public, and so on). See the **Company Type** lookup endpoint for values. |\n| address | String | Company address |\n| street | String | Company street |\n| state | String | Company state (U.S.) or province (Canada). You can use free text state or province names (e.g., \"new hampshire\"), the two-letter common abbreviation for a U.S. state (e.g., \"nh\"), or values provided in the **State** lookup endpoint. |\n| zipCode | String | Zip Code of the company's primary address |\n| country | String | Country for the company's primary address. You can use free text or see the **Country** lookup endpoint for values. |\n| continent | String | Continent for the company's primary address. See the **Continent** lookup endpoint for values. |\n| zipCodeRadiusMiles | String | Company Zip code radius |\n| hashTagString | String | Hash tags for the company. Can include a comma-separated list. Default AND operation with multiple inputs. |\n| techAttributeTagList | String | Specify technology product tags |\n| subUnitTypes | String | Company sub types (e.g., division, subsidiary and so on). See the **Sub Unit Type** lookup endpoint for values. |\n| primaryIndustriesOnly | Boolean | Used in conjunction with the `industryCodes` input parameter. When set to `true`, any result returned must have one of the specified industries as a primary industry. If no industries are specified, then this parameter will be ignored. Default is `false`. |\n| industryCodes | String | Top-level Industry that the contact works in. A contact can have multiple top level industries. Tags are based on the contact's current company. Can include a comma-separated list. See the **Industry Codes** lookup endpoint for values. |\n| industryKeywords | String | Industry keywords associated with a company. Can include a comma-separated list. |\n| sicCodes | String | The Standard Industrial Classification is a system for classifying industries by a four-digit code. See the **SIC Codes** lookup endpoint for values. |\n| naicsCodes | String | The North American Industry Classification System (NAICS) is the standard used by Federal statistical agencies in classifying business establishments for the purpose of collecting, analyzing, and publishing statistical data related to the U.S. business economy. See the **NAICS Codes** lookup endpoint for values. |\n| revenueMin | Integer | Minimum annual revenue for a company in U.S. dollars. Use with `revenueMax` to set a range. Alternatively, you can use the `revenue` parameter to search for pre-defined ranges. |\n| revenueMax | Integer | Maximum annual revenue for a company in U.S. dollars. Use with `revenueMin` to set a range. Alternatively, you can use the `revenue` parameter to search for pre-defined ranges. |\n| revenue | String | Annual revenue range in U.S. dollars. Accepts a comma-separated list of values. See the **Revenue Range** lookup endpoint for values. Alternatively, to get more granular ranges, you can use the `revenueMin` and `revenueMax` parameters. |\n| employeeRangeMin | String | Minimum employee count for a company. Use with `employeeRangeMax` to set a range. Alternatively, you can use the `employeeCount` parameter to search for pre-defined ranges. |\n| employeeRangeMax | String | Maximum employee count for a company. Use with `employeeRangeMin` to set a range. Alternatively, you can use the `employeeCount` parameter to search for pre-defined ranges. |\n| employeeCount | String | Employee count range. Accepts a comma-separated list of values. See the **Employee Count** lookup endpoint for values. Alternatively, to get more granular ranges, you can use the `employeeRangeMin` and `employeeRangeMax` parameters. |\n| companyRanking | String | Company ranking list (e.g., Fortune 500 and so on). See the **Company Ranking** lookup endpoint for values. |\n| metroRegion | String | Company metro area. Accepts a comma-separated list of U.S. and Canada metro areas. See the **Metro Area** lookup endpoint for values. |\n| locationSearchType | String | Location criteria for search. Values are `PersonOrHQ`, `PersonAndHQ`, `Person`, `HQ`, `PersonThenHQ`. |\n| fundingAmountMin | Integer | Minimum funding amount in thousands (e.g., 1 = 1000, 500 = 500,000). If `fundingAmountMin` is used without `fundingAmountMax`, the result will be the amount specified or greater. |\n| fundingAmountMax | Integer | Maximum funding amount in thousands (e.g., 1 = 1000, 500 = 500,000). If `fundingAmountMax` is used without `fundingAmountMin`, the result will be the amount specified or less. |\n| fundingStartDate | String | Start date of the funding in YYYY-MM-DD format. If `fundingStartDate` and `fundingEndDate` are both specified, they will be used as a range. Start date after end date returns an error. If start date and end date are the same, will return results for exact date. |\n| fundingEndDate | String | End date of the funding in YYYY-MM-DD format. If `fundingStartDate` and `fundingEndDate` are both specified, they will be used as a range. Start date after end date returns an error. If start date and end date are the same, will return results for exact date. |\n| excludedRegions | String | Exclude a company metro area. Accepts a comma-separated list of U.S. and Canada metro areas. See the **Metro Area** lookup endpoint for values. |\n| zoominfoContactsMin | String | Minimum number of ZoomInfo contacts associated with company |\n| zoominfoContactsMax | String | Maximum number of ZoomInfo contacts associated with company |\n| companyStructureIncludedSubUnitTypes | String | |\n| publishedStartDate | String | Starting date to search for scoops based on when published. Form a range using `publishedEndDate` or omit `publishedEndDate` to search to the current date. Uses YYYY-MM-DD format. |\n| publishedEndDate | String | Ending date to search for scoops based on when published. Form a range using `publishedEndDate`. Uses YYYY-MM-DD format. |\n| updatedSinceCreation | Boolean | Include scoops that have been updated since `publishedStartDate` |\n| scoopType | String | Retrieve scoops based on type (e.g., earnings, awards, partnerships and so on). See the **Scoop Types** lookup endpoint for values. |\n| scoopTopic | String | Retrieve scoops based on topic (e.g., integrations, technology, compliance and so on). See the **Scoop Topics** lookup endpoint for values. |\n| department | String | Retrieve scoops based on department (IT, finance, HR and so on). See the **Scoop Departments** lookup endpoint for values. |\n| scoopId | String | ZoomInfo unique identifier for a scoop. Will accept a comma-separated list. |\n| description | String | Search for scoops based on description. Will accept a comma-separated list of keywords. |\n\n**Response data**\n\n| Field | Description |\n| --- | --- |\n| id | ZoomInfo unique identifier for a scoop |\n| publishedDate | Publish date for a scoop. If updated, this date will reflect that last updated date. |\n| originalPublishedDate | Initial publish date for a scoop |\n| linkText | Link text for a scoop |\n| link | URL for the scoop |\n| description | Short description for the scoop contents |\n| topics | Topic(s) associated with a scoop |\n| updateText | Text related to an updated scoop |\n| types | Type(s) associated with a scoop |\n| companyId | ZoomInfo unique identifier for a company |\n| companyName | Company name |\n| contacts | Contacts associated with a scoop |"
operationId: ScoopSearch
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ScoopSearchRequest'
- examples:
- companyName: Zoominfo
publishedStartDate: '2018-11-01T00:00:00.000Z'
publishedEndDate: '2020-06-21T00:00:00.000Z'
scoopType: '6'
updatedSinceCreation: false
description: SaaS
contentMediaType: application/json
example:
companyName: Zoominfo
publishedStartDate: '2018-11-01T00:00:00.000Z'
publishedEndDate: '2020-06-21T00:00:00.000Z'
scoopType: '6'
updatedSinceCreation: false
description: SaaS
required: true
responses:
'200':
description: OK
headers:
Date:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: Mon, 22 Jun 2020 19:52:48 GMT
Transfer-Encoding:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: chunked
Connection:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: keep-alive
CF-Ray:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: 5a7882fa6840efe9-EWR
Content-Encoding:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: gzip
Set-Cookie:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: _pxhd=3bd72b5a25bfc03a0fa7e3fbae02033c37ca3cc0dcd4fa8ed0531b49f25ba90d:8511cd30-b493-11ea-bfeb-534f7eaad4f4; path=/;
Vary:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: Accept-Encoding
Via:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: 1.1 google, 1.1 google
CF-Cache-Status:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: DYNAMIC
cf-request-id:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: 037f30307d0000efe96e9c0200000001
Expect-CT:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: max-age=604800, report-uri="https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct"
x-application-context:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: application:production:8080
X-RateLimit-Limit:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: '1500'
X-RateLimit-Remaining:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: '1499'
X-RateLimit-Reset:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: '1592855627'
X-Usage-Record-Limit-Limit:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: '1000000000'
X-Usage-Record-Limit-Remaining:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: '999987604'
X-Usage-Request-Limit-Limit:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: '1000000000'
X-Usage-Request-Limit-Remaining:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: '999962398'
X-Usage-Unique-Id-Limit-Limit:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: '10000000'
X-Usage-Unique-Id-Limit-Remaining:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: '9999731'
X-Usage-Websights-Api-Record-Limit-Limit:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: '10000000'
X-Usage-Websights-Api-Record-Limit-Remaining:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: '9999781'
X-Usage-Websights-Api-Request-Limit-Limit:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: '100000000'
X-Usage-Websights-Api-Request-Limit-Remaining:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: '99999781'
Server:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: cloudflare
content:
application/json;charset=utf-8:
schema:
allOf:
- $ref: '#/components/schemas/ScoopSearch'
- examples:
- maxResults: 4
totalResults: 4
currentPage: 1
data:
- id: 1382057
publishedDate: 2/22/2019 12:00 AM
originalPublishedDate: 2/22/2019 12:00 AM
linkText: ''
link: ''
description: 'Datanyze has recently been ranked #986 on the 2019 SaaS 1000 Top SaaS Companies list.'
topics: []
updateText: ''
types:
- id: 6
type: Award
contacts: []
company:
id: 344589814
name: ZoomInfo
- id: 1382056
publishedDate: 2/15/2019 12:00 AM
originalPublishedDate: 2/15/2019 12:00 AM
linkText: ''
link: ''
description: 'has recently been ranked #139 on the 2019 SaaS 1000 Top SaaS Companies list.'
topics: []
updateText: ''
types:
- id: 6
type: Award
contacts: []
company:
id: 344589814
name: ZoomInfo
- id: 1373240
publishedDate: 2/11/2019 12:00 AM
originalPublishedDate: 2/11/2019 12:00 AM
linkText: ''
link: ''
description: has been recognized as a 2019 Top Rated Sales Intelligence Software by TrustRadius.
topics: []
updateText: ''
types:
- id: 6
type: Award
contacts: []
company:
id: 344589814
name: ZoomInfo
- id: 1258709
publishedDate: 12/4/2018 12:00 AM
originalPublishedDate: 12/4/2018 12:00 AM
linkText: ''
link: ''
description: has recently been recognized by The Boston Globe as one of the Top Places to Work for 2018 in Massachusetts in the midsize organization category.
topics: []
updateText: ''
types:
- id: 6
type: Award
contacts: []
company:
id: 344589814
name: ZoomInfo
contentMediaType: application/json;charset=utf-8
example:
maxResults: 4
totalResults: 4
currentPage: 1
data:
- id: 1382057
publishedDate: 2/22/2019 12:00 AM
originalPublishedDate: 2/22/2019 12:00 AM
linkText: ''
link: ''
description: 'Datanyze has recently been ranked #986 on the 2019 SaaS 1000 Top SaaS Companies list.'
topics: []
updateText: ''
types:
- id: 6
type: Award
contacts: []
company:
id: 344589814
name: ZoomInfo
- id: 1382056
publishedDate: 2/15/2019 12:00 AM
originalPublishedDate: 2/15/2019 12:00 AM
linkText: ''
link: ''
description: 'has recently been ranked #139 on the 2019 SaaS 1000 Top SaaS Companies list.'
topics: []
updateText: ''
types:
- id: 6
type: Award
contacts: []
company:
id: 344589814
name: ZoomInfo
- id: 1373240
publishedDate: 2/11/2019 12:00 AM
originalPublishedDate: 2/11/2019 12:00 AM
linkText: ''
link: ''
description: has been recognized as a 2019 Top Rated Sales Intelligence Software by TrustRadius.
topics: []
updateText: ''
types:
- id: 6
type: Award
contacts: []
company:
id: 344589814
name: ZoomInfo
- id: 1258709
publishedDate: 12/4/2018 12:00 AM
originalPublishedDate: 12/4/2018 12:00 AM
linkText: ''
link: ''
description: has recently been recognized by The Boston Globe as one of the Top Places to Work for 2018 in Massachusetts in the midsize organization category.
topics: []
updateText: ''
types:
- id: 6
type: Award
contacts: []
company:
id: 344589814
name: ZoomInfo
deprecated: false
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/lookup/inputfields/scoop/search:
parameters: []
get:
tags:
- Scoop Search
summary: Zoominfo Scoop Search Inputs
description: Returns a list of fields you can use as input for the [Scoop Search](#3099d72f-6857-4432-89c2-736410680e60) endpoint.
operationId: ScoopSearchInputs
parameters: []
responses:
'200':
description: OK
headers:
Date:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: Wed, 26 Aug 2020 13:25:13 GMT
Transfer-Encoding:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: chunked
Connection:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: keep-alive
CF-Ray:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: 5c8de0a80935ff84-BOS
Content-Encoding:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: gzip
Set-Cookie:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: _pxhd=70071f10bb597f681bf32e5484a1bffce58189aa85981cea9fb1578c401445bb:2f79d591-e713-11ea-b61e-d347a7de7ad3; path=/;
Vary:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: Accept-Encoding
Via:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: 1.1 google, 1.1 google
CF-Cache-Status:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: DYNAMIC
cf-request-id:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: 04cc8abd070000ff849b298200000001
Expect-CT:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: max-age=604800, report-uri="https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct"
X-RateLimit-Limit:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: '1500'
X-RateLimit-Remaining:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: '1499'
X-RateLimit-Reset:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: '1598448374'
Server:
content:
text/plain:
schema:
type: string
contentMediaType: text/plain
example: cloudflare
content:
application/json;charset=utf-8:
schema:
type: array
items:
$ref: '#/components/schemas/ScoopSearchInput'
description: ''
examples:
- - fieldName: publishedStartDate
fieldType: String
description: Starting date to search for scoops based on when published. Form a range using publishedEndDate or omit publishedEndDate to search to the current date. Uses YYYY-MM-DD format.
- fieldName: publishedEndDate
fieldType: String
description: Ending date to search for scoops based on when published. Form a range using publishedEndDate. Uses YYYY-MM-DD format.
- fieldName: updatedSinceCreation
fieldType: Boolean
description: Include scoops that have been updated since publishedStartDate
- fieldName: scoopType
fieldType: String
description: Retrieve scoops based on type (e.g., earnings, awards, partnerships and so on)
- fieldName: scoopTopic
fieldType: String
description: Retrieve scoops based on topic (e.g., integrations, technology, compliance and so on)
- fieldName: department
fieldType: String
description: Retrieve scoops based on department (IT, finance, HR and so on)
- fieldName: scoopId
fieldType: String
description: ZoomInfo unique identifier for a scoop. Will accept a comma-separated list.
- fieldName: description
fieldType: String
description: Search for scoops based on description
- fieldName: companyId
fieldType: String
description: ZoomInfo unique identifier for the company. Will accept a comma-separated list.
- fieldName: companyName
fieldType: String
description: Company name
- fieldName: companyWebsite
fieldType: String
description: Company domain
- fieldName: parentId
fieldType: String
description: ZoomInfo Company ID for parent company
- fieldName: ultimateParentId
fieldType: String
description: ZoomInfo Company ID for ultimate parent company
- fieldName: companyDescription
fieldType: String
description: Text description unique to the company you want to use as search criteria
- fieldName: companyType
fieldType: String
description: Company type (private, public, and so on)
- fieldName: address
fieldType: String
description: Company address
- fieldName: street
fieldType: String
description: Company street
- fieldName: state
fieldType: String
description: Company state
- fieldName: zipCode
fieldType: String
description: Zip Code of the company's primary address
- fieldName: country
fieldType: String
description: Company country
- fieldName: continent
fieldType: String
description: Company continent
- fieldName: zipCodeRadiusMiles
fieldType: String
description: Used in conjunction with zipCode, designates a geographical radius (in miles) from the zipCode provided.
- fieldName: hashTagString
fieldType: String
description: Hash tags for a company. Can include a comma-separated list.
- fieldName: techAttributeTagList
fieldType: String
description: Specify technology product tags
- fieldName: subUnitTypes
fieldType: String
description: Company sub types (e.g., division, subsidiary and so on).
- fieldName: primaryIndustriesOnly
fieldType: Boolean
description: Used in conjunction with the industryCodes input parameter. When set to true, any result returned must have one of the specified industries in the top two. If no industries are specified, then this parameter will be ignored. Default is false.
- fieldName: industryCodes
fieldType: String
description: Top-level industry that the contact works in. A contact can have multiple top level industries. Tags are based on the contact's current company. Can include a comma-separated list.
- fieldName: industryKeywords
fieldType: String
description: Industry keywords associated with a company. Can include a comma-separated list.
- fieldName: sicCodes
fieldType: Strin
# --- truncated at 32 KB (73 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/zoominfo/refs/heads/main/openapi/zoominfo-scoop-search-api-openapi.yml