There's a new version of the HubSpot API

Check out the new API
View Beta Docs

We're also working on a new documentation website, you're invited to check it out and give us your feedback.

Search your site

Last updated January 7, 2025

GET /contentsearch/v2/search

Method Details

HTTP Methods:

GET

Response Format:

json

Requires Authentication?

No

Rate Limited?

Yes

Headers

User-Agent

Products:

Marketing

Required Scope:

content

For a given portal, return any content related to a search term from your HubSpot hosted site. Searches can return data from the specified content types, domains, or URL paths.

Note: This endpoint is used to search for content accross multiple domains. For information on the site search modules or searching for content on a single subdomain, check out this Knowledge Base article.

Required Parameters How to use Description
Portal ID ?portalId= The ID of the portal the contact search should be performed against.
Search Term &term= The term to be used in the content search.

Optional Filter Parameters How to use Description
Type &type= Specifies the type of content to search. Can be one or more of SITE_PAGE, LANDING_PAGE, BLOG_POST, LISTING_PAGE, and KNOWLEDGE_ARTICLE. Defaults to all content types except LANDING_PAGE and KNOWLEDGE_ARTICLE.

Include the parameter multiple times to search across multiple types, e.g. &type=SITE_PAGE&type=BLOG_POST
Domain &domain= Specifies the domain(s) to be searched. Can be one or more of the portal's connected domains. Defaults to all domains.
Language &language= Specifies the language of content to be searched. This parameter should obey the ISO639-1 format (e.g. es for Spanish).
property &property= Specifies which properties to search for (defaulting to all properties). Options are title, description, and html. For blog posts, additional search properties are author_full_name, author_handle, and tag.
Group ID &groupId= Specifies which blog(s) to be searched by blog ID. Can be used multiple times to search more than one blog.
Table ID &tableId= Specifies a specific HubDB table to search. Only returns results from the specified table. Can be used in tandem with the hubdbQuery parameter to further filter results.
HubDB Query &hubdbQuery= Specify a HubDB query to further filter the search results. Used in tandem with the tableId parameter above.
Path Prefix &pathPrefix= Specifies a path prefix to filter search results. Will only return results with URL paths that start with the specified parameter. Can be used multiple times. Has a limit of 30 characters. 
Match Prefix &matchPrefix= Inverts the behavior of the pathPrefix filter when set to 'false'. (Defaults to true)
Optional Result Parameters How to use Description
Length &length= Specifies the length of the search results. Can be set to LONG or SHORT. Setting this parameter to SHORT will return a short highlight of the meta description. Setting this parameter to LONG will build the snippet based on the html/content of the page. If you are not using the snippet, setting this parameter to SHORT will give a slight performance improvement.
Analytics &analytics= Specifies whether or not to enable tracking links. Defaults to false. When set to true, the content's URL will be replaced with a tracking link.
Autocomplete &autocomplete= Specifies whether or not you are showing autocomplete results. Defaults to false. If you're not showing autocomplete results, this parameter should be excluded.
Optional Score Parameters How to use Description
Popularity Boost &popularityBoost= Specifies how strongly a result is boosted based on its view count. Defaults to 1.0.
Maximum Boost &maxBoost= Specifies the maximum amount a result will be boosted based on its view count. Defaults to 5.0.
Recency Boost &boostRecent= Specifies a relative time window where scores of documents published outside this time window decay. This can only be used for blog posts. For example, boostRecent=10d will boost documents published within the last 10 days. Supported timeunits are ms (milliseconds), s (seconds), m (minutes), h (hours), d (days).
Optional Paging Parameters How to use Description
Offset &offset= Used to page through the results. If there are more results than specified by the limit= parameter, you will need to use the offset returned in the first request to get the next set of results.
Limit &limit= Specifies the number of results to be returned in a single response. Defaults to 10, maximum limit is 100.

About

Jobs

Learn Inbound

Support

Locations

HubSpot, Inc.
25 First Street, 2nd Floor
Cambridge, MA 02141
European Headquarters
Ground Floor, Two Dockland Central
Guild Street, Dublin 1
Asia/Pacific Office
20 Hunter St, Level 7
Sydney NSW 2000
View our other locations
Example GET URL without any filters: https://api.hubapi.com/contentsearch/v2/search?portalId=62515&term=hubspot Example GET URL to get the shortend snippets for blog posts: https://api.hubapi.com/contentsearch/v2/search?portalId=62515&term=hubspot&type=BLOG_POST&length=SHORT Example Response: { "total": 10912, "offset": 0, "limit": 10, "results": [ { "id": 3761238962, "score": 0.30858153, "type": "BLOG_POST", "domain": "demo-hubapi.hs-sites.com", "url": "http://demo-hubapi.hs-sites.com/blog/hubspot-topic-rule-aikatsu-125201", "language": "id", "title": "{hubspot topic rule} アイカツ!", "authorFullName": "test qa", "tags": [] }, { "id": 3764126491, "score": 0.30858153, "type": "BLOG_POST", "domain": "demo-hubapi.hs-sites.com", "url": "http://demo-hubapi.hs-sites.com/blog/hubspot-topic-rule-slimelime-139777", "language": "id", "title": "{hubspot topic rule} Slimelime", "description": "itunes.apple.com - ヒカキンさんがやってたんでやってみたら、はまっちゃいますね〜♪( ´▽｀)曲とやったら面白さ倍ですね", "authorFullName": "test qa", "tags": [] }, { "id": 3777674024, "score": 0.30858153, "type": "BLOG_POST", "domain": "demo-hubapi.hs-sites.com", "url": "http://demo-hubapi.hs-sites.com/blog/hubspot-topic-rule-thermalabs-164623", "language": "id", "title": "{hubspot topic rule} Thermalabs", "description": "thermalabs.com - We Care About Your Skin HealthNot only do we want you to be the sexiest you can be, we also want you to understand how to keep your skin healthy. Our writers keep publishing new guides, tutorials and articles to keep you informed on what’s happening", "authorFullName": "test qa", "tags": [] }, { "id": 3777827984, "score": 0.30858153, "type": "BLOG_POST", "domain": "demo-hubapi.hs-sites.com", "url": "http://demo-hubapi.hs-sites.com/blog/hubspot-topic-rule-instagram-165384", "language": "id", "title": "{hubspot topic rule} Instagram", "authorFullName": "test qa", "tags": [] }, { "id": 3778441554, "score": 0.30858153, "type": "BLOG_POST", "domain": "demo-hubapi.hs-sites.com", "url": "http://demo-hubapi.hs-sites.com/blog/hubspot-topic-rule-on-twitter-165731", "language": "id", "title": "{hubspot topic rule} . ⎞⎠ on Twitter", "description": "twitter.com - Add a location to your TweetsWhen you tweet with a location, Twitter stores that location. You can switch location on/off before each Tweet and always have the option to delete your location history. Learn more", "authorFullName": "test qa", "tags": [] }, { "id": 3779720048, "score": 0.30858153, "type": "BLOG_POST", "domain": "demo-hubapi.hs-sites.com", "url": "http://demo-hubapi.hs-sites.com/blog/hubspot-topic-rule-greeeen-137986", "language": "id", "title": "{hubspot topic rule} GReeeeN", "description": "itunes.apple.com - GReeeeNのすべてがあなたの手のひらに。アーティストと、仲間と「その時」「その日」「その空間」を共有しましょう！【機能】・テキストや画像だけでなく、動画配信も行われる「News」・他のファンと直接チャットできる「Let's Talk」・イベントやライブ情報をいち早くGetでき、スムーズなチケット購入が可能な「Tour」・おすすめワードをTwitterから検索まとめ「Pick up」・メンバーオススメのお店やスポットを紹介する「M Map」・動画が見れる「Cloud player」・既存の曲はもちろん、自身が組んだプレイリストやエフェクト機能を楽しむことができる「Player」・素顔に迫ることができる「M Radio」・想いや熱意をライブで直接届けることのできる「Live Tools」・写真とコラージュして楽しめる「M Photo」・活動履歴の表示や、リリースした作品のディスコグラフィーが閲覧可能な「Profile」・最新のLIVE映像が観れる「Video Player」・その他あなたとが繋がるための機能が満載なアプリです。【月額課金", "authorFullName": "test qa", "tags": [] }, { "id": 3781959304, "score": 0.30858153, "type": "BLOG_POST", "domain": "demo-hubapi.hs-sites.com", "url": "http://demo-hubapi.hs-sites.com/blog/hubspot-topic-rule-instagram-167709", "language": "id", "title": "{hubspot topic rule} Instagram", "authorFullName": "test qa", "tags": [] }, { "id": 3782876227, "score": 0.30858153, "type": "BLOG_POST", "domain": "demo-hubapi.hs-sites.com", "url": "http://demo-hubapi.hs-sites.com/blog/hubspot-topic-rule-the-road-137217", "language": "id", "title": "{hubspot topic rule} The Road", "description": "amazon.com - NATIONAL BESTSELLERPULITZER PRIZE WINNERNational Book Critics Circle Award FinalistA New York Times Notable BookOne of the Best Books of the YearThe Boston Globe, The Christian Science Monitor, The Denver Post, The Kansas City Star, Los Angeles Times, New York, People, Rocky Mountain News", "authorFullName": "test qa", "tags": [] }, { "id": 3783935192, "score": 0.30858153, "type": "BLOG_POST", "domain": "demo-hubapi.hs-sites.com", "url": "http://demo-hubapi.hs-sites.com/blog/hubspot-topic-rule-datadevelop-138435", "language": "id", "title": "{hubspot topic rule} DataDevelop", "description": "softpedia.com - A practical solution specially designed for users who want to manage, as well as to organize multiple databases such as SQL Server, MySQL, SQLiteLarge quantities of information are best stored in databases, and there are already various services that managed to make a name for themselves throughout", "authorFullName": "test qa", "tags": [] }, { "id": 3783024922, "score": 0.30858153, "type": "BLOG_POST", "domain": "demo-hubapi.hs-sites.com", "url": "http://demo-hubapi.hs-sites.com/blog/hubspot-topic-rule-kasutamarebiyu-137626", "language": "id", "title": "{hubspot topic rule} カスタマーレビュー", "description": "itunes.apple.com - 楽しみながら賞品も得られる！レビュー : 黒服S1日数回更新されるクロスワードアプリです。難易度はそれ程高くないと思うので、クロスワード経験が無くても大丈夫だと思います。毎日こつこつ挑戦してランキング1位を目指しましょう", "authorFullName": "test qa", "tags": [] } ], "cacheKey": "62515:hubspot:false:SHORT::BLOG_POST:0:10::1.0:5.0:0.05:false:Optional.empty:Optional.empty:Optional.empty", "page": 0 }