SEsearchable
Sources

List cited source domains

Changed on

Top cited source domains from AI answers — rank, citation counts, usage %, models, and top content types. Paginated and sortable. days defaults to 30. limit defaults to 20, max 1000 (over-cap values clamp). A domain with source classification rules also carries types, parts, typeBreakdown and ruleCount; withRules=true lists only those domains.

get/api/mcp/projects/{projectId}/sources/domains

Request

  • Base URL
    https://app.searchable.com
  • Auth
    HTTP bearer

Path parameters

projectIdstring uuid required

The project id.

Query parameters

daysinteger

Lookback window in days. Default and maximum vary by endpoint — see the operation description.

sortstring

Sort key, optionally prefixed - for descending (e.g. -citations). Accepts citations, usage, avgCitations.

platformstring

Comma-separated AI platform filter (e.g. chatgpt,claude,gemini). Accepted values and whether the param is required vary by endpoint — see the operation description.

topicIdstring uuid

Restrict to a single topic id.

unbranded'true'

Pass true to restrict every metric to non-branded prompts only.

branded'true'

Pass true to restrict every metric to branded prompts only.

countrystring

Comma-separated ISO 3166-1 country codes (e.g. US,GB) or country names.

locationIdstring

Comma-separated tracked-location ids.

limitinteger

Page size. Defaults and caps vary by endpoint (see each operation's description); big list endpoints (cited domains/URLs, prompts, opportunities) cap at 1000, issues at 5000. Values above an endpoint's cap are clamped server-side, never rejected.

offsetinteger

Row offset for pagination.

sourceTypestring

Comma-separated source-type filter: brand,competitor,editorial,social,forum,review,institutional,third_party,other.

format'json' | 'csv'

Response format. csv returns the operation's main row set as a downloadable UTF-8 CSV (RFC 4180, BOM-prefixed, spreadsheet-formula-hardened) instead of the JSON envelope. Pagination params apply unchanged — export beyond one page by walking offsets.

withRulesboolean

true lists only the domains with at least one source classification rule.

Response

Cited source domains.

totalSourcesinteger required
totalCitationsinteger

Compatibility alias for totalSources, used by some clients.

nextCursorstring
hasMoreboolean required
successboolean required

Always true — injected on every success response by this endpoint family's response wrapper.

Changes

  • a1cc70e46e73Revision changes
    • info

      added the new optional query request parameter branded

  • 28a5e2a65cd3Revision changes
    • breaking

      the // response's property type changed from integer to number for status

    • warning

      added the new duplicate_scope enum value to the response property for the response status

    • warning

      added the new duplicate_scope enum value to the response property for the response status

    • warning

      added the new duplicate_scope enum value to the response property for the response status

    • warning

      added the new duplicate_scope enum value to the response property for the response status

    • warning

      added the new duplicate_scope enum value to the response property for the response status

    • warning

      added the new duplicate_scope enum value to the response property for the response status

    • warning

      added the new host_outside_domain enum value to the response property for the response status

    • warning

      added the new host_outside_domain enum value to the response property for the response status

    • warning

      added the new host_outside_domain enum value to the response property for the response status

    • warning

      added the new host_outside_domain enum value to the response property for the response status

    • warning

      added the new host_outside_domain enum value to the response property for the response status

    • warning

      added the new host_outside_domain enum value to the response property for the response status

    • warning

      added the new idempotency_conflict enum value to the response property for the response status

    • warning

      added the new idempotency_conflict enum value to the response property for the response status

    • warning

      added the new idempotency_conflict enum value to the response property for the response status

    • warning

      added the new idempotency_conflict enum value to the response property for the response status

    • warning

      added the new idempotency_conflict enum value to the response property for the response status

    • warning

      added the new idempotency_conflict enum value to the response property for the response status

    • warning

      added the new invalid_citation_type enum value to the response property for the response status

    • warning

      added the new invalid_citation_type enum value to the response property for the response status

    • warning

      added the new invalid_citation_type enum value to the response property for the response status

    • warning

      added the new invalid_citation_type enum value to the response property for the response status

    • warning

      added the new invalid_citation_type enum value to the response property for the response status

    • warning

      added the new invalid_citation_type enum value to the response property for the response status

    • warning

      added the new invalid_scope enum value to the response property for the response status

    • warning

      added the new invalid_scope enum value to the response property for the response status

    • warning

      added the new invalid_scope enum value to the response property for the response status

    • warning

      added the new invalid_scope enum value to the response property for the response status

    • warning

      added the new invalid_scope enum value to the response property for the response status

    • warning

      added the new invalid_scope enum value to the response property for the response status

    • warning

      added the new missing_competitor enum value to the response property for the response status

    • warning

      added the new missing_competitor enum value to the response property for the response status

    • warning

      added the new missing_competitor enum value to the response property for the response status

    • warning

      added the new missing_competitor enum value to the response property for the response status

    • warning

      added the new missing_competitor enum value to the response property for the response status

    • warning

      added the new missing_competitor enum value to the response property for the response status

    • warning

      added the new rule_limit enum value to the response property for the response status

    • warning

      added the new rule_limit enum value to the response property for the response status

    • warning

      added the new rule_limit enum value to the response property for the response status

    • warning

      added the new rule_limit enum value to the response property for the response status

    • warning

      added the new rule_limit enum value to the response property for the response status

    • warning

      added the new rule_limit enum value to the response property for the response status

    • warning

      added the new security_policy_denied enum value to the response property for the response status

    • warning

      added the new security_policy_denied enum value to the response property for the response status

    • warning

      added the new security_policy_denied enum value to the response property for the response status

    • warning

      added the new security_policy_denied enum value to the response property for the response status

    • warning

      added the new security_policy_denied enum value to the response property for the response status

    • warning

      added the new security_policy_denied enum value to the response property for the response status

    • warning

      added the new unknown_competitor enum value to the response property for the response status

    • warning

      added the new unknown_competitor enum value to the response property for the response status

    • warning

      added the new unknown_competitor enum value to the response property for the response status

    • warning

      added the new unknown_competitor enum value to the response property for the response status

    • warning

      added the new unknown_competitor enum value to the response property for the response status

    • warning

      added the new unknown_competitor enum value to the response property for the response status

    • info

      added the new optional query request parameter format

    • info

      added the new optional query request parameter withRules

    • info

      added the media type text/csv for the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status