> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pulsedive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Linked Indicators

> Retrieve indicators linked to a specific feed.




## OpenAPI

````yaml /api/feed/feed-get-links.yaml get /api/feed.php
openapi: 3.0.3
info:
  title: Pulsedive API Reference
  version: 1.0.0
  description: >
    The Pulsedive API lets you programmatically manage resources within
    Pulsedive.

    Users can look up known indicators and threats, enrich and investigate
    indicators, query Pulsedive data, and automate workflows.


    Please report any discrepancies in API behavior to <a
    href="mailto:support@pulsedive.com">Pulsedive Support</a>.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  contact:
    email: support@pulsedive.com
servers:
  - url: https://pulsedive.com
security: []
tags:
  - name: Feeds
    description: Look up feeds.
externalDocs:
  url: https://docs.pulsedive.com
paths:
  /api/feed.php:
    get:
      tags:
        - Feeds
      summary: Get Linked Indicators
      description: |
        Retrieve indicators linked to a specific feed.
      operationId: getFeedLinkedIndicators
      parameters:
        - $ref: '#/components/parameters/APIKey'
        - $ref: '#/components/parameters/FeedID'
        - $ref: '#/components/parameters/Get'
        - $ref: '#/components/parameters/Summary'
        - $ref: '#/components/parameters/SplitRisk'
        - $ref: '#/components/parameters/Pretty'
      responses:
        '200':
          description: Successful request. Returns linked indicators in JSON format.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LinkedIndicatorsResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
      x-codeSamples:
        - lang: curl
          label: Get Linked Indicators
          source: |
            curl "https://pulsedive.com/api/feed.php?iid=1&get=links"
components:
  parameters:
    APIKey:
      name: key
      in: query
      required: false
      description: >
        Your Pulsedive API key.


        API key authentication is optional. However, requests without a key have
        stricter rate limits. We recommend including an API key for better
        performance and reliability.
      schema:
        type: string
    FeedID:
      name: fid
      in: query
      required: true
      description: |
        Unique identifier of the feed to retrieve.
      schema:
        type: string
        example: '1'
    Get:
      name: get
      in: query
      required: true
      description: >
        Indicates which data subset to retrieve. Options include:


        - `links`: Retrieves relationship data showing how the indicator
        connects to other objects.


        Large result sets are automatically paginated. To learn how to handle
        paginated responses, visit [Pagination](/api/pagination).
      schema:
        type: string
        enum:
          - links
    Summary:
      name: summary
      in: query
      description: |
        Summarize the data in the response.

        For summarized data, set to 1.
        For full results, set to 0.
      schema:
        type: integer
        enum:
          - 1
          - 0
        example: 1
    SplitRisk:
      name: splitrisk
      in: query
      description: |
        Split out indicator counts by risk level.

        For risk breakdown, set to 1.
        For non-aggregated results, set to 0.
      schema:
        type: integer
        enum:
          - 1
          - 0
        example: 1
    Pretty:
      name: pretty
      in: query
      required: false
      description: |
        Indicates whether to format returned JSON results.

        For pretty-printed output, set to `1`.
        For compact output, set to `0`.
      schema:
        type: integer
        enum:
          - 0
          - 1
        default: 0
      examples:
        compact:
          summary: Compact output
          value: 0
        pretty:
          summary: Pretty-printed output
          value: 1
  schemas:
    LinkedIndicatorsResponse:
      type: object
      description: Response containing paginated linked indicators.
      properties:
        page_current:
          type: integer
          description: Current page number.
          example: 0
        results:
          type: array
          description: Array of indicators linked to the feed.
          items:
            $ref: '#/components/schemas/LinkedIndicator'
      example:
        page_current: 0
        results:
          - iid: 219
            indicator: servmill.com
            type: domain
            risk: medium
            stamp_linked: '2018-05-08 14:56:18'
            summary:
              properties:
                geo:
                  country: United Kingdom of Great Britain and Northern Ireland
                  region: England
                  city: REDACTED FOR PRIVACY
                  countrycode: GB
                whois:
                  ++privacy: '1'
                  ++gdpr: '1'
    LinkedIndicator:
      type: object
      description: An indicator linked to the queried feed.
      properties:
        iid:
          type: integer
          description: Unique identifier of the linked indicator.
          example: 219
        indicator:
          type: string
          description: Value of the linked indicator.
          example: servmill.com
        type:
          type: string
          description: Type of the linked indicator.
          example: domain
        risk:
          type: string
          description: Risk level of the linked indicator.
          enum:
            - unknown
            - none
            - low
            - medium
            - high
            - critical
            - retired
          example: medium
        stamp_linked:
          type: string
          format: sql-date-time
          pattern: ^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$
          description: >
            Timestamp when the indicator was linked. 24-hour format, UTC time
            zone.
          example: '2018-05-08 14:56:18'
          nullable: true
        summary:
          type: object
          description: >
            Dynamically generated summary data for the linked indicator.
            Structure varies by indicator type and available data.
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Message describing the error that occurred, if available.
  responses:
    BadRequest:
      description: |
        Bad request. The request was malformed or missing required parameters.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: |
        Unauthorized. Your API key is missing or invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFound:
      description: |
        Not found. The requested feed could not be located.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    TooManyRequests:
      description: >
        Rate limit exceeded. Too many requests have been made in a short period
        of time.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalServerError:
      description: |
        Server error. An unexpected problem occurred on our end.
        These errors are automatically reported to our team.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'

````