action shutterstock_get_contributor_list {
  label: "Get details about multiple contributors"
  description: "This endpoint lists information about one or more contributors, including contributor type, equipment they use and other attributes."
  provider: shutterstock
  method: GET
  path: "/v2/contributors"
  encoding: json
  input: {
    type: "object"
    properties: {
      id: {
        type: "array"
        items: {
          type: "string"
        }
      }
    }
    required: ["id"]
    additionalProperties: false
  }
  output: {
    description: "List of contributor profiles"
    properties: {
      data: {
        type: "array"
        description: "Conributor profiles"
        items: {
          type: "object"
          description: "Contributor profile data"
          required: ["id"]
          properties: {
            about: {
              type: "string"
              description: "Short description of the contributors' library"
            }
            contributor_type: {
              type: "array"
              description: "Type of content that the contributor specializes in (photographer, illustrator, etc)"
              items: {
                type: "string"
              }
            }
            display_name: {
              type: "string"
              description: "Preferred name to be displayed for the contributor"
            }
            equipment: {
              type: "array"
              description: "List of equipment used by the contributor (Canon EOS 5D Mark II, etc)"
              items: {
                type: "string"
              }
            }
            id: {
              type: "string"
              description: "Contributor ID"
            }
            location: {
              type: "string"
              description: "Country code representing the contributor's locale"
            }
            portfolio_url: {
              type: "string"
              description: "Web URL for the contributors' profile"
            }
            social_media: {
              type: "object"
              description: "Contributor profile social media links"
              properties: {
                facebook: {
                  type: "string"
                  description: "Facebook link for contributor"
                }
                google_plus: {
                  type: "string"
                  description: "Google+ link for contributor"
                }
                linkedin: {
                  type: "string"
                  description: "LinkedIn link for contributor"
                }
                pinterest: {
                  type: "string"
                  description: "Pinterest page for contributor"
                }
                tumblr: {
                  type: "string"
                  description: "Tumblr link for contributor"
                }
                twitter: {
                  type: "string"
                  description: "Twitter link for contributor"
                }
              }
            }
            styles: {
              type: "array"
              description: "List of styles that the contributor specializes in (lifestyle, mixed media, etc)"
              items: {
                type: "string"
              }
            }
            subjects: {
              type: "array"
              description: "Generic list of subjects for contributors' work (food_and_drink, holiday, people, etc)"
              items: {
                type: "string"
              }
            }
            website: {
              type: "string"
              description: "Personal website for the contributor"
            }
          }
        }
      }
      errors: {
        type: "array"
        description: "Error list; appears only if there was an error"
        items: {
          type: "object"
          description: "Error object"
          required: ["message"]
          properties: {
            code: {
              type: "string"
              description: "The error code of this error"
            }
            data: {
              type: "string"
              description: "Debugging information about the error"
            }
            items: {
              type: "array"
              description: "A list of items that produced the error"
              items: {
                type: "object"
              }
            }
            message: {
              type: "string"
              description: "Specific details about this error"
            }
            path: {
              type: "string"
              description: "Internal code reference to the source of the error"
            }
          }
        }
      }
      message: {
        type: "string"
        description: "Error message"
      }
      page: {
        type: "integer"
        description: "Page of response"
      }
      per_page: {
        type: "integer"
        description: "Number of contributors per page"
      }
      total_count: {
        type: "integer"
        description: "Total count of contributors for this request"
      }
    }
  }
}