USusesapient
Visibility

List Top Cited Urls

Changed on

Returns the most cited URLs for GEO analysis and outreach.

Returns URL-level citation counts ranked from most to least cited. Results can be filtered to a single answer platform such as ChatGPT and to owned or external sources. Counts include only runs from currently active prompts.

get/v1/visibility/citations

Request

  • Base URL
    https://api.lightsage.com
  • Auth
    API key in header X-Lightsage-Api-Key

Query parameters

start_datestring date

Optional start date. Defaults to 30 days before the end date.

end_datestring date

Optional end date. Defaults to today.

platformstring

Optional platform ID, name, or slug, such as ChatGPT or chatgpt. Matching is case-insensitive.

source_type'all' | 'owned' | 'external'

Limit results to all cited URLs, owned company URLs, or external URLs.

limitinteger

Maximum number of cited URLs to return.

Response

Successful Response

platformstring nullable

Platform selector applied to the results, or null for all platforms.

source_type'all' | 'owned' | 'external' required

Whether the results include all, owned, or external URLs.

has_databoolean required

Whether any citations matched the selected filters.

countinteger required

Number of URL rows returned.

Changes

  • 2c64a77a3936Revision changes
    • 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