> ## Documentation Index > Fetch the complete documentation index at: https://docs.influship.com/llms.txt > Use this file to discover all available pages before exploring further. # Submit search feedback > Report whether a saved search was helpful. Only the account that owns the search can submit feedback. This endpoint does not consume search credits. ## OpenAPI ````yaml /openapi/openapi.documented.yml post /v1/search/{id}/feedback openapi: 3.1.0 info: title: Influship API version: 1.0.0 description: > Public API for creator search, profile lookup, and campaign-fit analysis. ## Authentication Send your API key in the `X-API-Key` header on every authenticated request. ```bash curl -H "X-API-Key: your_api_key" https://api.influship.com/v1/creators/autocomplete?q=fitness ``` ## Billing and Rate Limits The API uses credit-based billing and credit-based rate limits. - every endpoint has a credit cost - successful responses include `X-Credits-Charged` and `X-Credits-Features` - rate limits are enforced with per-minute and per-hour credit budgets - rate limit state is returned in the `RateLimit-*` headers ## Agentic Payments Use `https://api.influship.com/openapi.json` to discover endpoints that accept x402 v2 or MPP payments without an API key. It includes `402` payment challenges and `x-payment-info` metadata for the available payment methods. ## Pagination List endpoints use cursor pagination. - send `limit` to control page size - use `next_cursor` from the response to fetch the next page - stop when `has_more` is `false` Search has one special rule: - `POST /v1/search` creates a persisted search session - `GET /v1/search/{id}` paginates that session for free - free pagination is capped by the original search `limit` ## Errors Errors use a consistent shape: ```json { "error": { "code": "rate_limit_exceeded", "message": "Rate limit exceeded (per minute)" } } ``` See each operation for exact request and response schemas. contact: name: Influship Support email: support@influship.com license: name: Proprietary url: https://influship.com/terms servers: - url: https://api.influship.com description: Production security: - ApiKeyAuth: [] tags: - name: Shortlists description: Private creator shortlists saved to your API account or OAuth user. - name: Health description: API health and status endpoints - name: Creators description: >- Retrieve creator profiles and discover new creators through search, autocomplete, and lookalike matching. Creators are cross-platform entities that may have profiles on multiple social networks. - name: Profiles description: >- Access individual social media profiles with detailed metrics, growth data, and activity information. Profiles are platform-specific accounts linked to creators. - name: Creator Emails description: >- Look up known creator email addresses by creator ID or social username. Empty or unresolved results are not billable. - name: Posts description: >- Retrieve and analyze social media posts with engagement metrics, media content, and performance data. - name: Search description: >- AI-powered semantic search to find creators using natural language queries. Understands intent and context to match creators based on content themes, audience, and style. - name: Live Scraping description: >- Research Instagram, TikTok, and YouTube profiles, content, metrics, and transcripts with live platform endpoints. paths: /v1/search/{id}/feedback: post: tags: - Search summary: Submit search feedback description: >- Report whether a saved search was helpful. Only the account that owns the search can submit feedback. This endpoint does not consume search credits. operationId: submitSearchFeedback parameters: - schema: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ description: Search ID returned from POST /v1/search example: 123e4567-e89b-12d3-a456-426614174000 in: path name: id required: true description: Search ID returned from POST /v1/search requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SearchFeedbackRequest' responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/SearchFeedbackResponse' '400': description: Validation error response content: application/json: schema: $ref: '#/components/schemas/Error400' '401': description: Authentication error response content: application/json: schema: $ref: '#/components/schemas/Error401' '402': description: >- Authenticated payment required response with a machine-readable billing classification and recovery action. content: application/json: schema: $ref: '#/components/schemas/Error402' '403': description: Permission error response content: application/json: schema: $ref: '#/components/schemas/Error403' '404': description: Not found error response content: application/json: schema: $ref: '#/components/schemas/Error404' '429': description: >- Rate limit exceeded response. Check Retry-After header for backoff timing. Also returned (without RateLimit-* headers) when an IP is temporarily blocked after repeated failed authentication attempts. content: application/json: schema: $ref: '#/components/schemas/Error429' '503': description: >- Service temporarily unavailable. Check Retry-After when present and retry with bounded backoff. content: application/json: schema: $ref: '#/components/schemas/Error503' components: schemas: SearchFeedbackRequest: type: object properties: rating: type: string enum: - helpful - not_helpful description: Whether the search results were useful. reason: type: string enum: - irrelevant_creators - too_few_creators - missing_niche_or_creator - wrong_location - wrong_platform - other details: description: >- Optional explanation. Do not include sensitive or personal information. type: string maxLength: 1000 required: - rating additionalProperties: false SearchFeedbackResponse: type: object properties: data: type: object properties: accepted: type: boolean const: true required: - accepted additionalProperties: false required: - data additionalProperties: false Error400: $ref: '#/components/schemas/Error' description: Validation error response examples: - error: code: validation_error message: 'Invalid value for parameter ''limit'': must be between 1 and 100' param: limit request_id: 550e8400-e29b-41d4-a716-446655440000 Error401: $ref: '#/components/schemas/Error' description: Authentication error response examples: - error: code: unauthorized message: API key missing or invalid request_id: 550e8400-e29b-41d4-a716-446655440000 Error402: type: object properties: error: type: object properties: code: type: string const: payment_required message: type: string status_code: type: number const: 402 reason_code: type: string enum: - BILLING_SUSPENDED - PAYMENT_FAILED - PAYMENT_ACTION_REQUIRED - DISPUTE_OPENED - NO_PAYMENT_METHOD - SUBSCRIPTION_REQUIRED - NO_BUNDLE_CONFIGURED - BUNDLE_EXHAUSTED next_step: type: string enum: - update_payment_method - complete_authentication - contact_support - add_payment_method - reconnect_connection - upgrade_plan request_id: type: string details: type: object propertyNames: type: string additionalProperties: {} required: - code - message - status_code - reason_code - next_step additionalProperties: false required: - error additionalProperties: false description: >- Payment required response. Returned when account billing or a subscription bundle requires attention. examples: - error: code: payment_required message: Payment authentication is required. status_code: 402 reason_code: PAYMENT_ACTION_REQUIRED next_step: complete_authentication request_id: 550e8400-e29b-41d4-a716-446655440000 Error403: $ref: '#/components/schemas/Error' description: Permission error response examples: - error: code: forbidden message: Your plan does not include access to this endpoint request_id: 550e8400-e29b-41d4-a716-446655440000 Error404: $ref: '#/components/schemas/Error' description: Not found error response examples: - error: code: not_found message: Creator with ID '123e4567-e89b-12d3-a456-426614174000' not found request_id: 550e8400-e29b-41d4-a716-446655440000 Error429: $ref: '#/components/schemas/Error' description: >- Rate limit exceeded response. Check Retry-After header for backoff timing. Also returned (without RateLimit-* headers) when an IP is temporarily blocked after repeated failed authentication attempts. examples: - error: code: rate_limit_exceeded message: Rate limit exceeded (per minute) request_id: 550e8400-e29b-41d4-a716-446655440000 - error: code: rate_limit_exceeded message: Rate limit exceeded (per hour) request_id: 550e8400-e29b-41d4-a716-446655440001 - error: code: rate_limit_exceeded message: Too many failed authentication attempts. Please try again later. request_id: 550e8400-e29b-41d4-a716-446655440002 Error503: $ref: '#/components/schemas/Error' description: >- Service temporarily unavailable. Check Retry-After when present and retry with bounded backoff. examples: - error: code: service_unavailable message: >- Live Instagram data is temporarily unavailable. Please retry shortly. request_id: 550e8400-e29b-41d4-a716-446655440000 details: retry_after_seconds: 60 upstream_error: upstream_rate_limited Error: type: object properties: error: type: object properties: code: $ref: '#/components/schemas/ErrorCode' description: Machine-readable error code message: type: string description: Human-readable error message example: Request validation failed status_code: description: >- HTTP status code repeated for clients that consume the error body example: 402 type: integer minimum: -9007199254740991 maximum: 9007199254740991 param: description: Parameter that caused the error (if applicable) example: query type: string request_id: description: >- Optional request ID for debugging. Read the X-Request-Id response header when absent. example: 550e8400-e29b-41d4-a716-446655440000 type: string details: description: Structured error context (e.g., field-level validation issues) type: object propertyNames: type: string additionalProperties: {} required: - code - message additionalProperties: false required: - error additionalProperties: false ErrorCode: type: string enum: - validation_error - invalid_parameter - missing_parameter - unauthorized - forbidden - payment_required - insufficient_credits - not_found - rate_limit_exceeded - quota_exceeded - internal_error - service_unavailable - upstream_contract_broken - database_error - seed_not_found - invalid_seeds - seed_resolution_failed - lookalike_failed - get_profiles_failed - post_analysis_failed - match_failed - scraping_failed - transcript_unavailable - transcript_not_available - transcription_limit_exceeded - transcription_unavailable description: Machine-readable error code for programmatic handling example: validation_error securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.