{"openapi":"3.1.0","info":{"title":"Influship API","version":"1.0.0","description":"Public API for creator search, profile lookup, and campaign-fit analysis.\n\n## Authentication\n\nSend your API key in the `X-API-Key` header on every authenticated request.\n\n```bash\ncurl -H \"X-API-Key: your_api_key\" https://api.influship.com/v1/creators/autocomplete?q=fitness\n```\n\n## Billing and Rate Limits\n\nThe API uses credit-based billing and credit-based rate limits.\n\n- every endpoint has a credit cost\n- successful responses include `X-Credits-Charged` and `X-Credits-Features`\n- rate limits are enforced with per-minute and per-hour credit budgets\n- rate limit state is returned in the `RateLimit-*` headers\n\n## Pagination\n\nList endpoints use cursor pagination.\n\n- send `limit` to control page size\n- use `next_cursor` from the response to fetch the next page\n- stop when `has_more` is `false`\n\nSearch has one special rule:\n\n- `POST /v1/search` creates a persisted search session\n- `GET /v1/search/{id}` paginates that session for free\n- free pagination is capped by the original search `limit`\n\n## Errors\n\nErrors use a consistent shape:\n\n```json\n{\n  \"error\": {\n    \"code\": \"rate_limit_exceeded\",\n    \"message\": \"Rate limit exceeded (per minute)\"\n  }\n}\n```\n\nSee each operation for exact request and response schemas.\n","contact":{"name":"Influship Support","email":"support@influship.com"},"license":{"name":"Proprietary","url":"https://influship.com/terms"},"x-guidance":"Use the operation requestBody and query/path parameter schemas exactly as declared. Paid operations return HTTP 402 with x402 v2 and MPP payment challenges when called without payment; retry the same request with either x402 X-PAYMENT or MPP Authorization: Payment credentials."},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"},"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"Platform":{"type":"string","enum":["instagram"],"description":"Social media platform","example":"instagram"},"LookalikeRequest":{"type":"object","properties":{"seeds":{"minItems":1,"maxItems":10,"type":"array","items":{"$ref":"#/components/schemas/LookalikeSeed"},"description":"Seed creators to find similar creators for"},"filters":{"description":"Additional filters","$ref":"#/components/schemas/CommonFilters"},"limit":{"default":25,"description":"Maximum results to return","example":25,"type":"integer","minimum":1,"maximum":100},"cursor":{"description":"Pagination cursor for next page","type":"string"}},"required":["seeds"],"description":"Find similar creators request","examples":[{"seeds":[{"platform":"instagram","username":"fitness_coach_jane"}],"limit":20},{"seeds":[{"creator_id":"123e4567-e89b-12d3-a456-426614174000","weight":1},{"platform":"instagram","username":"wellness_guru","weight":0.5}],"filters":{"followers":{"min":25000}},"limit":25}]},"LookalikeSeed":{"type":"object","properties":{"creator_id":{"description":"Creator ID (use this OR platform+username)","example":"123e4567-e89b-12d3-a456-426614174000","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)$"},"platform":{"description":"Platform (required with username)","$ref":"#/components/schemas/Platform"},"username":{"description":"Username (required with platform)","example":"fitness_coach_jane","type":"string","minLength":1,"maxLength":50},"weight":{"default":1,"description":"Weight for this seed (0-1)","example":1,"type":"number","minimum":0,"maximum":1}},"description":"Seed creator for lookalike search"},"CommonFilters":{"type":"object","properties":{"followers":{"description":"Filter by follower count","$ref":"#/components/schemas/FollowersFilter"},"engagement_rate":{"description":"Filter by engagement rate","$ref":"#/components/schemas/EngagementRateFilter"},"verified":{"description":"Filter by verified status","example":true,"type":"boolean"}},"description":"Common filters for creator discovery"},"FollowersFilter":{"type":"object","properties":{"min":{"description":"Minimum follower count","example":10000,"type":"number","minimum":0},"max":{"description":"Maximum follower count","example":500000,"type":"number","minimum":0}},"description":"Filter by follower count range"},"EngagementRateFilter":{"type":"object","properties":{"min":{"description":"Minimum engagement rate (%)","example":1.5,"type":"number","minimum":0,"maximum":100},"max":{"description":"Maximum engagement rate (%)","example":10,"type":"number","minimum":0,"maximum":100}},"description":"Filter by engagement rate range"},"MatchRequest":{"type":"object","properties":{"creators":{"minItems":1,"maxItems":100,"type":"array","items":{"$ref":"#/components/schemas/MatchCreatorInput"},"description":"Creators to evaluate"},"intent":{"$ref":"#/components/schemas/MatchIntent"}},"required":["creators","intent"],"description":"Score campaign fit request","examples":[{"creators":[{"platform":"instagram","username":"fitness_coach_jane"},{"creator_id":"123e4567-e89b-12d3-a456-426614174000"}],"intent":{"query":"Promote our new plant-based protein powder","context":"Target audience is health-conscious millennials interested in sustainable fitness"}}]},"MatchCreatorInput":{"type":"object","properties":{"creator_id":{"description":"Creator ID (use this OR platform+username)","example":"123e4567-e89b-12d3-a456-426614174000","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)$"},"platform":{"description":"Platform (required with username)","$ref":"#/components/schemas/Platform"},"username":{"description":"Username (required with platform)","example":"fitness_coach_jane","type":"string","minLength":1,"maxLength":50}},"description":"Creator identifier for match endpoint"},"MatchIntent":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":500,"description":"Campaign description","example":"Looking for fitness influencers to promote our new protein bar"},"context":{"description":"Additional context about the campaign","example":"Target audience is health-conscious millennials","type":"string","maxLength":2000}},"required":["query"],"description":"Campaign intent for creator matching"},"CreatorEmailsLookupRequest":{"type":"object","properties":{"creators":{"minItems":1,"maxItems":100,"type":"array","items":{"$ref":"#/components/schemas/CreatorEmailLookupInput"},"description":"Creator lookups to resolve. Response rows preserve this input order."}},"required":["creators"],"description":"Creator email lookup request"},"CreatorEmailLookupInput":{"anyOf":[{"$ref":"#/components/schemas/CreatorEmailLookupById"},{"$ref":"#/components/schemas/CreatorEmailLookupByHandle"}],"description":"Creator email lookup input by creator ID or social handle"},"CreatorEmailLookupById":{"type":"object","properties":{"creator_id":{"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":"Creator profile ID to look up directly","example":"123e4567-e89b-12d3-a456-426614174000"}},"required":["creator_id"],"description":"Creator email lookup input by creator ID"},"CreatorEmailLookupByHandle":{"type":"object","properties":{"platform":{"description":"Social platform for handle-based lookup","$ref":"#/components/schemas/Platform"},"username":{"type":"string","minLength":1,"maxLength":100,"description":"Social username for handle-based lookup","example":"fitness_coach_jane"}},"required":["platform","username"],"description":"Creator email lookup input by social handle"},"SearchRequest":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":500,"description":"Natural language search query","example":"fitness influencers with 100k+ followers who post workout videos"},"platforms":{"description":"Filter results to specific platforms","example":["instagram"],"type":"array","items":{"$ref":"#/components/schemas/Platform"}},"filters":{"description":"Additional filters","$ref":"#/components/schemas/CommonFilters"},"limit":{"default":25,"description":"Maximum results to return","example":25,"type":"integer","minimum":1,"maximum":100},"creator_kinds":{"description":"Restrict results to specific creator kinds (e.g. INFLUENCER vs THEME_PAGE). Omit for no filter.","example":["INFLUENCER"],"minItems":1,"type":"array","items":{"type":"string","enum":["INFLUENCER","THEME_PAGE"]}}},"required":["query"],"description":"AI-powered semantic search request","examples":[{"query":"fitness influencers who post workout videos","limit":10},{"query":"sustainable fashion creators","platforms":["instagram"],"filters":{"followers":{"min":50000,"max":500000},"engagement_rate":{"min":2},"verified":true},"limit":25,"creator_kinds":["INFLUENCER"]}]},"ProfilesLookupRequest":{"type":"object","properties":{"profiles":{"minItems":1,"maxItems":100,"type":"array","items":{"$ref":"#/components/schemas/ProfileLookupItem"},"description":"Profiles to lookup"}},"required":["profiles"],"description":"Batch lookup profiles request","examples":[{"profiles":[{"platform":"instagram","username":"fitness_coach_jane"},{"platform":"instagram","username":"wellness_guru"},{"platform":"instagram","username":"healthy_eating_tips"}]}]},"ProfileLookupItem":{"type":"object","properties":{"platform":{"$ref":"#/components/schemas/Platform"},"username":{"type":"string","minLength":1,"maxLength":50,"description":"Username to lookup","example":"fitness_coach_jane"}},"required":["platform","username"]},"PostSort":{"type":"string","enum":["recent","top_engagement","most_likes","most_views","most_comments"],"description":"Sort order for posts","example":"recent"},"LiveInstagramPostBatchBody":{"type":"object","properties":{"shortcodes":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","minLength":1},"description":"Instagram post shortcodes from /p/, /reel/, or /tv/ URLs","example":["C0ABC123xyz","D1DEF456uvw"]}},"required":["shortcodes"]},"LiveInstagramTranscriptBatchBody":{"type":"object","properties":{"shortcodes":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","minLength":1},"description":"Instagram video post shortcodes from /p/, /reel/, or /tv/ URLs","example":["C0ABC123xyz","D1DEF456uvw"]},"language":{"description":"Optional language code for transcription. Omit to auto-detect.","example":"en","type":"string"}},"required":["shortcodes"]},"HealthResponse":{"type":"object","properties":{"ok":{"type":"boolean","description":"Service health status","example":true},"timestamp":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Current server timestamp","example":"2024-01-15T14:30:00.000Z"}},"required":["ok","timestamp"],"additionalProperties":false,"description":"Health check response"},"Error500":{"description":"Internal server error response","examples":[{"error":{"code":"internal_error","message":"An unexpected error occurred. Please try again later.","request_id":"550e8400-e29b-41d4-a716-446655440000"}}],"$ref":"#/components/schemas/Error"},"ErrorCode":{"type":"string","enum":["validation_error","invalid_parameter","missing_parameter","unauthorized","forbidden","payment_required","not_found","rate_limit_exceeded","internal_error","service_unavailable","database_error","seed_not_found","invalid_seeds","seed_resolution_failed","lookalike_failed","get_profiles_failed","post_analysis_failed","match_failed","scraping_failed","transcript_unavailable"],"description":"Machine-readable error code for programmatic handling","example":"validation_error"},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"description":"Machine-readable error code","$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string","description":"Human-readable error message","example":"Request validation failed"},"param":{"description":"Parameter that caused the error (if applicable)","example":"query","type":"string"},"request_id":{"description":"Request ID for debugging","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},"AutocompleteResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/AutocompleteResultItem"},"description":"Autocomplete results"}},"required":["data"],"additionalProperties":false},"AutocompleteResultItem":{"type":"object","properties":{"id":{"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":"Creator ID","example":"123e4567-e89b-12d3-a456-426614174000"},"name":{"type":"string","description":"Creator name","example":"Jane Fitness"},"avatar":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Avatar URL","example":"https://cdn.example.com/avatars/jane.jpg"},"platforms":{"type":"array","items":{"$ref":"#/components/schemas/AutocompletePlatformMatch"},"description":"Matching platforms"}},"required":["id","name","avatar","platforms"],"additionalProperties":false},"AutocompletePlatformMatch":{"type":"object","properties":{"platform":{"$ref":"#/components/schemas/Platform"},"username":{"type":"string","example":"fitness_coach_jane"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"example":"Jane Fitness"},"match_type":{"type":"string","enum":["name","username","display_name"],"description":"How the query matched this profile","example":"username"},"match_field":{"type":"string","description":"The field value that matched","example":"fitness_coach_jane"}},"required":["platform","username","display_name","match_type","match_field"],"additionalProperties":false},"Error400":{"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"}}],"$ref":"#/components/schemas/Error"},"Error401":{"description":"Authentication error response","examples":[{"error":{"code":"unauthorized","message":"API key missing or invalid","request_id":"550e8400-e29b-41d4-a716-446655440000"}}],"$ref":"#/components/schemas/Error"},"Error403":{"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"}}],"$ref":"#/components/schemas/Error"},"Error429":{"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"}}],"$ref":"#/components/schemas/Error"},"CreatorResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/CreatorResponseData"},"warning":{"description":"Present when partial results were returned because one or more linked profiles were skipped for data integrity reasons.","type":"string"}},"required":["data"],"additionalProperties":false},"CreatorResponseData":{"type":"object","properties":{"id":{"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":"Creator unique identifier","example":"123e4567-e89b-12d3-a456-426614174000"},"name":{"type":"string","description":"Creator display name","example":"Jane Fitness"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Creator bio","example":"Fitness coach & wellness advocate"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Avatar URL","example":"https://cdn.example.com/avatars/jane.jpg"},"ai_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"AI-generated summary of the creator","example":"A fitness influencer focused on home workouts and healthy eating"},"audience_demographics":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Synthesized audience demographic summary","example":"Young adults interested in practical wellness routines and meal prep"},"brand_alignment":{"type":"array","items":{"type":"string"},"description":"Brand categories this creator is likely to align with","example":["fitness apparel","nutrition","wellness apps"]},"content_themes":{"type":"array","items":{"type":"string"},"description":"Content themes/topics","example":["fitness","nutrition","wellness"]},"key_facts":{"type":"array","items":{"type":"string"},"description":"Synthesized facts and notable context about the creator","example":["Runs weekly workout challenges","Often features meal prep content"]},"vibe_and_aesthetics":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Synthesized description of visual style and tone","example":"Bright, practical, and encouraging with clean gym and kitchen visuals"},"profiles":{"description":"Social profiles (only included when include=profiles)","type":"array","items":{"$ref":"#/components/schemas/ProfileSummary"}}},"required":["id","name","bio","avatar_url","ai_summary","audience_demographics","brand_alignment","content_themes","key_facts","vibe_and_aesthetics"],"additionalProperties":false,"description":"Full creator details"},"ProfileSummary":{"type":"object","properties":{"id":{"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":"Profile unique identifier","example":"123e4567-e89b-12d3-a456-426614174000"},"platform":{"$ref":"#/components/schemas/Platform"},"username":{"type":"string","description":"Profile username","example":"fitness_coach_jane"},"url":{"type":"string","format":"uri","description":"Profile URL","example":"https://www.instagram.com/fitness_coach_jane"},"followers":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Follower count (null if unknown)","example":125000},"engagement_rate":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"Engagement rate as a percentage, null if unknown (e.g. 3.5 means 3.5%)","example":3.5},"is_verified":{"type":"boolean","description":"Whether the account is verified","example":true}},"required":["id","platform","username","url","followers","engagement_rate","is_verified"],"additionalProperties":false,"description":"Abbreviated profile information"},"Error404":{"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"}}],"$ref":"#/components/schemas/Error"},"LookalikeResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/LookalikeResponseData"},"has_more":{"type":"boolean","description":"Whether more results are available","example":true},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Cursor for the next page","example":"eyJvZmZzZXQiOjI1fQ=="}},"required":["data","has_more","next_cursor"],"additionalProperties":false},"LookalikeResponseData":{"type":"array","items":{"$ref":"#/components/schemas/LookalikeResultItem"}},"LookalikeResultItem":{"type":"object","properties":{"creator":{"$ref":"#/components/schemas/CreatorBasic"},"primary_profile":{"anyOf":[{"$ref":"#/components/schemas/ProfileSummary"},{"type":"null"}],"description":"Primary profile (largest audience, null if no profile data available)"},"similarity":{"$ref":"#/components/schemas/SimilarityInfo"}},"required":["creator","primary_profile","similarity"],"additionalProperties":false},"CreatorBasic":{"type":"object","properties":{"id":{"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":"Creator unique identifier","example":"123e4567-e89b-12d3-a456-426614174000"},"name":{"type":"string","description":"Creator display name","example":"Jane Fitness"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Creator bio","example":"Fitness coach & wellness advocate"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Avatar URL","example":"https://cdn.example.com/avatars/jane.jpg"}},"required":["id","name","bio","avatar_url"],"additionalProperties":false,"description":"Basic creator information"},"SimilarityInfo":{"type":"object","properties":{"score":{"type":"number","minimum":0,"maximum":1,"description":"Similarity score (0-1)","example":0.78},"shared_traits":{"type":"array","items":{"type":"string"},"description":"Shared traits with seed creators","example":["Similar content style","Same niche audience"]}},"required":["score","shared_traits"],"additionalProperties":false,"description":"Similarity information for lookalike match"},"MatchResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/MatchResponseData"}},"required":["data"],"additionalProperties":false},"MatchResponseData":{"type":"array","items":{"$ref":"#/components/schemas/MatchResultItem"}},"MatchResultItem":{"type":"object","properties":{"creator":{"type":"object","properties":{"id":{"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)$"},"name":{"type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","avatar_url"],"additionalProperties":false},"input":{"type":"object","properties":{"creator_id":{"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)$"},"platform":{"$ref":"#/components/schemas/Platform"},"username":{"type":"string"}},"additionalProperties":false},"match":{"$ref":"#/components/schemas/MatchResult"}},"required":["creator","input","match"],"additionalProperties":false},"MatchResult":{"type":"object","properties":{"score":{"type":"number","minimum":0,"maximum":1,"description":"Match score (0-1)","example":0.85},"decision":{"$ref":"#/components/schemas/MatchDecision"},"reasons":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Human-readable reason for the match","example":"Strong fit due to fitness content focus and engaged audience"},"fact_id":{"description":"ID of the supporting fact, if applicable","type":"string"},"source_post_id":{"description":"ID of the source post, if applicable","type":"string"}},"required":["text"],"additionalProperties":false},"description":"Structured reasons supporting the decision"}},"required":["score","decision","reasons"],"additionalProperties":false},"MatchDecision":{"type":"string","enum":["good","neutral","avoid"],"description":"Match decision recommendation","example":"good"},"CreatorEmailsLookupResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/CreatorEmailsLookupResult"}},"billing":{"$ref":"#/components/schemas/CreatorEmailsBilling"}},"required":["results","billing"],"additionalProperties":false}},"required":["data"],"additionalProperties":false,"description":"Creator email lookup response"},"CreatorEmailsLookupResult":{"type":"object","properties":{"input":{"$ref":"#/components/schemas/CreatorEmailLookupInputOutput"},"creator_id":{"anyOf":[{"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)$"},{"type":"null"}],"description":"Resolved creator ID, or null when the input could not be resolved","example":"123e4567-e89b-12d3-a456-426614174000"},"resolved":{"type":"boolean","description":"Whether the lookup resolved to a creator profile","example":true},"emails":{"type":"array","items":{"$ref":"#/components/schemas/CreatorEmailItem"},"description":"API-visible emails for the resolved creator. Empty results are not billable."}},"required":["input","creator_id","resolved","emails"],"additionalProperties":false,"description":"Creator email lookup result"},"CreatorEmailItem":{"type":"object","properties":{"email":{"type":"string","minLength":1,"description":"Email address as stored, preserving original casing","example":"hello@example.com"},"status":{"$ref":"#/components/schemas/CreatorEmailStatus"},"confidence":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}],"description":"Nullable confidence score for the email","example":0.72},"is_primary":{"type":"boolean","description":"Whether this is the primary email for the creator","example":false},"validated_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}],"description":"When the email was last validated, if known","example":null},"first_seen_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"When Influship first observed this email","example":"2026-05-01T00:00:00Z"},"last_seen_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"When Influship most recently observed this email","example":"2026-05-02T00:00:00Z"}},"required":["email","status","confidence","is_primary","validated_at","first_seen_at","last_seen_at"],"additionalProperties":false,"description":"API-visible creator email"},"CreatorEmailStatus":{"type":"string","enum":["unvalidated","valid","risky","creator_verified"],"description":"API-visible email validation status","example":"unvalidated"},"CreatorEmailsBilling":{"type":"object","properties":{"billable_results":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unique resolved creators with at least one returned email","example":1},"credits_charged":{"type":"number","minimum":0,"description":"Preview of credits charged for this lookup","example":5}},"required":["billable_results","credits_charged"],"additionalProperties":false,"description":"Creator email lookup billing summary"},"SearchResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/SearchResponseData"},"search_id":{"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. Use with GET /v1/search/{id} for free pagination.","example":"123e4567-e89b-12d3-a456-426614174000"},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Total number of results across all pages","example":87},"has_more":{"type":"boolean","description":"Whether more results are available","example":true},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Cursor for the next page","example":"eyJvZmZzZXQiOjI1fQ=="}},"required":["data","search_id","total","has_more","next_cursor"],"additionalProperties":false},"SearchResponseData":{"type":"array","items":{"$ref":"#/components/schemas/SearchResultItem"}},"SearchResultItem":{"type":"object","properties":{"creator":{"$ref":"#/components/schemas/CreatorBasic"},"relevant_profile":{"anyOf":[{"$ref":"#/components/schemas/ProfileSummary"},{"type":"null"}],"description":"Most relevant profile based on search query (null if no profile data available)"},"primary_profile":{"anyOf":[{"$ref":"#/components/schemas/ProfileSummary"},{"type":"null"}],"description":"Primary profile (largest audience, null if no profile data available)"},"match":{"$ref":"#/components/schemas/MatchInfo"}},"required":["creator","relevant_profile","primary_profile","match"],"additionalProperties":false},"MatchInfo":{"type":"object","properties":{"score":{"type":"number","minimum":0,"maximum":1,"description":"Match relevance score (0-1)","example":0.85},"reasons":{"type":"array","items":{"type":"string"},"description":"Human-readable match reasons","example":["Active fitness content creator","High engagement on workout posts"]}},"required":["score","reasons"],"additionalProperties":false,"description":"Search match information"},"Error503":{"description":"Service unavailable response. Live data endpoints may return this for temporary upstream platform throttling; check Retry-After before retrying.","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"}}}],"$ref":"#/components/schemas/Error"},"ProfileResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ProfileResponseData"},"warning":{"description":"Present when partial results were returned because profile metrics/data were skipped due to integrity issues.","type":"string"}},"required":["data"],"additionalProperties":false},"ProfileResponseData":{"type":"object","properties":{"id":{"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":"Profile unique identifier","example":"123e4567-e89b-12d3-a456-426614174000"},"creator_id":{"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":"Creator unique identifier","example":"123e4567-e89b-12d3-a456-426614174001"},"platform":{"$ref":"#/components/schemas/Platform"},"username":{"type":"string","description":"Profile username","example":"fitness_coach_jane"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Display name","example":"Jane Fitness"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Profile bio","example":"Fitness coach & wellness advocate"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Avatar URL","example":"https://cdn.example.com/avatars/jane.jpg"},"url":{"type":"string","format":"uri","description":"Profile URL","example":"https://www.instagram.com/fitness_coach_jane"},"external_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"External website URL from bio","example":"https://janefitness.com"},"is_verified":{"type":"boolean","description":"Whether the account is verified","example":true},"is_business":{"type":"boolean","description":"Whether this is a business account","example":true},"is_private":{"type":"boolean","description":"Whether the account is private","example":false},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Account category","example":"Health/Beauty"},"pronouns":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Listed pronouns","example":["she","her"]},"metrics":{"$ref":"#/components/schemas/ProfileMetrics"},"growth":{"$ref":"#/components/schemas/ProfileGrowth"},"activity":{"$ref":"#/components/schemas/ProfileActivity"},"data_updated_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}],"description":"Last data refresh timestamp","example":"2024-01-15T14:30:00Z"}},"required":["id","creator_id","platform","username","display_name","bio","avatar_url","url","external_url","is_verified","is_business","is_private","category","pronouns","metrics","growth","activity","data_updated_at"],"additionalProperties":false,"description":"Full profile details"},"ProfileMetrics":{"type":"object","properties":{"followers":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Follower count","example":125000},"following":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Following count","example":1200},"posts":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Total post count","example":450},"posts_last_30d":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Posts in the last 30 days","example":12},"engagement_rate":{"type":"number","minimum":0,"description":"Engagement rate as a percentage (e.g. 3.5 means 3.5%)","example":3.5},"avg_likes_recent":{"type":"number","minimum":0,"description":"Average likes on recent posts","example":4500},"avg_comments_recent":{"type":"number","minimum":0,"description":"Average comments on recent posts","example":120},"avg_views_recent":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"Average views on recent posts (for video content)","example":15000},"posts_per_week":{"type":"number","minimum":0,"description":"Average posts per week","example":2.5}},"required":["followers","following","posts","posts_last_30d","engagement_rate","avg_likes_recent","avg_comments_recent","avg_views_recent","posts_per_week"],"additionalProperties":false,"description":"Profile performance metrics"},"ProfileGrowth":{"type":"object","properties":{"followers_30d_pct":{"type":"number","description":"Follower growth percentage over 30 days (e.g. 2.5 means +2.5%)","example":2.5}},"required":["followers_30d_pct"],"additionalProperties":false,"description":"Profile growth statistics"},"ProfileActivity":{"type":"object","properties":{"last_post_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}],"description":"Timestamp of last post","example":"2024-01-15T14:30:00Z"}},"required":["last_post_at"],"additionalProperties":false,"description":"Profile activity information"},"ProfilesLookupResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ProfileResponseData"},"description":"Profiles that were found"},"not_found":{"type":"array","items":{"$ref":"#/components/schemas/ProfileNotFoundItem"},"description":"Profiles that were not found"}},"required":["data","not_found"],"additionalProperties":false},"ProfileNotFoundItem":{"type":"object","properties":{"platform":{"$ref":"#/components/schemas/Platform"},"username":{"type":"string","example":"unknown_user"}},"required":["platform","username"],"additionalProperties":false},"PostsResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/PostsResponseData"},"has_more":{"type":"boolean","description":"Whether more results are available","example":true},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Cursor for the next page of results","example":"eyJvZmZzZXQiOjI1fQ=="}},"required":["data","has_more","next_cursor"],"additionalProperties":false},"PostsResponseData":{"type":"array","items":{"$ref":"#/components/schemas/PostResponseData"}},"PostResponseData":{"type":"object","properties":{"id":{"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":"Post unique identifier","example":"123e4567-e89b-12d3-a456-426614174000"},"profile_id":{"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":"Profile unique identifier","example":"123e4567-e89b-12d3-a456-426614174001"},"platform":{"$ref":"#/components/schemas/Platform"},"platform_id":{"type":"string","description":"Platform-specific post ID","example":"CxYz123ABC"},"url":{"type":"string","format":"uri","description":"Post URL","example":"https://www.instagram.com/p/CxYz123ABC"},"posted_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Post timestamp","example":"2024-01-15T14:30:00Z"},"type":{"$ref":"#/components/schemas/PostType"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Post caption","example":"Starting the week with a killer workout! 💪"},"media":{"$ref":"#/components/schemas/PostMedia"},"metrics":{"$ref":"#/components/schemas/PostMetrics"},"hashtags":{"type":"array","items":{"type":"string"},"description":"Hashtags used in the post","example":["fitness","workout","motivation"]},"mentions":{"type":"array","items":{"type":"string"},"description":"Usernames mentioned in the post","example":["nike","gymshark"]},"location":{"anyOf":[{"$ref":"#/components/schemas/PostLocation"},{"type":"null"}],"description":"Post location (if tagged)"}},"required":["id","profile_id","platform","platform_id","url","posted_at","type","caption","media","metrics","hashtags","mentions","location"],"additionalProperties":false,"description":"Full post details"},"PostType":{"type":"string","enum":["image","video","carousel","reel","story"],"description":"Type of post","example":"image"},"PostMedia":{"type":"object","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Cover/primary image URL for image and carousel posts. Null for video posts — call GET /v1/raw/instagram/post/{shortcode} for a fresh, downloadable video URL. Note: returned image URLs are Instagram CDN URLs and may expire; a future change will migrate to persistent R2-hosted URLs.","example":"https://cdn.example.com/media/post123.jpg"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Thumbnail URL. For videos, this is the cover frame.","example":"https://cdn.example.com/thumbnails/post123.jpg"},"duration_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Video duration in seconds. Null for non-video posts.","example":45},"carousel_items":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/PostMediaCarouselItem"}},{"type":"null"}],"description":"Per-item structure for carousel posts. Null for non-carousel posts. Per-item video_url is intentionally omitted (would be stale). For fresh video URLs, call GET /v1/raw/instagram/post/{shortcode}."}},"required":["url","thumbnail_url","duration_seconds","carousel_items"],"additionalProperties":false,"description":"Post media information"},"PostMediaCarouselItem":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Zero-based position in the carousel.","example":0},"is_video":{"type":"boolean","description":"True if this item is a video.","example":false},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Thumbnail URL for this item. Cover frame for videos.","example":"https://cdn.example.com/thumbnails/carousel_0.jpg"}},"required":["index","is_video","thumbnail_url"],"additionalProperties":false},"PostMetrics":{"type":"object","properties":{"likes":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Like count","example":4500},"comments":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Comment count","example":120},"views":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"View count (for video content)","example":15000},"shares":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Share count","example":50},"engagement_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Engagement rate for this post as a percentage (e.g. 3.8 means 3.8%)","example":3.8}},"required":["likes","comments","views","shares","engagement_rate"],"additionalProperties":false,"description":"Post engagement metrics"},"PostLocation":{"type":"object","properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Location name","example":"Los Angeles, California"}},"required":["name"],"additionalProperties":false,"description":"Post location information"},"LiveProfileResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"username":{"type":"string"},"user_id":{"type":"string"},"full_name":{"type":"string"},"biography":{"type":"string"},"follower_count":{"type":"number"},"following_count":{"type":"number"},"media_count":{"type":"number"},"is_verified":{"type":"boolean"},"is_private":{"type":"boolean"},"is_business":{"type":"boolean"},"is_professional":{"type":"boolean"},"profile_pic_url":{"type":"string","format":"uri"},"profile_pic_url_hd":{"type":"string","format":"uri"},"external_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"bio_links":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string","format":"uri"},"link_type":{"type":"string"}},"required":["title","url"],"additionalProperties":false}},"pronouns":{"type":"array","items":{"type":"string"}},"category_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"highlight_reel_count":{"type":"number"},"engagement_rate":{"type":"number"},"posts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"shortcode":{"type":"string"},"owner_username":{"type":"string"},"display_url":{"type":"string","format":"uri"},"is_video":{"type":"boolean"},"post_type":{"type":"string","enum":["image","video","carousel"]},"like_count":{"type":"number"},"comment_count":{"type":"number"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"taken_at":{"anyOf":[{"type":"number"},{"type":"null"}]},"accessibility_caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"video_url":{"type":"string","format":"uri"},"thumbnail_url":{"type":"string","format":"uri"},"view_count":{"type":"number"},"carousel_items":{"type":"array","items":{"type":"object","properties":{"index":{"type":"number"},"display_url":{"type":"string","format":"uri"},"is_video":{"type":"boolean"},"video_url":{"type":"string","format":"uri"},"thumbnail_url":{"type":"string","format":"uri"}},"required":["index","display_url","is_video"],"additionalProperties":false}},"coauthor_usernames":{"type":"array","items":{"type":"string"}},"is_paid_partnership":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"sponsor_usernames":{"type":"array","items":{"type":"string"}},"tagged_usernames":{"type":"array","items":{"type":"string"}},"product_mentions":{"type":"array","items":{"type":"object","properties":{"product_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"product_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"merchant_username":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false}},"display_resources":{"type":"array","items":{"type":"object","properties":{"src":{"type":"string","format":"uri"},"config_width":{"type":"number"},"config_height":{"type":"number"}},"required":["src","config_width","config_height"],"additionalProperties":false}},"video_versions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"number"},"url":{"type":"string","format":"uri"},"width":{"type":"number"},"height":{"type":"number"}},"required":["url"],"additionalProperties":false}},"music_attribution":{"anyOf":[{"type":"object","properties":{"artist_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"song_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"audio_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"uses_original_audio":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"should_mute_audio":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"location":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"slug":{"anyOf":[{"type":"string"},{"type":"null"}]},"has_public_page":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"lat":{"anyOf":[{"type":"number"},{"type":"null"}]},"lng":{"anyOf":[{"type":"number"},{"type":"null"}]},"address_json":{"anyOf":[{"type":"object","properties":{},"additionalProperties":{"x-stainless-any":true}},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"is_pinned":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"engagement_visibility":{"anyOf":[{"type":"object","properties":{"viewer_can_reshare":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"comments_disabled":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"like_and_view_counts_disabled":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]}},"required":["id","shortcode","display_url","is_video","post_type","like_count","comment_count","caption","taken_at"],"additionalProperties":false}},"related_profiles":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"profile_pic_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"is_verified":{"type":"boolean"},"is_private":{"type":"boolean"}},"required":["username","full_name","profile_pic_url","is_verified","is_private"],"additionalProperties":false}},"scraped_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["username","user_id","full_name","biography","follower_count","following_count","media_count","is_verified","is_private","is_business","is_professional","profile_pic_url","external_url","bio_links","pronouns","category_name","highlight_reel_count","engagement_rate","posts","related_profiles","scraped_at"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},"LiveInstagramPostResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/InstagramSinglePostResponse"}},"required":["data"],"additionalProperties":false},"InstagramSinglePostResponse":{"type":"object","properties":{"post":{"type":"object","properties":{"id":{"type":"string"},"shortcode":{"type":"string"},"owner_username":{"type":"string"},"display_url":{"type":"string","format":"uri"},"is_video":{"type":"boolean"},"post_type":{"type":"string","enum":["image","video","carousel"]},"like_count":{"type":"number"},"comment_count":{"type":"number"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"taken_at":{"anyOf":[{"type":"number"},{"type":"null"}]},"accessibility_caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"video_url":{"type":"string","format":"uri"},"thumbnail_url":{"type":"string","format":"uri"},"view_count":{"type":"number"},"carousel_items":{"type":"array","items":{"type":"object","properties":{"index":{"type":"number"},"display_url":{"type":"string","format":"uri"},"is_video":{"type":"boolean"},"video_url":{"type":"string","format":"uri"},"thumbnail_url":{"type":"string","format":"uri"}},"required":["index","display_url","is_video"],"additionalProperties":false}},"coauthor_usernames":{"type":"array","items":{"type":"string"}},"is_paid_partnership":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"sponsor_usernames":{"type":"array","items":{"type":"string"}},"tagged_usernames":{"type":"array","items":{"type":"string"}},"product_mentions":{"type":"array","items":{"type":"object","properties":{"product_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"product_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"merchant_username":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false}},"display_resources":{"type":"array","items":{"type":"object","properties":{"src":{"type":"string","format":"uri"},"config_width":{"type":"number"},"config_height":{"type":"number"}},"required":["src","config_width","config_height"],"additionalProperties":false}},"video_versions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"number"},"url":{"type":"string","format":"uri"},"width":{"type":"number"},"height":{"type":"number"}},"required":["url"],"additionalProperties":false}},"music_attribution":{"anyOf":[{"type":"object","properties":{"artist_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"song_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"audio_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"uses_original_audio":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"should_mute_audio":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"location":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"slug":{"anyOf":[{"type":"string"},{"type":"null"}]},"has_public_page":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"lat":{"anyOf":[{"type":"number"},{"type":"null"}]},"lng":{"anyOf":[{"type":"number"},{"type":"null"}]},"address_json":{"anyOf":[{"type":"object","properties":{},"additionalProperties":{"x-stainless-any":true}},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"is_pinned":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"engagement_visibility":{"anyOf":[{"type":"object","properties":{"viewer_can_reshare":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"comments_disabled":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"like_and_view_counts_disabled":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]}},"required":["id","shortcode","display_url","is_video","post_type","like_count","comment_count","caption","taken_at"],"additionalProperties":false},"scraped_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["post","scraped_at"],"additionalProperties":false},"LiveInstagramPostBatchResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/InstagramPostBatchResponse"}},"required":["data"],"additionalProperties":false},"InstagramPostBatchResponse":{"type":"object","properties":{"requested":{"type":"number"},"succeeded":{"type":"number"},"failed":{"type":"number"},"items":{"type":"array","items":{"$ref":"#/components/schemas/InstagramPostBatchItem"}},"scraped_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["requested","succeeded","failed","items","scraped_at"],"additionalProperties":false},"InstagramPostBatchItem":{"oneOf":[{"$ref":"#/components/schemas/InstagramPostBatchSuccessItem"},{"$ref":"#/components/schemas/InstagramPostBatchErrorItem"}],"type":"object","discriminator":{"propertyName":"success","mapping":{"true":"#/components/schemas/InstagramPostBatchSuccessItem","false":"#/components/schemas/InstagramPostBatchErrorItem"}}},"InstagramPostBatchSuccessItem":{"type":"object","properties":{"success":{"type":"boolean","const":true},"shortcode":{"type":"string"},"data":{"$ref":"#/components/schemas/InstagramSinglePostResponse"}},"required":["success","shortcode","data"],"additionalProperties":false},"InstagramPostBatchErrorItem":{"type":"object","properties":{"success":{"type":"boolean","const":false},"shortcode":{"type":"string"},"status":{"type":"number"},"error":{"$ref":"#/components/schemas/RawScraperError"}},"required":["success","shortcode","status","error"],"additionalProperties":false},"RawScraperError":{"type":"object","properties":{"error":{"type":"string","enum":["not_found","private","rate_limited","blocked","invalid_input","timeout","unknown"]},"message":{"type":"string"},"username":{"type":"string"},"retry_after":{"type":"number"}},"required":["error","message"],"additionalProperties":false},"LiveInstagramTranscriptResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/InstagramTranscriptResponse"}},"required":["data"],"additionalProperties":false},"InstagramTranscriptResponse":{"type":"object","properties":{"shortcode":{"type":"string"},"post":{"type":"object","properties":{"id":{"type":"string"},"shortcode":{"type":"string"},"owner_username":{"type":"string"},"display_url":{"type":"string","format":"uri"},"is_video":{"type":"boolean"},"post_type":{"type":"string","enum":["image","video","carousel"]},"like_count":{"type":"number"},"comment_count":{"type":"number"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"taken_at":{"anyOf":[{"type":"number"},{"type":"null"}]},"accessibility_caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"video_url":{"type":"string","format":"uri"},"thumbnail_url":{"type":"string","format":"uri"},"view_count":{"type":"number"},"carousel_items":{"type":"array","items":{"type":"object","properties":{"index":{"type":"number"},"display_url":{"type":"string","format":"uri"},"is_video":{"type":"boolean"},"video_url":{"type":"string","format":"uri"},"thumbnail_url":{"type":"string","format":"uri"}},"required":["index","display_url","is_video"],"additionalProperties":false}},"coauthor_usernames":{"type":"array","items":{"type":"string"}},"is_paid_partnership":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"sponsor_usernames":{"type":"array","items":{"type":"string"}},"tagged_usernames":{"type":"array","items":{"type":"string"}},"product_mentions":{"type":"array","items":{"type":"object","properties":{"product_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"product_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"merchant_username":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false}},"display_resources":{"type":"array","items":{"type":"object","properties":{"src":{"type":"string","format":"uri"},"config_width":{"type":"number"},"config_height":{"type":"number"}},"required":["src","config_width","config_height"],"additionalProperties":false}},"video_versions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"number"},"url":{"type":"string","format":"uri"},"width":{"type":"number"},"height":{"type":"number"}},"required":["url"],"additionalProperties":false}},"music_attribution":{"anyOf":[{"type":"object","properties":{"artist_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"song_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"audio_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"uses_original_audio":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"should_mute_audio":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"location":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"slug":{"anyOf":[{"type":"string"},{"type":"null"}]},"has_public_page":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"lat":{"anyOf":[{"type":"number"},{"type":"null"}]},"lng":{"anyOf":[{"type":"number"},{"type":"null"}]},"address_json":{"anyOf":[{"type":"object","properties":{},"additionalProperties":{"x-stainless-any":true}},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"is_pinned":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"engagement_visibility":{"anyOf":[{"type":"object","properties":{"viewer_can_reshare":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"comments_disabled":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"like_and_view_counts_disabled":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]}},"required":["id","shortcode","display_url","is_video","post_type","like_count","comment_count","caption","taken_at"],"additionalProperties":false},"transcript":{"type":"string"},"full_text":{"type":"string"},"word_count":{"type":"number"},"language":{"type":"string"},"duration_seconds":{"type":"number"},"scraped_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["shortcode","transcript","full_text","word_count","language","scraped_at"],"additionalProperties":false},"LiveInstagramTranscriptBatchResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/InstagramTranscriptBatchResponse"}},"required":["data"],"additionalProperties":false},"InstagramTranscriptBatchResponse":{"type":"object","properties":{"requested":{"type":"number"},"succeeded":{"type":"number"},"failed":{"type":"number"},"items":{"type":"array","items":{"$ref":"#/components/schemas/InstagramTranscriptBatchItem"}},"scraped_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["requested","succeeded","failed","items","scraped_at"],"additionalProperties":false},"InstagramTranscriptBatchItem":{"oneOf":[{"$ref":"#/components/schemas/InstagramTranscriptBatchSuccessItem"},{"$ref":"#/components/schemas/InstagramTranscriptBatchErrorItem"}],"type":"object","discriminator":{"propertyName":"success","mapping":{"true":"#/components/schemas/InstagramTranscriptBatchSuccessItem","false":"#/components/schemas/InstagramTranscriptBatchErrorItem"}}},"InstagramTranscriptBatchSuccessItem":{"type":"object","properties":{"success":{"type":"boolean","const":true},"shortcode":{"type":"string"},"data":{"$ref":"#/components/schemas/InstagramTranscriptResponse"}},"required":["success","shortcode","data"],"additionalProperties":false},"InstagramTranscriptBatchErrorItem":{"type":"object","properties":{"success":{"type":"boolean","const":false},"shortcode":{"type":"string"},"status":{"type":"number"},"error":{"$ref":"#/components/schemas/RawScraperError"}},"required":["success","shortcode","status","error"],"additionalProperties":false},"LiveYouTubeChannelResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/LiveYouTubeChannelResponseData"}},"required":["data"],"additionalProperties":false},"LiveYouTubeChannelResponseData":{"type":"object","properties":{"channel_id":{"type":"string","description":"YouTube channel ID","example":"UCBJycsmduvYEL83R_U4JriQ"},"handle":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Channel handle (without @)","example":"mkbhd"},"name":{"type":"string","description":"Channel name","example":"Marques Brownlee"},"description":{"type":"string","description":"Channel description"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Channel avatar URL"},"banner_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Channel banner image URL"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Channel country code","example":"US"},"keywords":{"type":"array","items":{"type":"string"},"description":"Channel keywords / tags"},"subscribers":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Subscriber count","example":20900000},"subscribers_text":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Subscriber count text as displayed by YouTube","example":"20.9M subscribers"},"videos_count":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Total video count","example":1500},"views_total":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Total view count across all videos","example":4500000000},"videos":{"type":"array","items":{"$ref":"#/components/schemas/YouTubeVideo"},"description":"Recent videos (empty when include_videos=false)"},"scraped_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"When this data was scraped","example":"2024-01-15T14:30:00Z"}},"required":["channel_id","handle","name","description","avatar_url","banner_url","country","keywords","subscribers","subscribers_text","videos_count","views_total","videos","scraped_at"],"additionalProperties":false},"YouTubeVideo":{"type":"object","properties":{"video_id":{"type":"string","description":"YouTube video ID","example":"dQw4w9WgXcQ"},"title":{"type":"string","description":"Video title","example":"Full Body Workout | 30 Minutes"},"url":{"type":"string","description":"Video URL","example":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Thumbnail URL"},"published_text":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Relative publish time as displayed by YouTube","example":"2 weeks ago"},"duration_seconds":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Video duration in seconds","example":1845},"duration_text":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Video duration text (e.g., \"30:45\")","example":"30:45"},"view_count":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"View count","example":125000},"view_count_text":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"View count text as displayed by YouTube","example":"125K views"}},"required":["video_id","title","url","thumbnail_url","published_text","duration_seconds","duration_text","view_count","view_count_text"],"additionalProperties":false},"LiveTranscriptResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/YouTubeTranscriptResponseData"}},"required":["data"],"additionalProperties":false},"YouTubeTranscriptResponseData":{"type":"object","properties":{"video_id":{"type":"string","description":"Video ID","example":"dQw4w9WgXcQ"},"url":{"type":"string","description":"Video URL","example":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"},"title":{"type":"string","description":"Video title","example":"Full Body Workout | 30 Minutes"},"language":{"type":"string","description":"Transcript language code","example":"en"},"source":{"type":"string","enum":["manual","auto_generated"],"description":"Caption source — manual subtitles or auto-generated","example":"manual"},"transcript":{"type":"array","items":{"$ref":"#/components/schemas/TranscriptSegment"},"description":"Transcript segments"},"full_text":{"type":"string","description":"Full transcript as plain text"},"word_count":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Total word count","example":1245},"available_languages":{"type":"array","items":{"$ref":"#/components/schemas/TranscriptAvailableLanguage"},"description":"All caption tracks available on this video"},"scraped_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"When this data was scraped","example":"2024-01-15T14:30:00Z"}},"required":["video_id","url","title","language","source","transcript","full_text","word_count","available_languages","scraped_at"],"additionalProperties":false},"TranscriptSegment":{"type":"object","properties":{"text":{"type":"string","description":"Segment text","example":"Welcome to my channel!"},"start":{"type":"number","minimum":0,"description":"Start time in seconds","example":0.5},"duration":{"type":"number","minimum":0,"description":"Duration in seconds","example":2.3}},"required":["text","start","duration"],"additionalProperties":false},"TranscriptAvailableLanguage":{"type":"object","properties":{"code":{"type":"string","description":"Language code (e.g., \"en\", \"es\", \"en-orig\")","example":"en"},"name":{"type":"string","description":"Human-readable language name","example":"English"},"is_auto":{"type":"boolean","description":"Whether this track is auto-generated","example":false}},"required":["code","name","is_auto"],"additionalProperties":false},"LiveChannelTranscriptsResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/LiveChannelTranscriptsResponseData"}},"required":["data"],"additionalProperties":false},"LiveChannelTranscriptsResponseData":{"type":"object","properties":{"channel_id":{"type":"string","description":"YouTube channel ID"},"handle":{"type":"string","description":"Channel handle","example":"mkbhd"},"channel_name":{"type":"string","description":"Channel name"},"videos_found":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Total videos found on channel"},"transcripts_fetched":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of transcripts successfully fetched"},"transcripts_failed":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of transcripts that failed to fetch"},"items":{"type":"array","items":{"$ref":"#/components/schemas/ChannelTranscriptItem"},"description":"Per-video transcript results"},"scraped_at":{"type":"string","description":"When this data was scraped"}},"required":["channel_id","handle","channel_name","videos_found","transcripts_fetched","transcripts_failed","items","scraped_at"],"additionalProperties":false},"ChannelTranscriptItem":{"type":"object","properties":{"video_id":{"type":"string","description":"YouTube video ID","example":"dQw4w9WgXcQ"},"url":{"type":"string","description":"Video URL","example":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"},"title":{"type":"string","description":"Video title"},"view_count":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"View count"},"published_text":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Relative publish time"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Transcript language code"},"source":{"anyOf":[{"type":"string","enum":["manual","auto_generated"]},{"type":"null"}],"description":"Caption source type"},"full_text":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Full transcript as plain text"},"word_count":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"Word count of transcript"},"transcript":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/TranscriptSegment"}},{"type":"null"}],"description":"Timestamped segments (only if include_segments=true)"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Error message if transcript fetch failed for this video"}},"required":["video_id","url","title","view_count","published_text","language","source","full_text","word_count","transcript","error"],"additionalProperties":false},"YouTubeSearchResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/YouTubeSearchResponseData"}},"required":["data"],"additionalProperties":false},"YouTubeSearchResponseData":{"type":"object","properties":{"query":{"type":"string","description":"The search query"},"estimated_results":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"Estimated total results count"},"results":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/YouTubeSearchVideoResult"},{"$ref":"#/components/schemas/YouTubeSearchChannelResult"}]},"description":"Search results (videos and channels)"},"scraped_at":{"type":"string","description":"When this search was performed"}},"required":["query","estimated_results","results","scraped_at"],"additionalProperties":false},"YouTubeSearchVideoResult":{"type":"object","properties":{"type":{"type":"string","const":"video"},"video_id":{"type":"string","description":"YouTube video ID","example":"dQw4w9WgXcQ"},"url":{"type":"string","description":"Full YouTube video URL","example":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"},"title":{"type":"string","description":"Video title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Video description snippet"},"channel_id":{"type":"string","description":"Channel ID"},"channel_name":{"type":"string","description":"Channel name"},"channel_handle":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Channel handle (e.g., @username)"},"channel_verified":{"type":"boolean","description":"Whether channel is verified"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Video thumbnail URL"},"duration_seconds":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"Video duration in seconds"},"duration_text":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Video duration text (e.g., \"12:34\")"},"view_count":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"Number of views"},"view_count_text":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"View count text (e.g., \"1.2M views\")"},"published_text":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Relative publish time (e.g., \"2 days ago\")"},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Approximate publish timestamp"}},"required":["type","video_id","url","title","description","channel_id","channel_name","channel_handle","channel_verified","thumbnail_url","duration_seconds","duration_text","view_count","view_count_text","published_text","published_at"],"additionalProperties":false},"YouTubeSearchChannelResult":{"type":"object","properties":{"type":{"type":"string","const":"channel"},"channel_id":{"type":"string","description":"Channel ID"},"url":{"type":"string","description":"Full YouTube channel URL","example":"https://www.youtube.com/@channelhandle"},"channel_name":{"type":"string","description":"Channel name"},"channel_handle":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Channel handle (e.g., @username)"},"channel_verified":{"type":"boolean","description":"Whether channel is verified"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Channel description snippet"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Channel avatar URL"},"subscriber_count":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"Subscriber count"},"video_count":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Number of videos on the channel"}},"required":["type","channel_id","url","channel_name","channel_handle","channel_verified","description","thumbnail_url","subscriber_count","video_count"],"additionalProperties":false},"CreatorEmailLookupInputOutput":{"anyOf":[{"$ref":"#/components/schemas/CreatorEmailLookupByIdOutput"},{"$ref":"#/components/schemas/CreatorEmailLookupByHandleOutput"}],"description":"Creator email lookup input by creator ID or social handle"},"CreatorEmailLookupByIdOutput":{"type":"object","properties":{"creator_id":{"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":"Creator profile ID to look up directly","example":"123e4567-e89b-12d3-a456-426614174000"}},"required":["creator_id"],"additionalProperties":false,"description":"Creator email lookup input by creator ID"},"CreatorEmailLookupByHandleOutput":{"type":"object","properties":{"platform":{"description":"Social platform for handle-based lookup","$ref":"#/components/schemas/Platform"},"username":{"type":"string","minLength":1,"maxLength":100,"description":"Social username for handle-based lookup","example":"fitness_coach_jane"}},"required":["platform","username"],"additionalProperties":false,"description":"Creator email lookup input by social handle"}}},"paths":{"/v1/creators/autocomplete":{"get":{"operationId":"autocompleteCreators","summary":"Autocomplete Search","tags":["Creators"],"description":"Fast typeahead search for creators by name or username. Optimized for search-as-you-type UIs with sub-100ms response times.\n\n**Matching behavior:**\n- Matches against creator name, username, and display name\n- Results include which field matched and the matching value\n- Prefix matching (e.g., \"fit\" matches \"fitness_coach\")\n\n**Scope options:**\n- `creator_only`: Return only the creator entity\n- `matched_platforms`: Return only profiles that matched the query\n- `all_platforms`: Return all linked profiles (default)\n\nAlso callable as the `autocomplete_creators` MCP tool — see [the MCP server guide](/guides/mcp-server) for setup.\n\n**Pricing**: 0.05 credits per request ($0.0005)","parameters":[{"schema":{"type":"string","minLength":2,"maxLength":100,"description":"Search query (min 2 characters)","example":"fitness"},"in":"query","name":"q","required":true,"description":"Search query (min 2 characters)"},{"schema":{"description":"Filter by platform","$ref":"#/components/schemas/Platform"},"in":"query","name":"platform","description":"Filter by platform"},{"schema":{"default":5,"description":"Maximum results to return","example":5,"type":"integer","minimum":1,"maximum":50},"in":"query","name":"limit","description":"Maximum results to return"},{"schema":{"default":"all_platforms","description":"Which platforms to include in results","example":"all_platforms","type":"string","enum":["creator_only","matched_platforms","all_platforms"]},"in":"query","name":"scope","description":"Which platforms to include in results"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutocompleteResponse"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401"}}}},"402":{"description":"Payment required. The response advertises x402 and MPP payment challenges for retrying the same request with payment proof."},"403":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403"}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error500"}}}}},"security":[{"apiKey":[]}],"x-payment-info":{"offers":[{"method":"tempo","intent":"charge","amount":null,"currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89","network":"eip155:4217"},{"method":"stripe","intent":"charge","amount":null,"currency":"usd","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89"}]}}},"/v1/creators/{id}":{"get":{"operationId":"getCreatorById","summary":"Get Creator by ID","tags":["Creators"],"description":"Retrieve a creator's profile including AI-generated summary, content themes, and optionally their linked social profiles.\n\n**What is a Creator?**\nA creator is a cross-platform entity representing a person or brand. They may have profiles on multiple social networks (Instagram, YouTube, TikTok, etc.) that are linked together.\n\n**Include options:**\n- `profiles`: Include all linked social profiles with metrics\n\nAlso callable as the `get_creator` MCP tool — see [the MCP server guide](/guides/mcp-server) for setup.\n\n**Pricing**: 0.1 credits per request ($0.001)","parameters":[{"schema":{"description":"Additional data to include in response","example":["profiles"],"type":"array","items":{"type":"string","enum":["profiles"]}},"in":"query","name":"include","description":"Additional data to include in response"},{"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":"Creator unique identifier","example":"123e4567-e89b-12d3-a456-426614174000"},"in":"path","name":"id","required":true,"description":"Creator unique identifier"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatorResponse"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401"}}}},"402":{"description":"Payment required. The response advertises x402 and MPP payment challenges for retrying the same request with payment proof."},"403":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403"}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error404"}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error500"}}}}},"security":[{"apiKey":[]}],"x-payment-info":{"offers":[{"method":"tempo","intent":"charge","amount":null,"currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89","network":"eip155:4217"},{"method":"stripe","intent":"charge","amount":null,"currency":"usd","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89"}]}}},"/v1/creators/lookalike":{"post":{"operationId":"findLookalikeCreators","summary":"Find Similar Creators","tags":["Creators"],"description":"Find creators similar to provided seed creators using AI-powered similarity matching. Analyzes content themes, audience overlap, posting style, and engagement patterns.\n\n**Use cases:**\n- Expand campaigns with creators similar to proven performers\n- Find alternatives when preferred creators are unavailable\n- Discover emerging creators in the same niche\n\n**How it works:**\n1. Provide 1-10 seed creators (by ID or platform/username)\n2. Optionally weight seeds to prioritize certain creators\n3. Get ranked results with similarity scores and shared traits\n\nAlso callable as the `find_lookalike_creators` MCP tool — see [the MCP server guide](/guides/mcp-server) for setup.\n\n**Pricing**: 1.5 credits per creator returned ($0.015)","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LookalikeRequest"}}},"description":"Find similar creators request"},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LookalikeResponse"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401"}}}},"402":{"description":"Payment required. The response advertises x402 and MPP payment challenges for retrying the same request with payment proof."},"403":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403"}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error404"}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error500"}}}}},"security":[{"apiKey":[]}],"x-payment-info":{"offers":[{"method":"tempo","intent":"charge","amount":null,"currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89","network":"eip155:4217"},{"method":"stripe","intent":"charge","amount":null,"currency":"usd","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89"}]}}},"/v1/creators/match":{"post":{"operationId":"matchCreators","summary":"Score Campaign Fit","tags":["Creators"],"description":"Evaluate how well creators match a specific campaign using AI analysis. Returns a fit score (0-1), decision recommendation (good/neutral/avoid), and evidence-based explanations.\n\n**Use cases:**\n- Vet shortlisted creators before outreach\n- Rank candidates for a specific campaign\n- Get AI-generated talking points for why a creator fits\n\n**How it works:**\n1. Describe your campaign intent and target audience\n2. Provide up to 100 creators to evaluate\n3. Get detailed scores with explanations and evidence\n\nAlso callable as the `match_creators` MCP tool — see [the MCP server guide](/guides/mcp-server) for setup.\n\n**Pricing**: 1 credit per creator scored ($0.01)","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchRequest"}}},"description":"Score campaign fit request"},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchResponse"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401"}}}},"402":{"description":"Payment required. The response advertises x402 and MPP payment challenges for retrying the same request with payment proof."},"403":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403"}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error404"}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error500"}}}}},"security":[{"apiKey":[]}],"x-payment-info":{"offers":[{"method":"tempo","intent":"charge","amount":null,"currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89","network":"eip155:4217"},{"method":"stripe","intent":"charge","amount":null,"currency":"usd","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89"}]}}},"/v1/creator-emails/lookup":{"post":{"operationId":"lookupCreatorEmails","summary":"Lookup Creator Emails","tags":["Creator Emails"],"description":"Look up known email addresses for creators by creator ID or social username.\n\n**Billing behavior:**\n- Charged only for unique resolved creators with at least one returned email\n- Empty and unresolved results are not billable\n- Returns validation status so unvalidated emails are explicit\n\n**Pricing**: 5 credits per creator with at least one returned email ($0.05)","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatorEmailsLookupRequest"}}},"description":"Creator email lookup request"},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatorEmailsLookupResponse"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401"}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403"}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error500"}}}}}}},"/v1/search":{"post":{"operationId":"searchCreators","summary":"AI-Powered Creator Search","tags":["Search"],"description":"Search for creators using natural language queries. The AI understands intent and context to match creators based on content themes, audience demographics, and style.\n\nThe response includes a `search_id` that can be used with `GET /v1/search/{id}` to paginate through results for free.\n\n**Use cases:**\n- Find creators in a specific niche (\"vegan food bloggers in LA\")\n- Discover creators with specific audience characteristics (\"fitness influencers with millennial audience\")\n- Search by content style (\"creators who post cinematic travel videos\")\n\nAlso callable as the `search_creators` MCP tool — see [the MCP server guide](/guides/mcp-server) for setup.\n\n**Pricing**: 25 credits base + 2 credits per creator returned","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}},"description":"AI-powered semantic search request"},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401"}}}},"402":{"description":"Payment required. The response advertises x402 and MPP payment challenges for retrying the same request with payment proof."},"403":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403"}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error500"}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error503"}}}}},"security":[{"apiKey":[]}],"x-payment-info":{"offers":[{"method":"tempo","intent":"charge","amount":null,"currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89","network":"eip155:4217"},{"method":"stripe","intent":"charge","amount":null,"currency":"usd","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89"}]}}},"/v1/search/{id}":{"get":{"operationId":"getSearchResults","summary":"Get Search Results Page","tags":["Search"],"description":"Paginate through results from a previous search. Use the `search_id` returned by `POST /v1/search` to fetch additional pages.\n\nSearch sessions expire after 1 hour. After expiry, a new search must be run.\n\n**Pricing**: 0 credits (included with initial search)","parameters":[{"schema":{"default":25,"description":"Maximum results to return","example":25,"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","description":"Maximum results to return"},{"schema":{"description":"Pagination cursor for next page","type":"string"},"in":"query","name":"cursor","description":"Pagination cursor for next page"},{"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"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401"}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403"}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error404"}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error500"}}}}},"security":[{"apiKey":[]}]}},"/v1/profiles/{platform}/{username}":{"get":{"operationId":"getProfileByPlatformUsername","summary":"Get Profile by Platform and Username","tags":["Profiles"],"description":"Retrieve detailed profile data including metrics, growth statistics, and activity information from our database.\n\n**Response includes:**\n- Basic info (bio, avatar, verification status)\n- Performance metrics (followers, engagement rate, avg likes/comments)\n- Growth data (30-day follower growth, monthly rate)\n- Activity data (last post date, posting frequency)\n\nAlso callable as the `get_profile` MCP tool — see [the MCP server guide](/guides/mcp-server) for setup.\n\n**Pricing**: 0.1 credits per request ($0.001)","parameters":[{"schema":{"type":"string","minLength":1,"description":"Platform name","example":"instagram"},"in":"path","name":"platform","required":true,"description":"Platform name"},{"schema":{"type":"string","minLength":1,"maxLength":50,"description":"Username on the platform","example":"fitness_coach_jane"},"in":"path","name":"username","required":true,"description":"Username on the platform"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileResponse"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401"}}}},"402":{"description":"Payment required. The response advertises x402 and MPP payment challenges for retrying the same request with payment proof."},"403":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403"}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error404"}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error500"}}}}},"security":[{"apiKey":[]}],"x-payment-info":{"offers":[{"method":"tempo","intent":"charge","amount":null,"currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89","network":"eip155:4217"},{"method":"stripe","intent":"charge","amount":null,"currency":"usd","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89"}]}}},"/v1/profiles/lookup":{"post":{"operationId":"lookupProfiles","summary":"Batch Lookup Profiles","tags":["Profiles"],"description":"Look up multiple profiles in a single request. Efficiently retrieve data for up to 100 profiles at once.\n\n**Response includes:**\n- `found`: Array of profiles that exist in our database\n- `not_found`: Array of profiles that weren't found (consider live scraping these)\n\nAlso callable as the `lookup_profiles` MCP tool — see [the MCP server guide](/guides/mcp-server) for setup.\n\n**Pricing**: 0.1 credits per profile ($0.001)","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfilesLookupRequest"}}},"description":"Batch lookup profiles request"},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfilesLookupResponse"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401"}}}},"402":{"description":"Payment required. The response advertises x402 and MPP payment challenges for retrying the same request with payment proof."},"403":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403"}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error500"}}}}},"security":[{"apiKey":[]}],"x-payment-info":{"offers":[{"method":"tempo","intent":"charge","amount":null,"currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89","network":"eip155:4217"},{"method":"stripe","intent":"charge","amount":null,"currency":"usd","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89"}]}}},"/v1/posts":{"get":{"operationId":"getPosts","summary":"Get Posts","tags":["Posts"],"description":"Retrieve posts for a creator or profile with engagement metrics and media data.\n\n**Query options:**\n- By creator: Use `creator_id` to get posts across all their profiles\n- By profile: Use `platform` + `username` for a specific profile's posts\n\n**Sort options:**\n- `recent`: Most recent posts first (default)\n- `top_engagement`: Highest engagement rate first\n- `most_likes`: Most likes first\n- `most_views`: Most views first (video content)\n- `most_comments`: Most comments first\n\nAlso callable as the `get_posts` MCP tool — see [the MCP server guide](/guides/mcp-server) for setup.\n\n**Pricing**: 0.05 credits per post returned ($0.0005)","parameters":[{"schema":{"description":"Platform (required with username)","$ref":"#/components/schemas/Platform"},"in":"query","name":"platform","description":"Platform (required with username)"},{"schema":{"description":"Username (required with platform)","example":"fitness_coach_jane","type":"string","minLength":1,"maxLength":50},"in":"query","name":"username","description":"Username (required with platform)"},{"schema":{"description":"Creator ID (use this OR platform+username)","example":"123e4567-e89b-12d3-a456-426614174000","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)$"},"in":"query","name":"creator_id","description":"Creator ID (use this OR platform+username)"},{"schema":{"default":12,"description":"Maximum posts to return","example":12,"type":"integer","minimum":1,"maximum":50},"in":"query","name":"limit","description":"Maximum posts to return"},{"schema":{"default":"recent","description":"Sort order","$ref":"#/components/schemas/PostSort"},"in":"query","name":"sort","description":"Sort order"},{"schema":{"description":"Pagination cursor for next page","type":"string"},"in":"query","name":"cursor","description":"Pagination cursor for next page"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostsResponse"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401"}}}},"402":{"description":"Payment required. The response advertises x402 and MPP payment challenges for retrying the same request with payment proof."},"403":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403"}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error404"}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error500"}}}}},"security":[{"apiKey":[]}],"x-payment-info":{"offers":[{"method":"tempo","intent":"charge","amount":null,"currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89","network":"eip155:4217"},{"method":"stripe","intent":"charge","amount":null,"currency":"usd","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89"}]}}},"/v1/raw/instagram/profile/{username}":{"get":{"operationId":"getLiveInstagramProfile","summary":"Get Live Instagram Profile","tags":["Live Scraping"],"description":"Fetch fresh Instagram profile data directly from Instagram in real-time. Use this when you need the most current follower counts, bio, or recent activity.\n\n**When to use live scraping:**\n- Profile not found in our database\n- Need real-time follower/engagement data\n- Verifying current profile status before campaign\n\n**Note:** Live scraping is slower than cached data (2-5 seconds) and costs more. Use cached endpoints when freshness isn't critical.\n\nThe `posts[]` array returns up to 12 recent posts with fresh `video_url` for each video post. This is the cheapest bulk-download path: 0.5 credits ($0.005) per profile call vs 1 credit per individual raw-post call.\n\n**Pricing**: 0.5 credits per profile scraped ($0.005)","parameters":[{"schema":{"description":"Include recent posts in response","example":true,"type":"boolean"},"in":"query","name":"include_posts","description":"Include recent posts in response"},{"schema":{"default":12,"description":"Number of posts to include","example":12,"type":"integer","minimum":1,"maximum":50},"in":"query","name":"post_limit","description":"Number of posts to include"},{"schema":{"type":"string","minLength":1,"maxLength":50,"description":"Username on the platform","example":"fitness_coach_jane"},"in":"path","name":"username","required":true,"description":"Username on the platform"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiveProfileResponse"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401"}}}},"402":{"description":"Payment required. The response advertises x402 and MPP payment challenges for retrying the same request with payment proof."},"403":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403"}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error404"}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error500"}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error503"}}}}},"security":[{"apiKey":[]}],"x-payment-info":{"offers":[{"method":"tempo","intent":"charge","amount":null,"currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89","network":"eip155:4217"},{"method":"stripe","intent":"charge","amount":null,"currency":"usd","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89"}]}}},"/v1/raw/instagram/post/{shortcode}":{"get":{"operationId":"getLiveInstagramPost","summary":"Get Live Instagram Post","tags":["Live Scraping"],"description":"Fetch fresh Instagram post-page data by shortcode. This raw endpoint includes rich post-page fields like coauthors, tagged users, paid partnership metadata, product mentions, music attribution, location, display resources, and video versions.\n\n**Note:** These fields are only guaranteed on this raw single-post lookup. Cached post-list endpoints may not include them.\n\nReturns fresh `video_url` (single best stream) and `video_versions[]` (multi-bitrate). These are signed Instagram CDN URLs valid for ~24h — download promptly. For carousels with embedded videos, see `carousel_items[].video_url`.\n\n**Pricing**: 1 credit per post scraped ($0.01)","parameters":[{"schema":{"type":"string","minLength":1,"description":"Instagram post shortcode from a /p/, /reel/, or /tv/ URL","example":"C0ABC123xyz"},"in":"path","name":"shortcode","required":true,"description":"Instagram post shortcode from a /p/, /reel/, or /tv/ URL"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiveInstagramPostResponse"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401"}}}},"402":{"description":"Payment required. The response advertises x402 and MPP payment challenges for retrying the same request with payment proof."},"403":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403"}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error404"}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error500"}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error503"}}}}},"security":[{"apiKey":[]}],"x-payment-info":{"offers":[{"method":"tempo","intent":"charge","amount":null,"currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89","network":"eip155:4217"},{"method":"stripe","intent":"charge","amount":null,"currency":"usd","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89"}]}}},"/v1/raw/instagram/posts":{"post":{"operationId":"getLiveInstagramPosts","summary":"Get Live Instagram Posts","tags":["Live Scraping"],"description":"Fetch fresh Instagram post-page data for a bounded list of shortcodes. This returns one item per requested shortcode with per-item success or error details.\n\n**Note:** Batch post lookup is capped at 20 shortcodes per request and is charged for every requested shortcode.\n\nReturns fresh `video_url` and `video_versions[]` per post (signed IG CDN URLs, ~24h validity). Batch up to 20 posts at 1 credit ($0.01) each.\n\n**Pricing**: 1 credit per post scraped ($0.01)","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiveInstagramPostBatchBody"}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiveInstagramPostBatchResponse"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401"}}}},"402":{"description":"Payment required. The response advertises x402 and MPP payment challenges for retrying the same request with payment proof."},"403":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403"}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error500"}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error503"}}}}},"security":[{"apiKey":[]}],"x-payment-info":{"offers":[{"method":"tempo","intent":"charge","amount":null,"currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89","network":"eip155:4217"},{"method":"stripe","intent":"charge","amount":null,"currency":"usd","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89"}]}}},"/v1/raw/instagram/transcript/{shortcode}":{"get":{"operationId":"getLiveInstagramTranscript","summary":"Get Instagram Post Transcript","tags":["Live Scraping"],"description":"Transcribe an Instagram video post by shortcode and return the raw post-page data used for transcription.\n\n**Pricing**: 5 credits per transcript ($0.05)","parameters":[{"schema":{"description":"Optional language code for transcription. Omit to auto-detect.","example":"en","type":"string"},"in":"query","name":"language","description":"Optional language code for transcription. Omit to auto-detect."},{"schema":{"type":"string","minLength":1,"description":"Instagram post shortcode from a /p/, /reel/, or /tv/ URL","example":"C0ABC123xyz"},"in":"path","name":"shortcode","required":true,"description":"Instagram post shortcode from a /p/, /reel/, or /tv/ URL"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiveInstagramTranscriptResponse"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401"}}}},"402":{"description":"Payment required. The response advertises x402 and MPP payment challenges for retrying the same request with payment proof."},"403":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403"}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error404"}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error500"}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error503"}}}}},"security":[{"apiKey":[]}],"x-payment-info":{"offers":[{"method":"tempo","intent":"charge","amount":null,"currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89","network":"eip155:4217"},{"method":"stripe","intent":"charge","amount":null,"currency":"usd","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89"}]}}},"/v1/raw/instagram/transcripts":{"post":{"operationId":"getLiveInstagramTranscripts","summary":"Get Instagram Post Transcripts","tags":["Live Scraping"],"description":"Transcribe a bounded list of Instagram video posts by shortcode and return one item per requested shortcode with per-item success or error details. Successful items include the raw post-page data used for transcription.\n\n**Note:** Batch transcription is capped at 10 shortcodes per request and is charged for every requested shortcode.\n\n**Pricing**: 5 credits per transcript ($0.05)","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiveInstagramTranscriptBatchBody"}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiveInstagramTranscriptBatchResponse"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401"}}}},"402":{"description":"Payment required. The response advertises x402 and MPP payment challenges for retrying the same request with payment proof."},"403":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403"}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error500"}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error503"}}}}},"security":[{"apiKey":[]}],"x-payment-info":{"offers":[{"method":"tempo","intent":"charge","amount":null,"currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89","network":"eip155:4217"},{"method":"stripe","intent":"charge","amount":null,"currency":"usd","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89"}]}}},"/v1/raw/youtube/channel/{handle}":{"get":{"operationId":"getLiveYouTubeChannel","summary":"Get Live YouTube Channel","tags":["Live Scraping"],"description":"Fetch fresh YouTube channel data including subscriber count, video count, and total views.\n\n**Pricing**: 0.5 credits per channel scraped ($0.005)","parameters":[{"schema":{"description":"Include recent videos in response","example":true,"type":"boolean"},"in":"query","name":"include_videos","description":"Include recent videos in response"},{"schema":{"default":12,"description":"Number of videos to include","example":12,"type":"integer","minimum":1,"maximum":50},"in":"query","name":"video_limit","description":"Number of videos to include"},{"schema":{"type":"string","minLength":1,"description":"YouTube channel handle. Accepts a bare handle (`techreviews`), an `@handle` (`@techreviews`), or a full channel URL (`https://youtube.com/@techreviews`); surrounding share tokens and trailing paths are ignored. A value that is not a channel handle returns a 400 validation error.","example":"@techreviews"},"in":"path","name":"handle","required":true,"description":"YouTube channel handle. Accepts a bare handle (`techreviews`), an `@handle` (`@techreviews`), or a full channel URL (`https://youtube.com/@techreviews`); surrounding share tokens and trailing paths are ignored. A value that is not a channel handle returns a 400 validation error."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiveYouTubeChannelResponse"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401"}}}},"402":{"description":"Payment required. The response advertises x402 and MPP payment challenges for retrying the same request with payment proof."},"403":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403"}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error404"}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error500"}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error503"}}}}},"security":[{"apiKey":[]}],"x-payment-info":{"offers":[{"method":"tempo","intent":"charge","amount":null,"currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89","network":"eip155:4217"},{"method":"stripe","intent":"charge","amount":null,"currency":"usd","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89"}]}}},"/v1/raw/youtube/transcript/{video_id}":{"get":{"operationId":"getLiveYouTubeTranscript","summary":"Get YouTube Video Transcript","tags":["Live Scraping"],"description":"Fetch YouTube video transcript/captions. Returns timestamped segments and full text. Useful for content analysis.\n\n**Supported sources:**\n- Manual captions (highest quality)\n- Auto-generated captions\n- Multiple language tracks\n\n**Pricing**: 0.5 credits per transcript ($0.005)","parameters":[{"schema":{"default":"auto","description":"Language code or \"auto\" for automatic detection","example":"en","type":"string"},"in":"query","name":"language","description":"Language code or \"auto\" for automatic detection"},{"schema":{"type":"string","minLength":1,"description":"YouTube video ID","example":"dQw4w9WgXcQ"},"in":"path","name":"video_id","required":true,"description":"YouTube video ID"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiveTranscriptResponse"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401"}}}},"402":{"description":"Payment required. The response advertises x402 and MPP payment challenges for retrying the same request with payment proof."},"403":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403"}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error404"}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error500"}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error503"}}}}},"security":[{"apiKey":[]}],"x-payment-info":{"offers":[{"method":"tempo","intent":"charge","amount":null,"currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89","network":"eip155:4217"},{"method":"stripe","intent":"charge","amount":null,"currency":"usd","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89"}]}}},"/v1/raw/youtube/channel-transcripts/{handle}":{"get":{"operationId":"getLiveYouTubeChannelTranscripts","summary":"Get YouTube Channel Transcripts","tags":["Live Scraping"],"description":"Fetch transcripts for multiple videos from a YouTube channel. Videos can be sorted by popularity, newest, or oldest before selection.\n\n**Features:**\n- Fetches up to 20 video transcripts per request\n- Sort by popular (most views), newest, or oldest\n- Partial success — individual video failures don't block the response\n- Optional timestamped segments for each transcript\n\n**Pricing**: 0.5 credits per transcript fetched ($0.005)","parameters":[{"schema":{"default":5,"description":"Number of videos to fetch transcripts for (max 20)","example":5,"type":"integer","minimum":1,"maximum":20},"in":"query","name":"video_limit","description":"Number of videos to fetch transcripts for (max 20)"},{"schema":{"default":"en","description":"Language code for transcripts","example":"en","type":"string"},"in":"query","name":"language","description":"Language code for transcripts"},{"schema":{"default":"newest","description":"How to sort channel videos before selecting","example":"newest","type":"string","enum":["popular","newest","oldest"]},"in":"query","name":"sort_by","description":"How to sort channel videos before selecting"},{"schema":{"description":"Include timestamped transcript segments in response","example":false,"type":"boolean"},"in":"query","name":"include_segments","description":"Include timestamped transcript segments in response"},{"schema":{"type":"string","minLength":1,"description":"YouTube channel handle. Accepts a bare handle (`techreviews`), an `@handle` (`@techreviews`), or a full channel URL (`https://youtube.com/@techreviews`); surrounding share tokens and trailing paths are ignored. A value that is not a channel handle returns a 400 validation error.","example":"@techreviews"},"in":"path","name":"handle","required":true,"description":"YouTube channel handle. Accepts a bare handle (`techreviews`), an `@handle` (`@techreviews`), or a full channel URL (`https://youtube.com/@techreviews`); surrounding share tokens and trailing paths are ignored. A value that is not a channel handle returns a 400 validation error."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiveChannelTranscriptsResponse"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401"}}}},"402":{"description":"Payment required. The response advertises x402 and MPP payment challenges for retrying the same request with payment proof."},"403":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403"}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error404"}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error500"}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error503"}}}}},"security":[{"apiKey":[]}],"x-payment-info":{"offers":[{"method":"tempo","intent":"charge","amount":null,"currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89","network":"eip155:4217"},{"method":"stripe","intent":"charge","amount":null,"currency":"usd","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89"}]}}},"/v1/raw/youtube/search":{"get":{"operationId":"searchYouTube","summary":"Search YouTube","tags":["Live Scraping"],"description":"Search YouTube videos and channels.\n\n**Pricing**: 0.5 credits per result returned ($0.005)","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":500,"description":"Search query","example":"fitness workout"},"in":"query","name":"q","required":true,"description":"Search query"},{"schema":{"default":20,"description":"Maximum number of results to return","example":20,"type":"integer","minimum":1,"maximum":50},"in":"query","name":"limit","description":"Maximum number of results to return"},{"schema":{"default":"US","description":"Country code for localized results (ISO 3166-1 alpha-2)","example":"US","type":"string","minLength":2,"maxLength":2},"in":"query","name":"country_code","description":"Country code for localized results (ISO 3166-1 alpha-2)"},{"schema":{"default":"en","description":"Language code for results","example":"en","type":"string","minLength":2,"maxLength":5},"in":"query","name":"language_code","description":"Language code for results"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/YouTubeSearchResponse"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401"}}}},"402":{"description":"Payment required. The response advertises x402 and MPP payment challenges for retrying the same request with payment proof."},"403":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403"}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429"}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error500"}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error503"}}}}},"security":[{"apiKey":[]}],"x-payment-info":{"offers":[{"method":"tempo","intent":"charge","amount":null,"currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89","network":"eip155:4217"},{"method":"stripe","intent":"charge","amount":null,"currency":"usd","recipient":"0x6d02E3f7C68E7492Cc5474Ef8ce17DedFD11df89"}]}}}},"servers":[{"url":"https://api.influship.com","description":"Production"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"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":"Fetch fresh data directly from social platforms in real-time. Use when you need the most current information or data for profiles not yet in our database."}]}