Search data sources

  • Published on Nov 4, 2025
Prev Next
Get
/datasource/search

Search for public connectors based on keyword and filtering

Query parameters
filter[keyword]
string

Fuzzy search by keyword in connector ID, name, marketing name, platform, description, categories, aliases, and tags

Max length255
Pattern^[A-Za-z0-9\s_-]*$
Examplemeta
filter[category]
string

Filter by category

Valid values[ "WEB_ANALYTICS", "SOCIAL_MEDIA", "SALES", "SEO", "PAID_MEDIA", "OTHER", "MOBILE_APP_ANALYTICS", "FEEDBACK_REVIEWS", "EMAIL_SMS", "ECOMMERCE", "AFFILIATE" ]
ExampleSALES
filter[status]
string

Filter by release status

Valid values[ "DEVELOPMENT", "INVITE_ONLY", "EARLY_ACCESS", "RELEASED", "SUNSETTED" ]
ExampleRELEASED
filter[product]
string

Filter by product

Valid values[ "EXCEL", "SHEETS", "DS", "API", "HUB" ]
Max length50
ExampleSHEETS
filter[tag]
string

Filter by tag

Valid values[ "popular", "quick_connect" ]
Examplepopular
filter[is_new]
string

Filter only new connectors (release date within the last 90 days)

Valid values[ true, false ]
Exampletrue
filter[is_shown_website]
string

Filter only connectors which are shown on website

Valid values[ true, false ]
Exampletrue
Responses
200

List of connectors retrieved successfully

Headers
X-RateLimit-Limit
integer
Request limit per hour
Minimum1
Maximum10000
Example5000
X-RateLimit-Remaining
integer
Remaining requests in current window
Minimum0
Maximum10000
Example4999
Access-Control-Allow-Origin
string
CORS header
Valid values[ "*" ]
Max length255
Example*
Expand All
object
Example{ "meta": { "request_id": "35jtd6pSrTqq8L44zcPTVgYuS5szPsy9" }, "data": { "list": [ { "id": "FA", "name": "Facebook Ads", "marketing_name": "Facebook Ads", "description": "Get ad performance data from Meta Ads Manager.", "status": "Released", "is_premium": true, "logo_url": "https://assets.supermetrics.com/images/dsLogos/FB.png", "categories": [ "Paid media", "Social media" ], "tags": [ "popular" ], "products": [ "EXCEL", "SHEETS", "DS", "API", "HUB" ] } ] } }
meta
object (Meta)
Example{ "request_id": "35jtd6pSrTqq8L44zcPTVgYuS5szPsy9" }
request_id
string

ID of the request. For informational purpose only

Max length50
Pattern^[A-Za-z0-9_-]+$
Example35jtd6pSrTqq8L44zcPTVgYuS5szPsy9
data
object
Example{ "list": [ { "id": "GA", "name": "Google Analytics" } ] }
list
Array of object (DataSourceItem)
Max items1000
object
Example{ "id": "FA", "name": "Facebook Ads", "marketing_name": "Facebook Ads", "description": "Get ad performance data from Meta Ads Manager.", "status": "Released", "is_premium": true, "logo_url": "https://assets.supermetrics.com/images/dsLogos/FB.png", "categories": [ "Paid media", "Social media" ], "tags": [ "popular" ], "products": [ "EXCEL", "SHEETS", "DS", "API", "HUB" ] }
id
string

Connector identifier

Max length50
Pattern^[A-Za-z0-9_-]+$
ExampleFA
name
string

Connector name

Max length255
Pattern^[A-Za-z0-9\s&\-_\.]+$
ExampleFacebook Ads
marketing_name
string

Connector marketing name (can be empty - use name as fallback)

Max length255
Pattern^[A-Za-z0-9\s&\-_\.]*$
ExampleFacebook Ads
description
string

Connector description

Max length1000
Pattern^[A-Za-z0-9\s&\-_\.,!?()]+$
ExampleGet ad performance data from Meta Ads Manager.
status
string

Connector release status

Valid values[ "Development", "Invite only", "Early access", "Released", "Sunsetted" ]
Max length50
ExampleReleased
is_premium
boolean

Is connector premium

Exampletrue
logo_url
string (uri)

Connector logo URL

Max length500
Examplehttps://assets.supermetrics.com/images/dsLogos/FB.png
categories
Array of string

Categories connector belongs to

Max items20
Example[ "Paid media", "Social media" ]
string
Max length100
Pattern^[A-Za-z0-9\s&\-_\.]+$
tags
Array of string

Connector tags

Max items10
Example[ "popular" ]
string
Max length50
Pattern^[a-z_]+$
products
Array of string

Available in products

Max items10
Example[ "EXCEL", "SHEETS", "DS", "API", "HUB" ]
string
Valid values[ "EXCEL", "SHEETS", "DS", "API", "HUB" ]
Max length50
400

Bad request - invalid parameters

Headers
X-RateLimit-Limit
integer
Request limit per hour
Minimum1
Maximum10000
Example5000
X-RateLimit-Remaining
integer
Remaining requests in current window
Minimum0
Maximum10000
Example4999
Access-Control-Allow-Origin
string
CORS header
Valid values[ "*" ]
Max length255
Example*
object

RFC 9457 Problem Details for HTTP APIs

type
string (uri)

A URI reference that identifies the problem type

Max length255
Examplehttps://supermetrics.com/problems/unauthorized
title
string

A short, human-readable summary of the problem type

Max length255
Pattern^[A-Za-z0-9\s]+$
ExampleUnauthorized
status
integer (int32)

The HTTP status code

Minimum100
Maximum599
Example401
detail
string

A human-readable explanation specific to this occurrence

Max length1000
Pattern^[A-Za-z0-9\s.,\-]+$
ExampleAuthentication required
instance
string (uri)

A URI reference that identifies the specific occurrence

Max length255
Examplehttps://api.supermetrics.com/v2/api-keys
401

Unauthorized

Headers
WWW-Authenticate
string
Bearer token required
Max length255
Pattern^Bearer.*
X-RateLimit-Limit
integer
Request limit per hour
Minimum1
Maximum10000
Example5000
X-RateLimit-Remaining
integer
Remaining requests in current window
Minimum0
Maximum10000
Example4999
Access-Control-Allow-Origin
string
CORS header
Valid values[ "*" ]
Max length255
Example*
object

RFC 9457 Problem Details for HTTP APIs

type
string (uri)

A URI reference that identifies the problem type

Max length255
Examplehttps://supermetrics.com/problems/unauthorized
title
string

A short, human-readable summary of the problem type

Max length255
Pattern^[A-Za-z0-9\s]+$
ExampleUnauthorized
status
integer (int32)

The HTTP status code

Minimum100
Maximum599
Example401
detail
string

A human-readable explanation specific to this occurrence

Max length1000
Pattern^[A-Za-z0-9\s.,\-]+$
ExampleAuthentication required
instance
string (uri)

A URI reference that identifies the specific occurrence

Max length255
Examplehttps://api.supermetrics.com/v2/api-keys
403

Access forbidden

Headers
X-RateLimit-Limit
integer
Request limit per hour
Minimum1
Maximum10000
Example5000
X-RateLimit-Remaining
integer
Remaining requests in current window
Minimum0
Maximum10000
Example4999
Access-Control-Allow-Origin
string
CORS header
Valid values[ "*" ]
Max length255
Example*
object

RFC 9457 Problem Details for HTTP APIs

type
string (uri)

A URI reference that identifies the problem type

Max length255
Examplehttps://supermetrics.com/problems/unauthorized
title
string

A short, human-readable summary of the problem type

Max length255
Pattern^[A-Za-z0-9\s]+$
ExampleUnauthorized
status
integer (int32)

The HTTP status code

Minimum100
Maximum599
Example401
detail
string

A human-readable explanation specific to this occurrence

Max length1000
Pattern^[A-Za-z0-9\s.,\-]+$
ExampleAuthentication required
instance
string (uri)

A URI reference that identifies the specific occurrence

Max length255
Examplehttps://api.supermetrics.com/v2/api-keys
422

Unprocessable Entity - validation failed

Headers
X-RateLimit-Limit
integer
Request limit per hour
Minimum1
Maximum10000
Example5000
X-RateLimit-Remaining
integer
Remaining requests in current window
Minimum0
Maximum10000
Example4999
Access-Control-Allow-Origin
string
CORS header
Valid values[ "*" ]
Max length255
Example*
object
type
string (uri)

A URI reference that identifies the problem type

Max length255
Examplehttps://supermetrics.com/problems/unauthorized
title
string

A short, human-readable summary of the problem type

Max length255
Pattern^[A-Za-z0-9\s]+$
ExampleUnauthorized
status
integer (int32)

The HTTP status code

Minimum100
Maximum599
Example401
detail
string

A human-readable explanation specific to this occurrence

Max length1000
Pattern^[A-Za-z0-9\s.,\-]+$
ExampleAuthentication required
instance
string (uri)

A URI reference that identifies the specific occurrence

Max length255
Examplehttps://api.supermetrics.com/v2/api-keys
429

Too Many Requests

Headers
X-RateLimit-Limit
integer
Request limit per hour
Minimum1
Maximum10000
Example5000
X-RateLimit-Remaining
integer
Remaining requests in current window
Minimum0
Maximum10000
Example4999
Retry-After
integer
Seconds until rate limit resets
Minimum1
Maximum86400
Example3600
Access-Control-Allow-Origin
string
CORS header
Valid values[ "*" ]
Max length255
Example*
object

RFC 9457 Problem Details for HTTP APIs

type
string (uri)

A URI reference that identifies the problem type

Max length255
Examplehttps://supermetrics.com/problems/unauthorized
title
string

A short, human-readable summary of the problem type

Max length255
Pattern^[A-Za-z0-9\s]+$
ExampleUnauthorized
status
integer (int32)

The HTTP status code

Minimum100
Maximum599
Example401
detail
string

A human-readable explanation specific to this occurrence

Max length1000
Pattern^[A-Za-z0-9\s.,\-]+$
ExampleAuthentication required
instance
string (uri)

A URI reference that identifies the specific occurrence

Max length255
Examplehttps://api.supermetrics.com/v2/api-keys
500

Internal server error

Headers
Access-Control-Allow-Origin
string
CORS header
Valid values[ "*" ]
Max length255
Example*
object

RFC 9457 Problem Details for HTTP APIs

type
string (uri)

A URI reference that identifies the problem type

Max length255
Examplehttps://supermetrics.com/problems/unauthorized
title
string

A short, human-readable summary of the problem type

Max length255
Pattern^[A-Za-z0-9\s]+$
ExampleUnauthorized
status
integer (int32)

The HTTP status code

Minimum100
Maximum599
Example401
detail
string

A human-readable explanation specific to this occurrence

Max length1000
Pattern^[A-Za-z0-9\s.,\-]+$
ExampleAuthentication required
instance
string (uri)

A URI reference that identifies the specific occurrence

Max length255
Examplehttps://api.supermetrics.com/v2/api-keys