SEsearchable
Sources

List all cited URLs

Changed on

All cited URLs across a project, with domain, title, content type, and citation counts. Paginated by offset (or the legacy cursor). limit defaults to 20, max 1000 (over-cap values clamp). days defaults to 30.

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

Request

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

Path parameters

projectIdstring uuid required

The project id.

Query parameters

contentTypestring

Filter cited URLs to a specific content type.

daysinteger

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

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.

cursorstring

Opaque pagination cursor from a previous response's nextCursor. Omit for the first page.

sourceTypestring

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

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.

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.

Response

Cited URLs.

totalUrlsinteger required
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
    • 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 media type text/csv for the response with the status