{"openapi":"3.1.0","info":{"title":"PitchGhost API","version":"1.0.0","contact":{"name":"PitchGhost Support","email":"support@pitchghost.com","url":"https://pitchghost.com/contact"},"description":"The PitchGhost API provides programmatic access to our lead generation and social media automation platform.\n\n\n## Authentication\n\nAll API endpoints require authentication using a combined Company ID and API key. The authentication value is formed by combining your Company ID with your API token, separated by a colon:\n\n```\n{companyId}:{apiKey}\n```\n\nFor example:\n```\ne5903eb5-006a-4d3f-a34d-71b9d8929f2e:7baa8145694a4cb8b68a7fc178c27d80\n```\n\n### Getting Your Company ID\n\nYou can find your Company ID in the PitchGhost app URL when logged in:\n```\nhttps://app.pitchghost.com/org/{YOUR-COMPANY-ID}/dashboard\n```\n\nFor example, if your dashboard URL is:\n```\nhttps://app.pitchghost.com/org/a971dk12-05a5-46e3-akq6-cd11nbac3594/dashboard\n```\nThen your Company ID is: `a971dk12-05a5-46e3-akq6-cd11nbac3594`\n\n### Authentication Methods\n\nYou can provide your combined authentication string in one of two ways:\n\n1. **X-API-Key Header**: \n```\nX-API-Key: e5903eb5-006a-4d3f-a34d-71b9d8929f2e:7baa8145694a4cb8b68a7fc178c27d80\n```\n\n2. **Bearer Token**: \n```\nAuthorization: Bearer e5903eb5-006a-4d3f-a34d-71b9d8929f2e:7baa8145694a4cb8b68a7fc178c27d80\n```\n\n## Rate Limits\n\nThe API implements rate limiting to ensure fair usage and system stability. All authenticated endpoints are subject to rate limits.\n\n### Global Rate Limit (Basic API)\n\nAll API requests are subject to a global rate limit of **200 requests per 10 minutes** per company. This limit applies across all API keys for your company.\n\n- **Limit**: 200 requests per 10-minute window\n- **Scope**: Per company (all API keys combined)\n- **Window**: Rolling 10-minute window\n\n### Rate Limit Headers\n\nEvery API response includes rate limit information in the following headers:\n\n- `X-RateLimit-Limit`: Maximum requests allowed in the current window\n- `X-RateLimit-Remaining`: Number of requests remaining in the current window\n- `X-RateLimit-Reset`: Unix timestamp (in milliseconds) when the window resets\n- `X-RateLimit-Type`: Type of rate limit applied ('global', 'action', or 'none')\n\nWhen rate limited, you'll receive:\n- `429 Too Many Requests` status code\n- `Retry-After` header indicating seconds to wait before retrying\n\n\n## Response Format\n\nAll responses are returned in JSON format. Successful responses will have appropriate HTTP status codes (2xx range).\n\n## Error Handling\n\nErrors are returned with appropriate HTTP status codes and a JSON body containing a `message` field describing the error.\n\nCommon error codes:\n- `401`: Authentication required or invalid API key\n- `403`: Insufficient permissions for the requested resource\n- `429`: Rate limit exceeded (see Rate Limits section)\n- `500`: Internal server error"},"servers":[{"url":"https://api.pitchghost.com","description":"Production API"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Combined Company ID and API key. Format: {companyId}:{apiKey}"},"BearerAuth":{"type":"http","scheme":"bearer","description":"Combined Company ID and API key. Format: {companyId}:{apiKey}"}},"schemas":{"HealthResponse":{"type":"object","properties":{"status":{"type":"string","enum":["ok"]},"companyId":{"type":"string","description":"The company ID associated with the API key","example":"company_123456"}},"required":["status","companyId"]},"ErrorResponse":{"type":"object","properties":{"message":{"type":"string","examples":["Ghost not found or does not belong to company"]}},"required":["message"]},"GhostDetail":{"allOf":[{"$ref":"#/components/schemas/GhostSchema"},{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the Ghost","example":"123e4567-e89b-12d3-a456-426614174000"},"enabled":{"type":"boolean","description":"Whether the Ghost scans automatically on its schedule","example":true},"nextScan":{"type":["string","null"],"description":"When the next scheduled scan runs; null while the Ghost is disabled","example":"2026-10-02T16:00:00Z"},"createdAt":{"type":"string","description":"When the Ghost was created","example":"2026-10-02T14:00:00Z"}},"required":["id","enabled","nextScan","createdAt"]}],"description":"Ghost object","examples":[{"service":"Reddit","nickname":"CRM switchers","goal":"People who are frustrated with their current CRM and are asking for alternatives or recommendations. Don't show me vendors promoting their own product, job postings, or generic sales advice. I want to engage with these Finds because we sell a CRM for small sales teams and can offer a genuinely helpful recommendation.","threshold":0.7,"frequency":{"value":"1","unit":"days"},"maxFinds":25,"serviceSettings":{"searchQueries":{"queries":[{"value":"\"CRM alternative\" OR \"switching CRMs\"","filters":{}},{"value":"CRM (recommend OR recommendation)","filters":{"subreddits":["sales","smallbusiness"]}}],"global":{"contentType":"post"}},"responseTypes":null,"subSafeResponses":true},"tone":null,"generateResponses":false,"autoAssign":null,"id":"123e4567-e89b-12d3-a456-426614174000","enabled":true,"nextScan":"2026-10-03T14:00:00Z","createdAt":"2026-10-02T14:00:00Z"}]},"GhostSchema":{"type":"object","properties":{"service":{"type":"string","enum":["Twitter","LinkedIn","Reddit","Facebook","LinkedIn_People","LinkedIn_Company"],"description":"The service this Ghost monitors"},"nickname":{"type":"string","minLength":1,"maxLength":100,"description":"The display name for the Ghost","examples":["CRM switchers"]},"goal":{"type":"string","minLength":1,"maxLength":2000,"description":"Natural language description of what the Ghost should find. Search queries determine what content is fetched; the goal determines how AI scores and filters that content. Be specific about the type of content, industry, and intent you want to match.\n\nGreat goals answer the following three basic questions:\n\n1. The perfect Find for me looks like...\n2. Don't show me Finds that look like...\n3. I want to engage with these Finds because...\n\nThe more detailed, the better!","examples":["People who are frustrated with their current CRM and are asking for alternatives or recommendations. Don't show me vendors promoting their own product, job postings, or generic sales advice. I want to engage with these Finds because we sell a CRM for small sales teams and can offer a genuinely helpful recommendation."]},"threshold":{"type":"number","minimum":0.1,"maximum":1,"description":"Match confidence threshold (0.1-1.0). Lower values return more results but less relevant, higher values return fewer but more precise matches. Steps of 0.1","examples":[0.7]},"tone":{"type":["string","null"],"maxLength":2000,"description":"Tone for AI-generated responses. Null uses the brand default tone.","examples":["Friendly and helpful, like a peer who has tried a few CRMs. No hard sell."]},"generateResponses":{"type":"boolean","description":"Enable AI-generated response suggestions for Finds. Requires Engage plan."},"frequency":{"oneOf":[{"type":"object","properties":{"value":{"type":"string","enum":["10","15","30"]},"unit":{"type":"string","enum":["minutes"]}},"required":["value","unit"],"title":"Minutes"},{"type":"object","properties":{"value":{"type":"string","enum":["1","2","3","4","5","6","7","8","9","10","11","12"]},"unit":{"type":"string","enum":["hours"]}},"required":["value","unit"],"title":"Hours"},{"type":"object","properties":{"value":{"type":"string","enum":["1","2","3","4","5","6","7"]},"unit":{"type":"string","enum":["days"]}},"required":["value","unit"],"title":"Days"}],"description":"How often the Ghost scans for new content.","examples":[{"value":"1","unit":"days"},{"value":"6","unit":"hours"}]},"maxFinds":{"type":"integer","minimum":0,"maximum":100,"description":"Maximum finds per scan. 0 means unlimited.","examples":[25]},"autoAssign":{"type":["string","null"],"format":"uuid","description":"UUID of a team member to auto-assign finds to. Use search_team_members to find valid IDs. Requires Engage plan.","examples":["7c9e6679-7425-40de-944b-e07fc1f90ae7"]},"serviceSettings":{"anyOf":[{"type":"object","properties":{"searchQueries":{"anyOf":[{"type":"object","properties":{"queries":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","examples":["\"CRM alternative\" OR \"switching CRMs\"","CRM (recommend OR recommendation) -hiring"]},"filters":{"type":["object","null"],"properties":{"images":{"type":["boolean","null"]},"url":{"type":["string","null"],"pattern":"^(?:(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,6})$"},"lang":{"anyOf":[{"type":"string","enum":["aa","ab","ae","af","ak","am","an","ar","as","av","ay","az","ba","be","bg","bi","bm","bn","bo","br","bs","ca","ce","ch","co","cr","cs","cu","cv","cy","da","de","dv","dz","ee","el","en","eo","es","et","eu","fa","ff","fi","fj","fo","fr","fy","ga","gd","gl","gn","gu","gv","ha","he","hi","ho","hr","ht","hu","hy","hz","ia","id","ie","ig","ii","ik","io","is","it","iu","ja","jv","ka","kg","ki","kj","kk","kl","km","kn","ko","kr","ks","ku","kv","kw","ky","la","lb","lg","li","ln","lo","lt","lu","lv","mg","mh","mi","mk","ml","mn","mr","ms","mt","my","na","nb","nd","ne","ng","nl","nn","no","nr","nv","ny","oc","oj","om","or","os","pa","pi","pl","ps","pt","qu","rm","rn","ro","ru","rw","sa","sc","sd","se","sg","si","sk","sl","sm","sn","so","sq","sr","ss","st","su","sv","sw","ta","te","tg","th","ti","tk","tl","tn","to","tr","ts","tt","tw","ty","ug","uk","ur","uz","ve","vi","vo","wa","wo","xh","yi","yo","za","zh","zu"]},{"type":"array","items":{"type":"string","enum":["aa","ab","ae","af","ak","am","an","ar","as","av","ay","az","ba","be","bg","bi","bm","bn","bo","br","bs","ca","ce","ch","co","cr","cs","cu","cv","cy","da","de","dv","dz","ee","el","en","eo","es","et","eu","fa","ff","fi","fj","fo","fr","fy","ga","gd","gl","gn","gu","gv","ha","he","hi","ho","hr","ht","hu","hy","hz","ia","id","ie","ig","ii","ik","io","is","it","iu","ja","jv","ka","kg","ki","kj","kk","kl","km","kn","ko","kr","ks","ku","kv","kw","ky","la","lb","lg","li","ln","lo","lt","lu","lv","mg","mh","mi","mk","ml","mn","mr","ms","mt","my","na","nb","nd","ne","ng","nl","nn","no","nr","nv","ny","oc","oj","om","or","os","pa","pi","pl","ps","pt","qu","rm","rn","ro","ru","rw","sa","sc","sd","se","sg","si","sk","sl","sm","sn","so","sq","sr","ss","st","su","sv","sw","ta","te","tg","th","ti","tk","tl","tn","to","tr","ts","tt","tw","ty","ug","uk","ur","uz","ve","vi","vo","wa","wo","xh","yi","yo","za","zh","zu"]}},{"type":"null"}]},"from":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"replyingTo":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"mentioning":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"verified":{"type":["boolean","null"]},"near":{"type":["object","null"],"properties":{"country":{"type":["string","null"]},"state":{"type":["string","null"]},"city":{"type":["string","null"]}},"required":["country","state","city"]},"retweets":{"type":["boolean","null"]},"replies":{"type":["boolean","null"]},"quotes":{"type":["boolean","null"]},"hashtags":{"type":["boolean","null"]},"news":{"type":["boolean","null"]},"sfw":{"type":["boolean","null"]},"videos":{"type":["boolean","null"]},"links":{"type":["boolean","null"]},"place":{"anyOf":[{"type":"string","enum":["96683cc9126741d1","7142eb97ae21e839","4ec01c9dbc693497","463f5d9615d7d1be","fbd6d2f5a4e4a15e","e8ad2641c1cb666c","e0060cda70f5f341","de599025180e2ee7","65b4760a2b411e11","94965b2c45386f87","25530ba03b7d90c6","f54a2170ff4b15f7","3376992a082d67c7","30410557050f13a5","4e7c21fd2af027c6","f3bfc7dcc928977f","ecdce75d48b13b64","d9074951d5976bdf","c799e2d3a79f810e","81b8dcbe189773f2","78bfaf3f12c05982","ea679934779f45c7","8198e85105936d3c","879d7cfc66c9c290","6b5d375c346e3be9","c29833e68a86e703","82b141af443cb1b8","2ee7eeaa84dbe65a","1ef1183ed7056dc1","e7c97cdfef3a741a","e222580e9a58b499","d0e642e8a900f679","d5cde4dddd7e6f94","a9928b6eaeb54f86","34ed2e67dd5a22bb","58f54743b1a62911","8d65596349ee2e01","f7531639e8db5e12","f0af1239cbebb474","1d834adff5d584df","6416b8512febefc9","1b107df3ccc0aaa1","4d3b316fe2e52b29","3b98b02fba3f9753","47a3cf27863714de","3f14ce28dc7c4566","06ef846bfc783874","0b039ce18ddf1cb9","c00e5392b3fa46fb","173c2bb9d42baaa5","2edb6e240797c549","0639360bd49a15e3","288de3df481163e8"]},{"type":"array","items":{"type":"string","enum":["96683cc9126741d1","7142eb97ae21e839","4ec01c9dbc693497","463f5d9615d7d1be","fbd6d2f5a4e4a15e","e8ad2641c1cb666c","e0060cda70f5f341","de599025180e2ee7","65b4760a2b411e11","94965b2c45386f87","25530ba03b7d90c6","f54a2170ff4b15f7","3376992a082d67c7","30410557050f13a5","4e7c21fd2af027c6","f3bfc7dcc928977f","ecdce75d48b13b64","d9074951d5976bdf","c799e2d3a79f810e","81b8dcbe189773f2","78bfaf3f12c05982","ea679934779f45c7","8198e85105936d3c","879d7cfc66c9c290","6b5d375c346e3be9","c29833e68a86e703","82b141af443cb1b8","2ee7eeaa84dbe65a","1ef1183ed7056dc1","e7c97cdfef3a741a","e222580e9a58b499","d0e642e8a900f679","d5cde4dddd7e6f94","a9928b6eaeb54f86","34ed2e67dd5a22bb","58f54743b1a62911","8d65596349ee2e01","f7531639e8db5e12","f0af1239cbebb474","1d834adff5d584df","6416b8512febefc9","1b107df3ccc0aaa1","4d3b316fe2e52b29","3b98b02fba3f9753","47a3cf27863714de","3f14ce28dc7c4566","06ef846bfc783874","0b039ce18ddf1cb9","c00e5392b3fa46fb","173c2bb9d42baaa5","2edb6e240797c549","0639360bd49a15e3","288de3df481163e8"]}},{"type":"null"}]},"tags":{"type":["boolean","null"]},"minFollowers":{"type":["number","null"]},"minFollowing":{"type":["number","null"]},"minTweets":{"type":["number","null"]},"canDM":{"type":["boolean","null"]}},"default":{}}},"required":["value"]},"minItems":1,"maxItems":15},"global":{"type":"object","properties":{"images":{"type":["boolean","null"]},"url":{"type":["string","null"],"pattern":"^(?:(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,6})$"},"lang":{"anyOf":[{"type":"string","enum":["aa","ab","ae","af","ak","am","an","ar","as","av","ay","az","ba","be","bg","bi","bm","bn","bo","br","bs","ca","ce","ch","co","cr","cs","cu","cv","cy","da","de","dv","dz","ee","el","en","eo","es","et","eu","fa","ff","fi","fj","fo","fr","fy","ga","gd","gl","gn","gu","gv","ha","he","hi","ho","hr","ht","hu","hy","hz","ia","id","ie","ig","ii","ik","io","is","it","iu","ja","jv","ka","kg","ki","kj","kk","kl","km","kn","ko","kr","ks","ku","kv","kw","ky","la","lb","lg","li","ln","lo","lt","lu","lv","mg","mh","mi","mk","ml","mn","mr","ms","mt","my","na","nb","nd","ne","ng","nl","nn","no","nr","nv","ny","oc","oj","om","or","os","pa","pi","pl","ps","pt","qu","rm","rn","ro","ru","rw","sa","sc","sd","se","sg","si","sk","sl","sm","sn","so","sq","sr","ss","st","su","sv","sw","ta","te","tg","th","ti","tk","tl","tn","to","tr","ts","tt","tw","ty","ug","uk","ur","uz","ve","vi","vo","wa","wo","xh","yi","yo","za","zh","zu"]},{"type":"array","items":{"type":"string","enum":["aa","ab","ae","af","ak","am","an","ar","as","av","ay","az","ba","be","bg","bi","bm","bn","bo","br","bs","ca","ce","ch","co","cr","cs","cu","cv","cy","da","de","dv","dz","ee","el","en","eo","es","et","eu","fa","ff","fi","fj","fo","fr","fy","ga","gd","gl","gn","gu","gv","ha","he","hi","ho","hr","ht","hu","hy","hz","ia","id","ie","ig","ii","ik","io","is","it","iu","ja","jv","ka","kg","ki","kj","kk","kl","km","kn","ko","kr","ks","ku","kv","kw","ky","la","lb","lg","li","ln","lo","lt","lu","lv","mg","mh","mi","mk","ml","mn","mr","ms","mt","my","na","nb","nd","ne","ng","nl","nn","no","nr","nv","ny","oc","oj","om","or","os","pa","pi","pl","ps","pt","qu","rm","rn","ro","ru","rw","sa","sc","sd","se","sg","si","sk","sl","sm","sn","so","sq","sr","ss","st","su","sv","sw","ta","te","tg","th","ti","tk","tl","tn","to","tr","ts","tt","tw","ty","ug","uk","ur","uz","ve","vi","vo","wa","wo","xh","yi","yo","za","zh","zu"]}},{"type":"null"}]},"from":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"replyingTo":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"mentioning":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"verified":{"type":["boolean","null"]},"near":{"type":["object","null"],"properties":{"country":{"type":["string","null"]},"state":{"type":["string","null"]},"city":{"type":["string","null"]}},"required":["country","state","city"]},"retweets":{"type":["boolean","null"]},"replies":{"type":["boolean","null"]},"quotes":{"type":["boolean","null"]},"hashtags":{"type":["boolean","null"]},"news":{"type":["boolean","null"]},"sfw":{"type":["boolean","null"]},"videos":{"type":["boolean","null"]},"links":{"type":["boolean","null"]},"place":{"anyOf":[{"type":"string","enum":["96683cc9126741d1","7142eb97ae21e839","4ec01c9dbc693497","463f5d9615d7d1be","fbd6d2f5a4e4a15e","e8ad2641c1cb666c","e0060cda70f5f341","de599025180e2ee7","65b4760a2b411e11","94965b2c45386f87","25530ba03b7d90c6","f54a2170ff4b15f7","3376992a082d67c7","30410557050f13a5","4e7c21fd2af027c6","f3bfc7dcc928977f","ecdce75d48b13b64","d9074951d5976bdf","c799e2d3a79f810e","81b8dcbe189773f2","78bfaf3f12c05982","ea679934779f45c7","8198e85105936d3c","879d7cfc66c9c290","6b5d375c346e3be9","c29833e68a86e703","82b141af443cb1b8","2ee7eeaa84dbe65a","1ef1183ed7056dc1","e7c97cdfef3a741a","e222580e9a58b499","d0e642e8a900f679","d5cde4dddd7e6f94","a9928b6eaeb54f86","34ed2e67dd5a22bb","58f54743b1a62911","8d65596349ee2e01","f7531639e8db5e12","f0af1239cbebb474","1d834adff5d584df","6416b8512febefc9","1b107df3ccc0aaa1","4d3b316fe2e52b29","3b98b02fba3f9753","47a3cf27863714de","3f14ce28dc7c4566","06ef846bfc783874","0b039ce18ddf1cb9","c00e5392b3fa46fb","173c2bb9d42baaa5","2edb6e240797c549","0639360bd49a15e3","288de3df481163e8"]},{"type":"array","items":{"type":"string","enum":["96683cc9126741d1","7142eb97ae21e839","4ec01c9dbc693497","463f5d9615d7d1be","fbd6d2f5a4e4a15e","e8ad2641c1cb666c","e0060cda70f5f341","de599025180e2ee7","65b4760a2b411e11","94965b2c45386f87","25530ba03b7d90c6","f54a2170ff4b15f7","3376992a082d67c7","30410557050f13a5","4e7c21fd2af027c6","f3bfc7dcc928977f","ecdce75d48b13b64","d9074951d5976bdf","c799e2d3a79f810e","81b8dcbe189773f2","78bfaf3f12c05982","ea679934779f45c7","8198e85105936d3c","879d7cfc66c9c290","6b5d375c346e3be9","c29833e68a86e703","82b141af443cb1b8","2ee7eeaa84dbe65a","1ef1183ed7056dc1","e7c97cdfef3a741a","e222580e9a58b499","d0e642e8a900f679","d5cde4dddd7e6f94","a9928b6eaeb54f86","34ed2e67dd5a22bb","58f54743b1a62911","8d65596349ee2e01","f7531639e8db5e12","f0af1239cbebb474","1d834adff5d584df","6416b8512febefc9","1b107df3ccc0aaa1","4d3b316fe2e52b29","3b98b02fba3f9753","47a3cf27863714de","3f14ce28dc7c4566","06ef846bfc783874","0b039ce18ddf1cb9","c00e5392b3fa46fb","173c2bb9d42baaa5","2edb6e240797c549","0639360bd49a15e3","288de3df481163e8"]}},{"type":"null"}]},"tags":{"type":["boolean","null"]},"minFollowers":{"type":["number","null"]},"minFollowing":{"type":["number","null"]},"minTweets":{"type":["number","null"]},"canDM":{"type":["boolean","null"]}},"default":{}}},"required":["queries"],"title":"Queries with global filters"},{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","examples":["\"CRM alternative\" OR \"switching CRMs\"","CRM (recommend OR recommendation) -hiring"]},"filters":{"type":["object","null"],"properties":{"images":{"type":["boolean","null"]},"url":{"type":["string","null"],"pattern":"^(?:(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,6})$"},"lang":{"anyOf":[{"type":"string","enum":["aa","ab","ae","af","ak","am","an","ar","as","av","ay","az","ba","be","bg","bi","bm","bn","bo","br","bs","ca","ce","ch","co","cr","cs","cu","cv","cy","da","de","dv","dz","ee","el","en","eo","es","et","eu","fa","ff","fi","fj","fo","fr","fy","ga","gd","gl","gn","gu","gv","ha","he","hi","ho","hr","ht","hu","hy","hz","ia","id","ie","ig","ii","ik","io","is","it","iu","ja","jv","ka","kg","ki","kj","kk","kl","km","kn","ko","kr","ks","ku","kv","kw","ky","la","lb","lg","li","ln","lo","lt","lu","lv","mg","mh","mi","mk","ml","mn","mr","ms","mt","my","na","nb","nd","ne","ng","nl","nn","no","nr","nv","ny","oc","oj","om","or","os","pa","pi","pl","ps","pt","qu","rm","rn","ro","ru","rw","sa","sc","sd","se","sg","si","sk","sl","sm","sn","so","sq","sr","ss","st","su","sv","sw","ta","te","tg","th","ti","tk","tl","tn","to","tr","ts","tt","tw","ty","ug","uk","ur","uz","ve","vi","vo","wa","wo","xh","yi","yo","za","zh","zu"]},{"type":"array","items":{"type":"string","enum":["aa","ab","ae","af","ak","am","an","ar","as","av","ay","az","ba","be","bg","bi","bm","bn","bo","br","bs","ca","ce","ch","co","cr","cs","cu","cv","cy","da","de","dv","dz","ee","el","en","eo","es","et","eu","fa","ff","fi","fj","fo","fr","fy","ga","gd","gl","gn","gu","gv","ha","he","hi","ho","hr","ht","hu","hy","hz","ia","id","ie","ig","ii","ik","io","is","it","iu","ja","jv","ka","kg","ki","kj","kk","kl","km","kn","ko","kr","ks","ku","kv","kw","ky","la","lb","lg","li","ln","lo","lt","lu","lv","mg","mh","mi","mk","ml","mn","mr","ms","mt","my","na","nb","nd","ne","ng","nl","nn","no","nr","nv","ny","oc","oj","om","or","os","pa","pi","pl","ps","pt","qu","rm","rn","ro","ru","rw","sa","sc","sd","se","sg","si","sk","sl","sm","sn","so","sq","sr","ss","st","su","sv","sw","ta","te","tg","th","ti","tk","tl","tn","to","tr","ts","tt","tw","ty","ug","uk","ur","uz","ve","vi","vo","wa","wo","xh","yi","yo","za","zh","zu"]}},{"type":"null"}]},"from":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"replyingTo":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"mentioning":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"verified":{"type":["boolean","null"]},"near":{"type":["object","null"],"properties":{"country":{"type":["string","null"]},"state":{"type":["string","null"]},"city":{"type":["string","null"]}},"required":["country","state","city"]},"retweets":{"type":["boolean","null"]},"replies":{"type":["boolean","null"]},"quotes":{"type":["boolean","null"]},"hashtags":{"type":["boolean","null"]},"news":{"type":["boolean","null"]},"sfw":{"type":["boolean","null"]},"videos":{"type":["boolean","null"]},"links":{"type":["boolean","null"]},"place":{"anyOf":[{"type":"string","enum":["96683cc9126741d1","7142eb97ae21e839","4ec01c9dbc693497","463f5d9615d7d1be","fbd6d2f5a4e4a15e","e8ad2641c1cb666c","e0060cda70f5f341","de599025180e2ee7","65b4760a2b411e11","94965b2c45386f87","25530ba03b7d90c6","f54a2170ff4b15f7","3376992a082d67c7","30410557050f13a5","4e7c21fd2af027c6","f3bfc7dcc928977f","ecdce75d48b13b64","d9074951d5976bdf","c799e2d3a79f810e","81b8dcbe189773f2","78bfaf3f12c05982","ea679934779f45c7","8198e85105936d3c","879d7cfc66c9c290","6b5d375c346e3be9","c29833e68a86e703","82b141af443cb1b8","2ee7eeaa84dbe65a","1ef1183ed7056dc1","e7c97cdfef3a741a","e222580e9a58b499","d0e642e8a900f679","d5cde4dddd7e6f94","a9928b6eaeb54f86","34ed2e67dd5a22bb","58f54743b1a62911","8d65596349ee2e01","f7531639e8db5e12","f0af1239cbebb474","1d834adff5d584df","6416b8512febefc9","1b107df3ccc0aaa1","4d3b316fe2e52b29","3b98b02fba3f9753","47a3cf27863714de","3f14ce28dc7c4566","06ef846bfc783874","0b039ce18ddf1cb9","c00e5392b3fa46fb","173c2bb9d42baaa5","2edb6e240797c549","0639360bd49a15e3","288de3df481163e8"]},{"type":"array","items":{"type":"string","enum":["96683cc9126741d1","7142eb97ae21e839","4ec01c9dbc693497","463f5d9615d7d1be","fbd6d2f5a4e4a15e","e8ad2641c1cb666c","e0060cda70f5f341","de599025180e2ee7","65b4760a2b411e11","94965b2c45386f87","25530ba03b7d90c6","f54a2170ff4b15f7","3376992a082d67c7","30410557050f13a5","4e7c21fd2af027c6","f3bfc7dcc928977f","ecdce75d48b13b64","d9074951d5976bdf","c799e2d3a79f810e","81b8dcbe189773f2","78bfaf3f12c05982","ea679934779f45c7","8198e85105936d3c","879d7cfc66c9c290","6b5d375c346e3be9","c29833e68a86e703","82b141af443cb1b8","2ee7eeaa84dbe65a","1ef1183ed7056dc1","e7c97cdfef3a741a","e222580e9a58b499","d0e642e8a900f679","d5cde4dddd7e6f94","a9928b6eaeb54f86","34ed2e67dd5a22bb","58f54743b1a62911","8d65596349ee2e01","f7531639e8db5e12","f0af1239cbebb474","1d834adff5d584df","6416b8512febefc9","1b107df3ccc0aaa1","4d3b316fe2e52b29","3b98b02fba3f9753","47a3cf27863714de","3f14ce28dc7c4566","06ef846bfc783874","0b039ce18ddf1cb9","c00e5392b3fa46fb","173c2bb9d42baaa5","2edb6e240797c549","0639360bd49a15e3","288de3df481163e8"]}},{"type":"null"}]},"tags":{"type":["boolean","null"]},"minFollowers":{"type":["number","null"]},"minFollowing":{"type":["number","null"]},"minTweets":{"type":["number","null"]},"canDM":{"type":["boolean","null"]}},"default":{}}},"required":["value"]},"minItems":1,"maxItems":15,"deprecated":true,"title":"Queries only"}]},"onlyTweets":{"type":"boolean","default":false},"responseTypes":{"type":["object","null"],"properties":{"like":{"type":["boolean","null"],"default":true},"reply":{"type":["boolean","null"],"default":true},"retweet":{"type":["boolean","null"],"default":true},"follow":{"type":["boolean","null"],"default":true},"dm":{"type":["boolean","null"],"default":true},"quote":{"type":["boolean","null"],"default":true}},"default":null}},"required":["searchQueries"],"title":"Twitter"},{"type":"object","properties":{"searchQueries":{"anyOf":[{"type":"object","properties":{"queries":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","examples":["CRM (alternative OR switching OR \"moving away\")","\"sales team\" \"new CRM\""]},"filters":{"type":["object","null"],"properties":{"hasImage":{"type":["boolean","null"]},"hasVideo":{"type":["boolean","null"]},"hasHashtags":{"type":["boolean","null"]},"hasLink":{"type":["boolean","null"]},"hasDocument":{"type":["boolean","null"]},"posterType":{"type":["string","null"],"enum":["Person","Company",null]},"isJobPosting":{"type":["boolean","null"]},"isQuoting":{"type":["boolean","null"]},"isCelebration":{"type":["boolean","null"]},"permission.canReact":{"type":["boolean","null"]},"permission.canComment":{"type":["boolean","null"]},"permission.canMessage":{"type":["boolean","null"]},"permission.canShare":{"type":["boolean","null"]},"profile.industry":{"anyOf":[{"type":"string","enum":["1","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115","116","117","118","119","120","121","122","123","124","125","126","127","128","129","130","131","132","133","134","135","136","137","138","139","140","141","142","143","145","146","147","148","150","201","256","298","332","341","345","356","382","383","384","385","386","387","388","389","390","397","398","400","404","406","408","413","419","428","431","435","436","453","460","481","495","504","529","562","564","598","615","616","622","625","679","690","703","709","722","727","743","773","779","784","794","799","840","849","861","871","873","876","883","887","901","923","928","935","964","973","983","994","998","1005","1029","1042","1080","1090","1095","1128","1137","1153","1157","1166","1171","1178","1187","1206","1208","1212","1221","1222","1230","1231","1250","1257","1262","1267","1285","1292","1309","1319","1324","1339","1359","1370","1407","1409","1423","1424","1431","1445","1481","1495","1497","1504","1505","1512","1517","1520","1532","1573","1594","1600","1602","1611","1623","1625","1633","1641","1644","1649","1673","1678","1696","1713","1720","1725","1737","1738","1742","1743","1745","1750","1757","1759","1770","1779","1786","1798","1810","1855","1862","1905","1909","1911","1912","1916","1923","1925","1931","1938","1956","1958","1965","1981","1986","1999","2012","2018","2019","2020","2025","2027","2029","2040","2045","2048","2050","2054","2060","2063","2069","2074","2077","2081","2091","2112","2122","2125","2128","2130","2133","2135","2139","2142","2143","2159","2161","2163","2167","2179","2181","2194","2197","2212","2214","2217","2226","2240","2247","2253","2255","2258","2259","2272","2282","2318","2353","2358","2366","2369","2374","2375","2391","2401","2458","2468","2489","2500","2934","3065","3068","3070","3081","3085","3086","3089","3095","3096","3099","3100","3101","3102","3103","3104","3105","3106","3107","3124","3125","3126","3127","3128","3129","3130","3131","3132","3133","3134","3186","3240","3241","3242","3243","3244","3245","3246","3247","3248","3249","3250","3251","3252","3253","3254","3255","3256"]},{"type":"array","items":{"type":"string","enum":["1","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115","116","117","118","119","120","121","122","123","124","125","126","127","128","129","130","131","132","133","134","135","136","137","138","139","140","141","142","143","145","146","147","148","150","201","256","298","332","341","345","356","382","383","384","385","386","387","388","389","390","397","398","400","404","406","408","413","419","428","431","435","436","453","460","481","495","504","529","562","564","598","615","616","622","625","679","690","703","709","722","727","743","773","779","784","794","799","840","849","861","871","873","876","883","887","901","923","928","935","964","973","983","994","998","1005","1029","1042","1080","1090","1095","1128","1137","1153","1157","1166","1171","1178","1187","1206","1208","1212","1221","1222","1230","1231","1250","1257","1262","1267","1285","1292","1309","1319","1324","1339","1359","1370","1407","1409","1423","1424","1431","1445","1481","1495","1497","1504","1505","1512","1517","1520","1532","1573","1594","1600","1602","1611","1623","1625","1633","1641","1644","1649","1673","1678","1696","1713","1720","1725","1737","1738","1742","1743","1745","1750","1757","1759","1770","1779","1786","1798","1810","1855","1862","1905","1909","1911","1912","1916","1923","1925","1931","1938","1956","1958","1965","1981","1986","1999","2012","2018","2019","2020","2025","2027","2029","2040","2045","2048","2050","2054","2060","2063","2069","2074","2077","2081","2091","2112","2122","2125","2128","2130","2133","2135","2139","2142","2143","2159","2161","2163","2167","2179","2181","2194","2197","2212","2214","2217","2226","2240","2247","2253","2255","2258","2259","2272","2282","2318","2353","2358","2366","2369","2374","2375","2391","2401","2458","2468","2489","2500","2934","3065","3068","3070","3081","3085","3086","3089","3095","3096","3099","3100","3101","3102","3103","3104","3105","3106","3107","3124","3125","3126","3127","3128","3129","3130","3131","3132","3133","3134","3186","3240","3241","3242","3243","3244","3245","3246","3247","3248","3249","3250","3251","3252","3253","3254","3255","3256"]}},{"type":"null"}]},"profile.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"profile.minFollowerCount":{"type":["number","null"]},"company.minFollowerCount":{"type":["number","null"]},"profile.title":{"type":["string","null"]},"profile.currentPosition.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"profile.currentPosition.hasJob":{"type":["boolean","null"]},"profile.currentPosition.minEmployeeCount":{"type":["number","null"]},"profile.currentPosition.maxEmployeeCount":{"type":["number","null"]},"company.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"company.companyAge":{"type":["number","null"]},"company.companySize":{"type":["number","null"]},"company.contactInfo.hasWebsite":{"type":["boolean","null"]},"company.contactInfo.hasPhoneNumber":{"type":["boolean","null"]},"company.companyType":{"type":["string","null"],"enum":["PROFIT","NON_PROFIT",null]}},"default":{}}},"required":["value"]},"minItems":1,"maxItems":15},"global":{"type":"object","properties":{"hasImage":{"type":["boolean","null"]},"hasVideo":{"type":["boolean","null"]},"hasHashtags":{"type":["boolean","null"]},"hasLink":{"type":["boolean","null"]},"hasDocument":{"type":["boolean","null"]},"posterType":{"type":["string","null"],"enum":["Person","Company",null]},"isJobPosting":{"type":["boolean","null"]},"isQuoting":{"type":["boolean","null"]},"isCelebration":{"type":["boolean","null"]},"permission.canReact":{"type":["boolean","null"]},"permission.canComment":{"type":["boolean","null"]},"permission.canMessage":{"type":["boolean","null"]},"permission.canShare":{"type":["boolean","null"]},"profile.industry":{"anyOf":[{"type":"string","enum":["1","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115","116","117","118","119","120","121","122","123","124","125","126","127","128","129","130","131","132","133","134","135","136","137","138","139","140","141","142","143","145","146","147","148","150","201","256","298","332","341","345","356","382","383","384","385","386","387","388","389","390","397","398","400","404","406","408","413","419","428","431","435","436","453","460","481","495","504","529","562","564","598","615","616","622","625","679","690","703","709","722","727","743","773","779","784","794","799","840","849","861","871","873","876","883","887","901","923","928","935","964","973","983","994","998","1005","1029","1042","1080","1090","1095","1128","1137","1153","1157","1166","1171","1178","1187","1206","1208","1212","1221","1222","1230","1231","1250","1257","1262","1267","1285","1292","1309","1319","1324","1339","1359","1370","1407","1409","1423","1424","1431","1445","1481","1495","1497","1504","1505","1512","1517","1520","1532","1573","1594","1600","1602","1611","1623","1625","1633","1641","1644","1649","1673","1678","1696","1713","1720","1725","1737","1738","1742","1743","1745","1750","1757","1759","1770","1779","1786","1798","1810","1855","1862","1905","1909","1911","1912","1916","1923","1925","1931","1938","1956","1958","1965","1981","1986","1999","2012","2018","2019","2020","2025","2027","2029","2040","2045","2048","2050","2054","2060","2063","2069","2074","2077","2081","2091","2112","2122","2125","2128","2130","2133","2135","2139","2142","2143","2159","2161","2163","2167","2179","2181","2194","2197","2212","2214","2217","2226","2240","2247","2253","2255","2258","2259","2272","2282","2318","2353","2358","2366","2369","2374","2375","2391","2401","2458","2468","2489","2500","2934","3065","3068","3070","3081","3085","3086","3089","3095","3096","3099","3100","3101","3102","3103","3104","3105","3106","3107","3124","3125","3126","3127","3128","3129","3130","3131","3132","3133","3134","3186","3240","3241","3242","3243","3244","3245","3246","3247","3248","3249","3250","3251","3252","3253","3254","3255","3256"]},{"type":"array","items":{"type":"string","enum":["1","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115","116","117","118","119","120","121","122","123","124","125","126","127","128","129","130","131","132","133","134","135","136","137","138","139","140","141","142","143","145","146","147","148","150","201","256","298","332","341","345","356","382","383","384","385","386","387","388","389","390","397","398","400","404","406","408","413","419","428","431","435","436","453","460","481","495","504","529","562","564","598","615","616","622","625","679","690","703","709","722","727","743","773","779","784","794","799","840","849","861","871","873","876","883","887","901","923","928","935","964","973","983","994","998","1005","1029","1042","1080","1090","1095","1128","1137","1153","1157","1166","1171","1178","1187","1206","1208","1212","1221","1222","1230","1231","1250","1257","1262","1267","1285","1292","1309","1319","1324","1339","1359","1370","1407","1409","1423","1424","1431","1445","1481","1495","1497","1504","1505","1512","1517","1520","1532","1573","1594","1600","1602","1611","1623","1625","1633","1641","1644","1649","1673","1678","1696","1713","1720","1725","1737","1738","1742","1743","1745","1750","1757","1759","1770","1779","1786","1798","1810","1855","1862","1905","1909","1911","1912","1916","1923","1925","1931","1938","1956","1958","1965","1981","1986","1999","2012","2018","2019","2020","2025","2027","2029","2040","2045","2048","2050","2054","2060","2063","2069","2074","2077","2081","2091","2112","2122","2125","2128","2130","2133","2135","2139","2142","2143","2159","2161","2163","2167","2179","2181","2194","2197","2212","2214","2217","2226","2240","2247","2253","2255","2258","2259","2272","2282","2318","2353","2358","2366","2369","2374","2375","2391","2401","2458","2468","2489","2500","2934","3065","3068","3070","3081","3085","3086","3089","3095","3096","3099","3100","3101","3102","3103","3104","3105","3106","3107","3124","3125","3126","3127","3128","3129","3130","3131","3132","3133","3134","3186","3240","3241","3242","3243","3244","3245","3246","3247","3248","3249","3250","3251","3252","3253","3254","3255","3256"]}},{"type":"null"}]},"profile.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"profile.minFollowerCount":{"type":["number","null"]},"company.minFollowerCount":{"type":["number","null"]},"profile.title":{"type":["string","null"]},"profile.currentPosition.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"profile.currentPosition.hasJob":{"type":["boolean","null"]},"profile.currentPosition.minEmployeeCount":{"type":["number","null"]},"profile.currentPosition.maxEmployeeCount":{"type":["number","null"]},"company.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"company.companyAge":{"type":["number","null"]},"company.companySize":{"type":["number","null"]},"company.contactInfo.hasWebsite":{"type":["boolean","null"]},"company.contactInfo.hasPhoneNumber":{"type":["boolean","null"]},"company.companyType":{"type":["string","null"],"enum":["PROFIT","NON_PROFIT",null]}},"default":{}}},"required":["queries"],"title":"Queries with global filters"},{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","examples":["CRM (alternative OR switching OR \"moving away\")","\"sales team\" \"new CRM\""]},"filters":{"type":["object","null"],"properties":{"hasImage":{"type":["boolean","null"]},"hasVideo":{"type":["boolean","null"]},"hasHashtags":{"type":["boolean","null"]},"hasLink":{"type":["boolean","null"]},"hasDocument":{"type":["boolean","null"]},"posterType":{"type":["string","null"],"enum":["Person","Company",null]},"isJobPosting":{"type":["boolean","null"]},"isQuoting":{"type":["boolean","null"]},"isCelebration":{"type":["boolean","null"]},"permission.canReact":{"type":["boolean","null"]},"permission.canComment":{"type":["boolean","null"]},"permission.canMessage":{"type":["boolean","null"]},"permission.canShare":{"type":["boolean","null"]},"profile.industry":{"anyOf":[{"type":"string","enum":["1","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115","116","117","118","119","120","121","122","123","124","125","126","127","128","129","130","131","132","133","134","135","136","137","138","139","140","141","142","143","145","146","147","148","150","201","256","298","332","341","345","356","382","383","384","385","386","387","388","389","390","397","398","400","404","406","408","413","419","428","431","435","436","453","460","481","495","504","529","562","564","598","615","616","622","625","679","690","703","709","722","727","743","773","779","784","794","799","840","849","861","871","873","876","883","887","901","923","928","935","964","973","983","994","998","1005","1029","1042","1080","1090","1095","1128","1137","1153","1157","1166","1171","1178","1187","1206","1208","1212","1221","1222","1230","1231","1250","1257","1262","1267","1285","1292","1309","1319","1324","1339","1359","1370","1407","1409","1423","1424","1431","1445","1481","1495","1497","1504","1505","1512","1517","1520","1532","1573","1594","1600","1602","1611","1623","1625","1633","1641","1644","1649","1673","1678","1696","1713","1720","1725","1737","1738","1742","1743","1745","1750","1757","1759","1770","1779","1786","1798","1810","1855","1862","1905","1909","1911","1912","1916","1923","1925","1931","1938","1956","1958","1965","1981","1986","1999","2012","2018","2019","2020","2025","2027","2029","2040","2045","2048","2050","2054","2060","2063","2069","2074","2077","2081","2091","2112","2122","2125","2128","2130","2133","2135","2139","2142","2143","2159","2161","2163","2167","2179","2181","2194","2197","2212","2214","2217","2226","2240","2247","2253","2255","2258","2259","2272","2282","2318","2353","2358","2366","2369","2374","2375","2391","2401","2458","2468","2489","2500","2934","3065","3068","3070","3081","3085","3086","3089","3095","3096","3099","3100","3101","3102","3103","3104","3105","3106","3107","3124","3125","3126","3127","3128","3129","3130","3131","3132","3133","3134","3186","3240","3241","3242","3243","3244","3245","3246","3247","3248","3249","3250","3251","3252","3253","3254","3255","3256"]},{"type":"array","items":{"type":"string","enum":["1","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115","116","117","118","119","120","121","122","123","124","125","126","127","128","129","130","131","132","133","134","135","136","137","138","139","140","141","142","143","145","146","147","148","150","201","256","298","332","341","345","356","382","383","384","385","386","387","388","389","390","397","398","400","404","406","408","413","419","428","431","435","436","453","460","481","495","504","529","562","564","598","615","616","622","625","679","690","703","709","722","727","743","773","779","784","794","799","840","849","861","871","873","876","883","887","901","923","928","935","964","973","983","994","998","1005","1029","1042","1080","1090","1095","1128","1137","1153","1157","1166","1171","1178","1187","1206","1208","1212","1221","1222","1230","1231","1250","1257","1262","1267","1285","1292","1309","1319","1324","1339","1359","1370","1407","1409","1423","1424","1431","1445","1481","1495","1497","1504","1505","1512","1517","1520","1532","1573","1594","1600","1602","1611","1623","1625","1633","1641","1644","1649","1673","1678","1696","1713","1720","1725","1737","1738","1742","1743","1745","1750","1757","1759","1770","1779","1786","1798","1810","1855","1862","1905","1909","1911","1912","1916","1923","1925","1931","1938","1956","1958","1965","1981","1986","1999","2012","2018","2019","2020","2025","2027","2029","2040","2045","2048","2050","2054","2060","2063","2069","2074","2077","2081","2091","2112","2122","2125","2128","2130","2133","2135","2139","2142","2143","2159","2161","2163","2167","2179","2181","2194","2197","2212","2214","2217","2226","2240","2247","2253","2255","2258","2259","2272","2282","2318","2353","2358","2366","2369","2374","2375","2391","2401","2458","2468","2489","2500","2934","3065","3068","3070","3081","3085","3086","3089","3095","3096","3099","3100","3101","3102","3103","3104","3105","3106","3107","3124","3125","3126","3127","3128","3129","3130","3131","3132","3133","3134","3186","3240","3241","3242","3243","3244","3245","3246","3247","3248","3249","3250","3251","3252","3253","3254","3255","3256"]}},{"type":"null"}]},"profile.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"profile.minFollowerCount":{"type":["number","null"]},"company.minFollowerCount":{"type":["number","null"]},"profile.title":{"type":["string","null"]},"profile.currentPosition.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"profile.currentPosition.hasJob":{"type":["boolean","null"]},"profile.currentPosition.minEmployeeCount":{"type":["number","null"]},"profile.currentPosition.maxEmployeeCount":{"type":["number","null"]},"company.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"company.companyAge":{"type":["number","null"]},"company.companySize":{"type":["number","null"]},"company.contactInfo.hasWebsite":{"type":["boolean","null"]},"company.contactInfo.hasPhoneNumber":{"type":["boolean","null"]},"company.companyType":{"type":["string","null"],"enum":["PROFIT","NON_PROFIT",null]}},"default":{}}},"required":["value"]},"minItems":1,"maxItems":15,"deprecated":true,"title":"Queries only"}]},"responseTypes":{"type":["object","null"],"properties":{"react":{"type":["boolean","null"],"default":true},"comment":{"type":["boolean","null"],"default":true},"connect":{"type":["boolean","null"],"default":true},"repost":{"type":["boolean","null"],"default":true},"quote":{"type":["boolean","null"],"default":true}},"default":null}},"required":["searchQueries"],"title":"LinkedIn"},{"type":"object","properties":{"searchQueries":{"type":"object","properties":{"queries":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","examples":["\"CRM alternative\" OR \"switching CRMs\"","CRM (recommend OR recommendation)"]},"filters":{"type":["object","null"],"properties":{"subreddits":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"excludeSubreddits":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"canReply":{"type":["boolean","null"]},"hasMedia":{"type":["boolean","null"]},"canCrosspost":{"type":["boolean","null"]},"containsSpoilers":{"type":["boolean","null"]},"containsLinks":{"type":["boolean","null"]},"subType":{"type":["string","null"],"enum":["public","restricted",null]},"contentType":{"type":["string","null"],"enum":["post","comment",null]},"lang":{"type":["string","null"],"enum":["French","Italian","Spanish","English","German","Chinese","Japanese","Russian","Arabic","Hebrew","Polish","Hindi","Urdu","Portuguese","Thai","Turkish","Ukrainian","Vietnamese","Greek","Malay","Korean","Bengali","Irish","Punjabi","Swedish","Welsh","Armenian","Danish","Dutch","Estonian","Finnish",null]},"sentiment":{"type":["string","null"],"enum":["positive","negative","neutral",null]},"users":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"minSubSize":{"type":["number","null"]},"domains":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"minUserKarma":{"type":["number","null"]},"minUserAccountAge":{"type":["number","null"]}},"default":{}}},"required":["value"]},"minItems":1,"maxItems":15},"global":{"type":"object","properties":{"subreddits":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"excludeSubreddits":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"canReply":{"type":["boolean","null"]},"hasMedia":{"type":["boolean","null"]},"canCrosspost":{"type":["boolean","null"]},"containsSpoilers":{"type":["boolean","null"]},"containsLinks":{"type":["boolean","null"]},"subType":{"type":["string","null"],"enum":["public","restricted",null]},"contentType":{"type":["string","null"],"enum":["post","comment",null]},"lang":{"type":["string","null"],"enum":["French","Italian","Spanish","English","German","Chinese","Japanese","Russian","Arabic","Hebrew","Polish","Hindi","Urdu","Portuguese","Thai","Turkish","Ukrainian","Vietnamese","Greek","Malay","Korean","Bengali","Irish","Punjabi","Swedish","Welsh","Armenian","Danish","Dutch","Estonian","Finnish",null]},"sentiment":{"type":["string","null"],"enum":["positive","negative","neutral",null]},"users":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"minSubSize":{"type":["number","null"]},"domains":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"minUserKarma":{"type":["number","null"]},"minUserAccountAge":{"type":["number","null"]}},"default":{}}},"required":["queries"]},"responseTypes":{"type":["object","null"],"properties":{"upvote":{"type":["boolean","null"],"default":true},"downvote":{"type":["boolean","null"],"default":true},"comment":{"type":["boolean","null"],"default":true},"message":{"type":["boolean","null"],"default":true}},"default":null},"subSafeResponses":{"type":"boolean","default":true}},"required":["searchQueries"],"title":"Reddit"},{"type":"object","properties":{"searchQueries":{"type":"object","properties":{"queries":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","examples":["CRM recommendations","switching CRM"]},"filters":{"type":["object","null"],"properties":{"lang":{"type":["string","null"],"enum":["fr","it","es","en","de","zh","ja","ru","ar","he","pl","hi","ur","pt","th","tr","uk","vi","el","ms","ko","bn","ga","pa","sv","cy","hy","da","nl","et","fi",null]},"hasHashtags":{"type":["boolean","null"]},"hasLinks":{"type":["boolean","null"]},"location":{"type":["string","null"],"enum":["107991659233606","106224666074625","106003956105810","108659242498155","111762725508574","114586701886732","115963528414384","108081209214649","110970792260960","110148382341970","106300959405546","106338002735968","106220079409935","111822758834362","104028629632792","113998391943532","105745629459139","105775436121898","108424279189115","112305682116972","112887355389124","103111876395954","109570449061083","108056275889020","104019619634224","103990676304130","109260602433140","109297442421359","107705532592043","106066949424984","103787786326610","110941395597405","114497808567786","102184499823699","111983945494775","106262189412553","115167478498675","105959272778333","109870912368806","105634782802493","115976748413086","112662855415315","108489419175297","108108762549844","109493702409366","110185085668702","105559566144042","109412232411040","109375499081852","110893392264912","105675929465006","106057819434480","109307099087536","105479049486624","105496622817769","101881036520836","105540216147364","112548152092705","105988062765295","110714572282163","110184922344060","110884905606108","116190411724975","102146663160831","110843418940484","109692899057899","107674002595670","109486839070556","103728359665916","106078429431815","114629675219759","113564935326488","108299645860446","104029736299647","115753025103602","105653082800923","114469421897671","103145123058362","103123839728353","108285455858477","104034969634202",null]}},"default":{}}},"required":["value"]},"minItems":1,"maxItems":10},"global":{"type":"object","properties":{"lang":{"type":["string","null"],"enum":["fr","it","es","en","de","zh","ja","ru","ar","he","pl","hi","ur","pt","th","tr","uk","vi","el","ms","ko","bn","ga","pa","sv","cy","hy","da","nl","et","fi",null]},"hasHashtags":{"type":["boolean","null"]},"hasLinks":{"type":["boolean","null"]},"location":{"type":["string","null"],"enum":["107991659233606","106224666074625","106003956105810","108659242498155","111762725508574","114586701886732","115963528414384","108081209214649","110970792260960","110148382341970","106300959405546","106338002735968","106220079409935","111822758834362","104028629632792","113998391943532","105745629459139","105775436121898","108424279189115","112305682116972","112887355389124","103111876395954","109570449061083","108056275889020","104019619634224","103990676304130","109260602433140","109297442421359","107705532592043","106066949424984","103787786326610","110941395597405","114497808567786","102184499823699","111983945494775","106262189412553","115167478498675","105959272778333","109870912368806","105634782802493","115976748413086","112662855415315","108489419175297","108108762549844","109493702409366","110185085668702","105559566144042","109412232411040","109375499081852","110893392264912","105675929465006","106057819434480","109307099087536","105479049486624","105496622817769","101881036520836","105540216147364","112548152092705","105988062765295","110714572282163","110184922344060","110884905606108","116190411724975","102146663160831","110843418940484","109692899057899","107674002595670","109486839070556","103728359665916","106078429431815","114629675219759","113564935326488","108299645860446","104029736299647","115753025103602","105653082800923","114469421897671","103145123058362","103123839728353","108285455858477","104034969634202",null]}},"default":{}}},"required":["queries"]},"responseTypes":{"type":["object","null"],"properties":{"upvote":{"type":["boolean","null"],"default":true},"comment":{"type":["boolean","null"],"default":true},"message":{"type":["boolean","null"],"default":true}},"default":null}},"required":["searchQueries"],"title":"Facebook"},{"type":"object","properties":{"users":{"type":"object","properties":{"value":{"type":["string","null"],"default":null,"description":"The people to monitor, as one string with one LinkedIn profile URL or username per line (max 5000). Set this yourself to monitor a fixed list. When `smartSync`, `smartSearch` or `connectionsSync` is set, leave it out: PitchGhost fills and maintains the list from that source.","examples":["https://www.linkedin.com/in/dana-whitfield\nhttps://www.linkedin.com/in/marcus-oyelaran\npriya-raman"]},"smartSync":{"oneOf":[{"type":"object","properties":{"crm":{"type":"string","enum":["hubspot"]},"list":{"type":"object","properties":{"name":{"type":"string"},"id":{"type":"string"},"url":{"type":"string"}},"required":["name","id","url"]},"cache":{"type":["array","null"],"items":{"type":"object","properties":{"profile":{"type":"string"},"recordId":{"type":"string"}},"required":["profile","recordId"]},"description":"Maintained by PitchGhost. Do not set."},"enrich":{"type":"boolean"},"syncType":{"type":"string","enum":["notes","task","none"]},"syncOptions":{"type":"object","properties":{"urgency":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"dueDate":{"type":"number","exclusiveMinimum":0,"maximum":31}},"default":{"urgency":"MEDIUM","dueDate":3},"required":["urgency","dueDate"]}},"required":["crm","list","syncType"],"title":"HubSpot"},{"type":"object","properties":{"syncType":{"type":"string","enum":["sequence","task","none"],"default":"none"},"crm":{"type":"string","enum":["apollo"]},"cache":{"type":["array","null"],"items":{"type":"object","properties":{"profile":{"type":"string"},"recordId":{"type":"string"}},"required":["profile","recordId"]},"description":"Maintained by PitchGhost. Do not set."},"list":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"syncOptions":{"type":"object","properties":{"priority":{"type":"string","enum":["low","medium","high"]},"due_at":{"type":["number","null"]},"user_id":{"type":"string"},"type":{"type":"string","enum":["call","outreach_manual_email","linkedin_step_connect","linkedin_step_view_profile","linkedin_step_interact_post","action_item"]},"status":{"type":"string","enum":["scheduled","completed","archived"]},"sequence_id":{"type":"string"},"emailer_campaign_id":{"type":"string"},"send_email_from_email_account_id":{"type":"string"}}}},"required":["crm","list"],"title":"Apollo"},{"type":"object","properties":{"crm":{"type":"string","enum":["salesforce"]},"list":{"type":"object","properties":{"name":{"type":"string"},"id":{"type":"string"},"url":{"type":"string"}},"required":["name","id","url"]},"enrich":{"type":"boolean"},"cache":{"type":["array","null"],"items":{"type":"object","properties":{"profile":{"type":"string"},"recordId":{"type":"string"}},"required":["profile","recordId"]},"description":"Maintained by PitchGhost. Do not set."},"syncType":{"type":"string","enum":["note","task","none"],"default":"none"},"binding":{"type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"company":{"type":"string"},"linkedin_url":{"type":"string"}},"required":["first_name","last_name","company","linkedin_url"]},"syncOptions":{"type":"object","properties":{"activityDate":{"type":["number","null"]},"task_ownerId":{"type":"string"}},"required":["activityDate","task_ownerId"]}},"required":["crm","list","binding"],"title":"Salesforce"},{"type":"object","properties":{"crm":{"type":"string","enum":["intercom"]},"segment":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"enrich":{"type":"boolean"},"binding":{"type":"object","properties":{"linkedin_url":{"type":"string"}}},"cache":{"type":["array","null"],"items":{"type":"object","properties":{"profile":{"type":"string"},"recordId":{"type":"string"}},"required":["profile","recordId"]},"description":"Maintained by PitchGhost. Do not set."},"syncType":{"type":"string","enum":["none","ticket"],"default":"none"},"syncOptions":{"type":"object","properties":{"skip_notification":{"type":"boolean"},"ticket_type_id":{"type":"string"},"ticket_category":{"type":"string","enum":["Back-office","Tracker","Customer"]},"assignee_id":{"type":"string"}}}},"required":["crm","segment","binding"],"title":"Intercom"},{"type":"object","properties":{"crm":{"type":"string","enum":["folk"]},"group":{"type":"object","properties":{"name":{"type":"string"},"id":{"type":"string"}},"required":["name","id"]},"enrich":{"type":"boolean"},"binding":{"type":"object","properties":{"linkedin_url":{"type":"string"}}},"cache":{"type":["array","null"],"items":{"type":"object","properties":{"profile":{"type":"string"},"recordId":{"type":"string"}},"required":["profile","recordId"]},"description":"Maintained by PitchGhost. Do not set."},"syncType":{"type":"string","enum":["none","note","interaction"],"default":"none"},"syncOptions":{"type":"object","properties":{"note_visibility":{"type":"string","enum":["public","private"],"default":"public"},"interaction_type":{"type":"string","enum":["linkedin","call","meeting","message","coffee"],"default":"linkedin"}}}},"required":["crm","group","binding"],"title":"Folk"},{"type":"object","properties":{"crm":{"type":"string","enum":["gohighlevel"]},"tag":{"type":"string"},"binding":{"type":"object","properties":{"linkedin_url":{"type":"string"}}},"cache":{"type":["array","null"],"items":{"type":"object","properties":{"profile":{"type":"string"},"recordId":{"type":"string"}},"required":["profile","recordId"]},"description":"Maintained by PitchGhost. Do not set."},"enrich":{"type":"boolean"},"syncType":{"type":"string","enum":["notes","task","none"],"default":"none"},"syncOptions":{"type":"object","properties":{"assignedTo":{"type":"string"},"dueDate":{"type":"number","exclusiveMinimum":0,"maximum":31}}}},"required":["crm","tag","binding"],"title":"HighLevel"},{"type":"null"}],"default":null,"description":"Monitor the people in a CRM list, segment, group or tag instead of a fixed list. The CRM must already be connected in PitchGhost. `crm` picks the CRM and decides which other fields apply."},"smartSearch":{"type":["object","null"],"properties":{"criteria":{"type":"object","properties":{"locations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"LinkedIn's numeric id for this item.","examples":[103644278]},"name":{"type":"string","description":"The item's display name.","examples":["United States"]}},"required":["id","name"]}},"companies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"LinkedIn's numeric id for this item.","examples":[103644278]},"name":{"type":"string","description":"The item's display name.","examples":["United States"]}},"required":["id","name"]}},"pastCompanies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"LinkedIn's numeric id for this item.","examples":[103644278]},"name":{"type":"string","description":"The item's display name.","examples":["United States"]}},"required":["id","name"]}},"schools":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"LinkedIn's numeric id for this item.","examples":[103644278]},"name":{"type":"string","description":"The item's display name.","examples":["United States"]}},"required":["id","name"]}},"industries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"LinkedIn's numeric id for this item.","examples":[103644278]},"name":{"type":"string","description":"The item's display name.","examples":["United States"]}},"required":["id","name"]}},"services":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"LinkedIn's numeric id for this item.","examples":[103644278]},"name":{"type":"string","description":"The item's display name.","examples":["United States"]}},"required":["id","name"]}},"title":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string","minLength":1,"maxLength":512},"maxItems":30}],"description":"Job titles to match, up to 30.","examples":[["Head of Sales","VP Sales"]]}},"description":"Who to search for. At least one criterion is required."},"refinements":{"type":"object","properties":{"minFollowerCount":{"type":"number","minimum":0},"companyEmployeeMaxCount":{"type":"number","minimum":0},"companyEmployeeMinCount":{"type":"number","minimum":0},"premium":{"type":"boolean"},"verified":{"type":"boolean"}},"description":"Optional extra limits applied to the people the search returns."}},"default":null,"required":["criteria"],"description":"Monitor everyone matching a LinkedIn people search (job titles, companies, locations and so on) instead of a fixed list."},"connectionsSync":{"type":["object","null"],"properties":{"sourceProfile":{"type":"object","properties":{"integrationId":{"type":"string","description":"The `integrationId` of the connected LinkedIn account, from `GET /pitchghost/action-accounts`.","examples":["5d0c2a51-93b7-4f6e-b0a4-8e1f3c7d2a96"]},"vanityId":{"type":"string","description":"The account's LinkedIn vanity name: the last part of its profile URL, linkedin.com/in/<vanityId>.","examples":["dana-whitfield"]},"displayName":{"type":"string","description":"The account owner's name, shown in the app.","examples":["Dana Whitfield"]}},"required":["integrationId","vanityId","displayName"],"description":"The connected LinkedIn account whose connections are monitored."}},"default":null,"required":["sourceProfile"],"description":"Monitor the 1st-degree connections of one of your connected LinkedIn accounts instead of a fixed list."},"filters":{"type":"null","description":"Not used for this Ghost type. Leave out or send null."}},"description":"Who this Ghost monitors. Choose exactly one source: a fixed list in `value`, or one of `smartSync`, `smartSearch` or `connectionsSync`. Only one of those three can be set at a time.","examples":[{"value":"https://www.linkedin.com/in/dana-whitfield\nhttps://www.linkedin.com/in/marcus-oyelaran"},{"smartSearch":{"criteria":{"title":["Head of Sales","VP Sales"],"locations":[{"id":103644278,"name":"United States"}]},"refinements":{"companyEmployeeMinCount":11,"companyEmployeeMaxCount":200}}},{"connectionsSync":{"sourceProfile":{"integrationId":"5d0c2a51-93b7-4f6e-b0a4-8e1f3c7d2a96","vanityId":"dana-whitfield","displayName":"Dana Whitfield"}}}]},"responseTypes":{"type":["object","null"],"properties":{"react":{"type":["boolean","null"],"default":true},"comment":{"type":["boolean","null"],"default":true},"connect":{"type":["boolean","null"],"default":true},"repost":{"type":["boolean","null"],"default":true},"quote":{"type":["boolean","null"],"default":true}},"default":null,"description":"Which suggested response types to generate when `generateResponses` is on. Set a type to false to turn it off; null or omitted means all types.","examples":[{"comment":true,"react":true,"connect":false}]}},"required":["users"],"title":"LinkedIn People"},{"type":"object","properties":{"companies":{"type":"object","properties":{"value":{"type":["string","null"],"default":null,"description":"The company pages to monitor, as one string with one LinkedIn company page URL per line (max 5000). The page's slug, the last part of linkedin.com/company/<slug>, also works.","examples":["https://www.linkedin.com/company/acme-robotics\nnorthwind-traders"]},"filters":{"type":"null","description":"Not used for this Ghost type. Leave out or send null."}}},"responseTypes":{"type":["object","null"],"properties":{"react":{"type":["boolean","null"],"default":true},"comment":{"type":["boolean","null"],"default":true},"connect":{"type":["boolean","null"],"default":true},"repost":{"type":["boolean","null"],"default":true},"quote":{"type":["boolean","null"],"default":true}},"default":null}},"required":["companies"],"title":"LinkedIn Company"}],"description":"Service-specific settings for the Ghost"}},"required":["service","nickname","goal","threshold","frequency","maxFinds","serviceSettings"],"description":"Ghost object"},"SearchFindsResponse":{"type":"object","properties":{"finds":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the find","example":"123e4567-e89b-12d3-a456-426614174000"},"company_id":{"type":"string","format":"uuid","description":"Company that owns this find","example":"123e4567-e89b-12d3-a456-426614174000"},"ghost_id":{"type":["string","null"],"format":"uuid","description":"Ghost that discovered this find","example":"123e4567-e89b-12d3-a456-426614174000"},"contact_id":{"type":["string","null"],"format":"uuid","description":"Associated contact profile","example":"123e4567-e89b-12d3-a456-426614174000"},"assigned_uid":{"type":["string","null"],"format":"uuid","description":"User assigned to handle this find","example":"123e4567-e89b-12d3-a456-426614174000"},"service":{"type":"string","enum":["Twitter","LinkedIn","Reddit","Facebook","LinkedIn_People","LinkedIn_Company"],"description":"Platform where the find was discovered","example":"Twitter"},"unique_id":{"type":"string","description":"Platform-specific unique identifier","example":"1234567890123456789"},"data":{"anyOf":[{"type":"object","properties":{"quoted_status_id":{"type":["number","null"],"default":null},"quoted_status_id_str":{"type":["string","null"],"default":null},"is_quote_status":{"type":"boolean","default":false},"quoted_status":{"type":["object","null"],"properties":{"tweet_created_at":{"type":"string"},"id":{"type":"number"},"id_str":{"type":"string"},"text":{"type":["string","null"],"default":null},"full_text":{"type":["string","null"],"default":null},"source":{"type":"string"},"truncated":{"type":"boolean"},"in_reply_to_status_id":{"type":["number","null"],"default":null},"in_reply_to_status_id_str":{"type":["string","null"],"default":null},"in_reply_to_user_id":{"type":["number","null"],"default":null},"in_reply_to_user_id_str":{"type":["string","null"],"default":null},"in_reply_to_screen_name":{"type":["string","null"],"default":null},"user":{"type":"object","properties":{"id":{"type":"number"},"id_str":{"type":"string"},"name":{"type":"string"},"screen_name":{"type":"string"},"location":{"type":["string","null"],"default":null},"url":{"type":["string","null"],"default":null},"description":{"type":["string","null"],"default":null},"protected":{"type":"boolean"},"verified":{"type":"boolean"},"followers_count":{"type":"number"},"friends_count":{"type":"number"},"listed_count":{"type":"number"},"favourites_count":{"type":"number"},"statuses_count":{"type":"number"},"created_at":{"type":"string"},"profile_banner_url":{"type":["string","null"],"default":null},"profile_image_url_https":{"type":"string"},"can_dm":{"type":"boolean"}},"required":["id","id_str","name","screen_name","protected","verified","followers_count","friends_count","listed_count","favourites_count","statuses_count","created_at","profile_image_url_https","can_dm"]}},"default":null,"required":["tweet_created_at","id","id_str","source","truncated","user"]},"retweeted_status":{"type":["object","null"],"properties":{"tweet_created_at":{"type":"string"},"id":{"type":"number"},"id_str":{"type":"string"},"text":{"type":["string","null"],"default":null},"full_text":{"type":["string","null"],"default":null},"source":{"type":"string"},"truncated":{"type":"boolean"},"in_reply_to_status_id":{"type":["number","null"],"default":null},"in_reply_to_status_id_str":{"type":["string","null"],"default":null},"in_reply_to_user_id":{"type":["number","null"],"default":null},"in_reply_to_user_id_str":{"type":["string","null"],"default":null},"in_reply_to_screen_name":{"type":["string","null"],"default":null},"user":{"type":"object","properties":{"id":{"type":"number"},"id_str":{"type":"string"},"name":{"type":"string"},"screen_name":{"type":"string"},"location":{"type":["string","null"],"default":null},"url":{"type":["string","null"],"default":null},"description":{"type":["string","null"],"default":null},"protected":{"type":"boolean"},"verified":{"type":"boolean"},"followers_count":{"type":"number"},"friends_count":{"type":"number"},"listed_count":{"type":"number"},"favourites_count":{"type":"number"},"statuses_count":{"type":"number"},"created_at":{"type":"string"},"profile_banner_url":{"type":["string","null"],"default":null},"profile_image_url_https":{"type":"string"},"can_dm":{"type":"boolean"}},"required":["id","id_str","name","screen_name","protected","verified","followers_count","friends_count","listed_count","favourites_count","statuses_count","created_at","profile_image_url_https","can_dm"]}},"default":null,"required":["tweet_created_at","id","id_str","source","truncated","user"]},"quote_count":{"type":["number","null"],"default":null},"reply_count":{"type":"number"},"retweet_count":{"type":"number"},"favorite_count":{"type":["number","null"],"default":null},"lang":{"type":["string","null"],"default":"und"},"views_count":{"type":["number","null"],"default":null},"bookmark_count":{"type":"number"},"entities":{"type":"object","properties":{"user_mentions":{"type":"array","items":{"type":"object","properties":{"id_str":{"type":"string"},"name":{"type":"string"},"screen_name":{"type":"string"},"indices":{"type":"array","items":{"type":"number"}}},"required":["id_str","name","screen_name","indices"]},"default":[]},"urls":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"expanded_url":{"type":"string"},"display_url":{"type":"string"},"indices":{"type":"array","items":{"type":"number"}}},"required":["url","display_url","indices"]},"default":[]},"hashtags":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"indices":{"type":"array","items":{"type":"number"}}},"required":["text","indices"]},"default":[]},"symbols":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"indices":{"type":"array","items":{"type":"number"}}},"required":["text","indices"]},"default":[]},"media":{"type":"array","items":{"type":"object","properties":{"display_url":{"type":"string"},"expanded_url":{"type":"string"},"ext_alt_text":{"type":["string","null"],"default":null},"id":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"default":null},"id_str":{"type":"string"},"indices":{"type":"array","items":{"type":"number"}},"media_url_https":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string"},"ext_media_availability":{"type":"object","properties":{"status":{"type":"string","enum":["Available","Unavailable"]}},"required":["status"]},"media_key":{"type":"string","default":""},"sizes":{"anyOf":[{"type":"object","properties":{"large":{"type":["object","null"],"properties":{"h":{"type":"number"},"resize":{"type":["string","null"],"enum":["crop","fit",null],"default":"fit"},"w":{"type":"number"}},"default":null,"required":["h","w"]},"medium":{"type":["object","null"],"properties":{"h":{"type":"number"},"resize":{"type":["string","null"],"enum":["crop","fit",null],"default":"fit"},"w":{"type":"number"}},"default":null,"required":["h","w"]},"small":{"type":["object","null"],"properties":{"h":{"type":"number"},"resize":{"type":["string","null"],"enum":["crop","fit",null],"default":"fit"},"w":{"type":"number"}},"default":null,"required":["h","w"]},"thumb":{"type":["object","null"],"properties":{"h":{"type":"number"},"resize":{"type":["string","null"],"enum":["crop","fit",null],"default":"fit"},"w":{"type":"number"}},"default":null,"required":["h","w"]}}},{"type":"array","items":{"type":"object","properties":{"h":{"type":"number"},"resize":{"type":["string","null"],"enum":["crop","fit",null],"default":"fit"},"w":{"type":"number"}},"required":["h","w"]}}]},"original_info":{"type":"object","properties":{"width":{"type":"number"},"height":{"type":"number"},"focus_rects":{"type":"array","items":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"h":{"type":"number"},"w":{"type":"number"}},"required":["x","y","h","w"]},"default":[]}},"required":["width","height"]}},"required":["id_str","indices","type"]},"default":[]}}},"tweet_created_at":{"type":"string"},"id":{"type":"number"},"id_str":{"type":"string"},"text":{"type":["string","null"],"default":null},"full_text":{"type":["string","null"],"default":null},"source":{"type":"string"},"truncated":{"type":"boolean"},"in_reply_to_status_id":{"type":["number","null"],"default":null},"in_reply_to_status_id_str":{"type":["string","null"],"default":null},"in_reply_to_user_id":{"type":["number","null"],"default":null},"in_reply_to_user_id_str":{"type":["string","null"],"default":null},"in_reply_to_screen_name":{"type":["string","null"],"default":null},"user":{"type":"object","properties":{"id":{"type":"number"},"id_str":{"type":"string"},"name":{"type":"string"},"screen_name":{"type":"string"},"location":{"type":["string","null"],"default":null},"url":{"type":["string","null"],"default":null},"description":{"type":["string","null"],"default":null},"protected":{"type":"boolean"},"verified":{"type":"boolean"},"followers_count":{"type":"number"},"friends_count":{"type":"number"},"listed_count":{"type":"number"},"favourites_count":{"type":"number"},"statuses_count":{"type":"number"},"created_at":{"type":"string"},"profile_banner_url":{"type":["string","null"],"default":null},"profile_image_url_https":{"type":"string"},"can_dm":{"type":"boolean"}},"required":["id","id_str","name","screen_name","protected","verified","followers_count","friends_count","listed_count","favourites_count","statuses_count","created_at","profile_image_url_https","can_dm"]}},"required":["reply_count","retweet_count","bookmark_count","entities","tweet_created_at","id","id_str","source","truncated","user"],"title":"Tweet"},{"type":"object","properties":{"attached_image_content":{"type":["string","null"]},"attached_image_url":{"type":["string","null"],"format":"uri"},"attached_image_url_s3":{"type":["string","null"],"format":"uri"},"attached_link":{"type":["string","null"],"format":"uri"},"attached_link_description":{"type":["string","null"]},"attached_medias_id":{"type":["array","null"],"items":{"type":"string"}},"attached_medias_preview_content":{"type":["array","null"],"items":{"type":["string","null"]}},"attached_medias_preview_url":{"type":["array","null"],"items":{"type":["string","null"],"format":"uri"}},"attached_medias_preview_url_s3":{"type":["string","null"],"format":"uri"},"attached_post_id":{"type":["string","null"]},"attached_video_preview_url":{"type":["string","null"],"format":"uri"},"attached_video_preview_url_s3":{"type":["string","null"],"format":"uri"},"attached_video_url":{"type":["string","null"],"format":"uri"},"comments_count":{"type":["integer","null"]},"created_time":{"type":"string"},"fact_checks":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":["string","null"]},"provider_id":{"type":"string"},"provider_name":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["id","title","subtitle","provider_id","provider_name","url"]}},"group_id":{"type":["string","null"]},"id":{"type":"string"},"overlay_warning":{"type":["string","null"]},"owner_full_name":{"type":"string"},"owner_id":{"type":"string"},"owner_username":{"type":["string","null"]},"post_screenshot":{"type":["string","null"],"format":"uri"},"post_type":{"type":"string","enum":["text","image","video","album","shared_link","shared_post"]},"reactions_angry_count":{"type":["integer","null"]},"reactions_haha_count":{"type":["integer","null"]},"reactions_like_count":{"type":["integer","null"]},"reactions_love_count":{"type":["integer","null"]},"reactions_sad_count":{"type":["integer","null"]},"reactions_support_count":{"type":["integer","null"]},"reactions_total_count":{"type":["integer","null"]},"reactions_wow_count":{"type":["integer","null"]},"recommends":{"type":["boolean","null"]},"shares_count":{"type":["integer","null"]},"text":{"type":["string","null"]},"text_lang":{"type":["string","null"]},"text_tagged_users":{"type":["array","null"],"items":{"type":"string"}},"text_tags":{"type":["array","null"],"items":{"type":"string"}},"timestamp":{"type":"integer"},"video_duration":{"type":["integer","null"]},"video_view_count":{"type":["integer","null"]},"posterType":{"type":["string","null"],"enum":["user","page","group",null],"default":"user"},"stored":{"type":"string","format":"date-time"}},"required":["attached_image_content","attached_image_url","attached_image_url_s3","attached_link","attached_link_description","attached_medias_id","attached_medias_preview_content","attached_medias_preview_url","attached_medias_preview_url_s3","attached_post_id","attached_video_preview_url","attached_video_preview_url_s3","attached_video_url","comments_count","created_time","fact_checks","group_id","id","overlay_warning","owner_full_name","owner_id","owner_username","post_screenshot","post_type","reactions_angry_count","reactions_haha_count","reactions_like_count","reactions_love_count","reactions_sad_count","reactions_support_count","reactions_total_count","reactions_wow_count","recommends","shares_count","text","text_lang","text_tagged_users","text_tags","timestamp","video_duration","video_view_count"],"title":"Facebook post"},{"type":"object","properties":{"urn":{"type":"string","pattern":"^urn:([^:]*:){2}[^:]*$"},"shareUrn":{"type":["string","null"],"pattern":"^urn:([^:]*:){2}[^:]*$"},"approxPublishedAt":{"type":["string","null"]},"timestamp":{"type":"number"},"engagement":{"type":"object","properties":{"comments":{"type":"number"},"reactions":{"type":"object","properties":{"LIKE":{"type":"number","default":0},"PRAISE":{"type":"number","default":0},"EMPATHY":{"type":"number","default":0},"INTEREST":{"type":"number","default":0},"APPRECIATION":{"type":"number","default":0},"ENTERTAINMENT":{"type":"number","default":0}}},"shares":{"type":"number"}},"required":["comments","reactions","shares"]},"content":{"type":"object","properties":{"edited":{"type":"boolean"},"text":{"type":["string","null"]},"textAttributes":{"type":"array","items":{"type":"object","properties":{"startIndex":{"type":"number"},"endIndex":{"type":"number"},"url":{"type":"string"}},"required":["startIndex","endIndex","url"]}},"quotePost":{"type":"boolean"},"quotedPost":{"type":["object","null"],"properties":{"urn":{"type":"string","pattern":"^urn:([^:]*:){2}[^:]*$"},"text":{"type":"string"},"author":{"type":["object","null"],"properties":{"name":{"type":"string"},"profileUrl":{"type":"string","format":"uri"},"type":{"type":"string","enum":["Person","Company"]}},"default":null,"required":["name","profileUrl","type"]}},"default":null,"required":["urn","text"]},"hasImage":{"type":"boolean"},"hasMultipleImages":{"type":"boolean"},"hasVideo":{"type":"boolean"},"hasDocument":{"type":"boolean"},"hasLink":{"type":"boolean"},"isCelebration":{"type":"boolean"},"isJobPosting":{"type":"boolean"},"media":{"type":"object","properties":{"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"position":{"type":"number"},"colSpan":{"type":"number"},"alt":{"type":"string"},"width":{"type":"number"},"height":{"type":"number"}},"required":["url"]}},"videos":{"type":"array","items":{"type":"object","properties":{"contentUrl":{"type":"string","format":"uri"},"thumbnailUrl":{"type":"string","format":"uri"},"duration":{"type":"string"},"width":{"type":"number"},"height":{"type":"number"},"captionUrl":{"type":"string","format":"uri"}}}},"articles":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string"},"thumbnailUrl":{"type":"string","format":"uri"}},"required":["url","title"]}},"document":{"type":"object","properties":{"manifestUrl":{"type":"string","format":"uri"},"title":{"type":"string"},"documentUrl":{"type":"string","format":"uri"}},"required":["manifestUrl"]},"poll":{"type":"object","properties":{"question":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"urn":{"type":"string"}},"required":["text","urn"]}},"multiSelect":{"type":"boolean"}},"required":["question","options","multiSelect"]},"openToWork":{"type":"object","properties":{"rolesLookingFor":{"type":"array","items":{"type":"string"}},"detailsUrl":{"type":"string","format":"uri"}},"required":["rolesLookingFor","detailsUrl"]},"celebration":{"type":"object","properties":{"title":{"type":"string"},"imageUrl":{"type":"string","format":"uri"},"type":{"type":"string","enum":["NEW_POSITION","WORK_ANNIVERSARY","OTHER"],"default":"OTHER"}},"required":["title"]}},"required":["images","videos","articles"]},"jobPostingDetails":{"type":["object","null"],"properties":{"title":{"type":"string"},"companyName":{"type":"string"},"companyUrn":{"type":["string","null"],"pattern":"^urn:([^:]*:){2}[^:]*$"},"companyLogo":{"type":"string"},"jobPostingUrl":{"type":["string","null"],"format":"uri"},"location":{"type":"string"},"type":{"type":["string","null"]}},"required":["title","companyName","companyLogo","location"]}},"required":["edited","text","quotePost","hasImage","hasVideo","hasDocument","hasLink","isCelebration","isJobPosting"]},"group":{"type":["object","null"],"properties":{"urn":{"type":"string","pattern":"^urn:([^:]*:){2}[^:]*$"},"name":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["urn","name","url"]},"permissions":{"type":"object","properties":{"canComment":{"type":"boolean"},"canReact":{"type":"boolean"},"canShare":{"type":"boolean"},"canMessage":{"type":"boolean"}},"required":["canComment","canReact","canShare","canMessage"]},"poster":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["Company"]},"name":{"type":"string"},"followerCount":{"type":"number"},"logo":{"type":"string"},"urn":{"type":"string","pattern":"^urn:([^:]*:){2}[^:]*$"},"pageUrl":{"type":"string"},"locations":{"type":"array","items":{"type":"object","properties":{"country":{"type":["string","null"]},"state":{"type":["string","null"]},"city":{"type":["string","null"]},"headquarters":{"type":"boolean"}},"required":["country","state","city","headquarters"]}},"contactInfo":{"type":"object","properties":{"website":{"type":["string","null"]},"phoneNumber":{"type":["string","null"]}},"required":["website","phoneNumber"]},"size":{"type":["number","null"]},"yearFounded":{"type":["number","null"]},"companyType":{"type":["string","null"],"default":"UNKNOWN"},"tagline":{"type":["string","null"]},"description":{"type":["string","null"]},"premium":{"type":["boolean","null"]},"isFullDetails":{"type":"boolean","default":true},"version":{"type":"number","default":1}},"required":["type","name","followerCount","logo","urn","pageUrl","locations","contactInfo","size","yearFounded","tagline","description"],"title":"Company"},{"type":"object","properties":{"type":{"type":"string","enum":["Person"]},"name":{"type":"string"},"title":{"type":["string","null"]},"profileUrl":{"type":"string","format":"uri"},"profileImage":{"type":["string","null"]},"urn":{"type":"string","pattern":"^urn:([^:]*:){2}[^:]*$"},"location":{"type":["object","null"],"properties":{"country":{"type":["string","null"]},"state":{"type":["string","null"]},"city":{"type":["string","null"]}},"required":["country","state","city"]},"followersCount":{"type":"number","default":0},"premium":{"type":["boolean","null"]},"currentPosition":{"type":["object","null"],"properties":{"companyUrn":{"type":["string","null"],"pattern":"^urn:([^:]*:){2}[^:]*$"},"vanityId":{"type":["string","null"]},"name":{"type":"string"},"minEmployeeCount":{"type":["number","null"]},"industry":{"type":["string","null"]},"jobLocation":{"type":["object","null"],"properties":{"country":{"type":["string","null"]},"state":{"type":["string","null"]},"city":{"type":["string","null"]}},"required":["country","state","city"]},"domain":{"type":["string","null"]},"locationRaw":{"type":["string","null"]},"description":{"type":["string","null"]},"followers":{"type":["number","null"]},"slogan":{"type":["string","null"]},"type":{"type":["string","null"]},"yearFounded":{"type":["number","null"]},"tags":{"type":["array","null"],"items":{"type":"string"}}},"required":["name","minEmployeeCount","industry","jobLocation"]},"isFullDetails":{"type":"boolean","default":true},"version":{"type":"number","default":1}},"required":["type","name","title","profileUrl","profileImage","urn","location","currentPosition"],"title":"Person"}]},"fromCache":{"type":"boolean"}},"required":["urn","approxPublishedAt","engagement","content","group","permissions","poster"],"title":"LinkedIn post"},{"type":"object","properties":{"type":{"type":"string","enum":["post"],"description":"Content type"},"title":{"type":"string","description":"Title of the post"},"contains_media":{"type":"boolean","description":"Whether the post contains media (image/video/gallery)"},"can_crosspost":{"type":"boolean","description":"Whether the post can be crossposted"},"contains_spoiler":{"type":"boolean","description":"Whether the post contains spoilers"},"media":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["image"]},"url":{"type":"string","format":"uri"}},"required":["type","url"],"title":"Image"},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"url":{"type":"string","format":"uri"}},"required":["type","url"],"title":"Video"},{"type":"object","properties":{"type":{"type":"string","enum":["gallery"]},"urls":{"type":"array","items":{"type":"string","format":"uri"}}},"required":["type","urls"],"title":"Gallery"},{"type":"null"}],"description":"Attached media data"},"children":{"type":"array","items":{}},"id":{"type":"string","pattern":"^t[1-6]_[a-z0-9]+$","description":"Reddit fullname ID"},"body":{"type":"string","description":"Text content of the post or comment"},"poster":{"type":"object","properties":{"username":{"type":"string","description":"Reddit username"},"id":{"type":"string","pattern":"^t[1-6]_[a-z0-9]+$","description":"Reddit fullname ID of the author (t2_ prefix)"},"profile_img":{"type":"string","format":"uri","description":"URL to the author's profile image"}},"required":["username","id","profile_img"],"description":"The author of the post or comment"},"subreddit":{"type":"string","description":"Subreddit name the content was posted in"},"subreddit_id":{"type":"string","pattern":"^t[1-6]_[a-z0-9]+$","description":"Reddit fullname ID of the subreddit"},"created_at":{"type":"string","description":"When the content was created (ISO string)"},"can_comment":{"type":"boolean","description":"Whether the content can be commented on"},"contains_links":{"type":"boolean","description":"Whether the content contains links"},"lang":{"type":["string","null"],"description":"Detected language code"},"url":{"type":"string","format":"uri","description":"Full URL to the content"},"sentiment":{"type":["string","null"],"enum":["positive","negative","neutral","unknown",null],"description":"Detected sentiment of the content"}},"required":["type","title","contains_media","can_crosspost","contains_spoiler","id","body","poster","subreddit","subreddit_id","created_at","can_comment","contains_links","lang","url","sentiment"],"title":"Post"},{"type":"object","properties":{"type":{"type":"string","enum":["comment"],"description":"Content type"},"parent_id":{"type":"string","pattern":"^t[1-6]_[a-z0-9]+$","description":"Reddit fullname of the parent post or comment this is replying to"},"parent":{},"children":{"type":"array","items":{}},"id":{"type":"string","pattern":"^t[1-6]_[a-z0-9]+$","description":"Reddit fullname ID"},"body":{"type":"string","description":"Text content of the post or comment"},"poster":{"type":"object","properties":{"username":{"type":"string","description":"Reddit username"},"id":{"type":"string","pattern":"^t[1-6]_[a-z0-9]+$","description":"Reddit fullname ID of the author (t2_ prefix)"},"profile_img":{"type":"string","format":"uri","description":"URL to the author's profile image"}},"required":["username","id","profile_img"],"description":"The author of the post or comment"},"subreddit":{"type":"string","description":"Subreddit name the content was posted in"},"subreddit_id":{"type":"string","pattern":"^t[1-6]_[a-z0-9]+$","description":"Reddit fullname ID of the subreddit"},"created_at":{"type":"string","description":"When the content was created (ISO string)"},"can_comment":{"type":"boolean","description":"Whether the content can be commented on"},"contains_links":{"type":"boolean","description":"Whether the content contains links"},"lang":{"type":["string","null"],"description":"Detected language code"},"url":{"type":"string","format":"uri","description":"Full URL to the content"},"sentiment":{"type":["string","null"],"enum":["positive","negative","neutral","unknown",null],"description":"Detected sentiment of the content"}},"required":["type","parent_id","id","body","poster","subreddit","subreddit_id","created_at","can_comment","contains_links","lang","url","sentiment"],"title":"Comment"}],"description":"Platform-specific data for the find"},"analysis":{"type":["object","null"],"properties":{"summary":{"type":"string"},"logic":{"type":"string"}},"required":["summary","logic"],"description":"AI analysis of the find relevance","example":{"logic":"The profile shows active engagement in relevant topics.","summary":"This find appears to be a highly relevant lead based on their activity and interests."}},"confidence_score":{"type":["number","null"],"description":"AI confidence score for find relevance (0-1)","example":0.85},"find_date":{"type":"string","format":"date-time","description":"When the content was originally created","example":"2024-01-15T14:30:00Z"},"engagement_status":{"type":"string","enum":["none","acted_on"],"description":"Current engagement status","example":"none"},"read_status":{"type":"string","enum":["unread","read"],"description":"Whether the find has been reviewed","example":"unread"},"result":{"type":"string","enum":["none","failed","goal"],"description":"Outcome of engagement with this find","example":"none"},"rating":{"type":["string","null"],"enum":["bad","neutral","good",null],"description":"Quality rating given by user","example":"good"},"favorited":{"type":"boolean","description":"Whether the find is marked as favorite","example":true},"feedback":{"type":["string","null"],"description":"User feedback on the find quality","example":"Great lead, highly relevant to our target market"},"notes":{"type":["string","null"],"description":"Private notes about the find","example":"Follow up next week after product launch"},"run_id":{"type":["number","null"],"description":"Ghost run that discovered this find","example":12345},"sentiment":{"type":["string","null"],"enum":["positive","negative","neutral",null],"description":"AI-determined sentiment of the find","example":"positive"},"updated_at":{"type":"string","format":"date-time","description":"When the find was last modified","example":"2024-01-15T14:30:00Z"}},"required":["id","company_id","ghost_id","contact_id","assigned_uid","service","unique_id","data","analysis","confidence_score","find_date","engagement_status","read_status","result","rating","favorited","feedback","notes","run_id","sentiment","updated_at"],"description":"Find object"}},"pagination":{"type":"object","properties":{"page":{"type":"integer","description":"Current page number","example":1},"limit":{"type":"integer","description":"Items per page","example":50},"total":{"type":"integer","description":"Total number of items across all pages","example":150},"total_pages":{"type":"integer","description":"Total number of pages","example":3}},"required":["page","limit","total","total_pages"],"description":"Pagination metadata for the results. `total` and `total_pages` are approximate on large result sets."}},"required":["finds","pagination"]},"SearchFindsRequest":{"type":"object","properties":{"findQueryParams":{"type":"object","properties":{"filters":{"type":"object","properties":{"ghosts":{"type":"object","additionalProperties":{"type":"boolean"},"description":"Filter by Ghost ID. Use search_ghosts to get IDs."},"services":{"type":"object","properties":{"Twitter":{"type":"boolean"},"LinkedIn":{"type":"boolean"},"Reddit":{"type":"boolean"},"Facebook":{"type":"boolean"},"LinkedIn_People":{"type":"boolean"},"LinkedIn_Company":{"type":"boolean"}}},"engagement_status":{"type":"object","properties":{"acted_on":{"type":"boolean"},"none":{"type":"boolean"}},"description":"acted_on: user has engaged with the Find. none: no engagement."},"goalResult":{"type":"object","properties":{"none":{"type":"boolean"},"goal":{"type":"boolean"},"failed":{"type":"boolean"}},"description":"goal: marked success. failed: marked failed. none: not yet evaluated."},"assignedTo":{"type":"object","additionalProperties":{"type":"boolean"}},"readStatus":{"type":"object","properties":{"read":{"type":"boolean"},"unread":{"type":"boolean"}},"description":"Whether Finds have been read or not."},"favoriteStatus":{"type":"object","properties":{"favorite":{"type":"boolean"},"not_favorite":{"type":"boolean"}},"description":"Whether Finds have been favorited or not."},"reshareStatus":{"type":"object","properties":{"reshare":{"type":"boolean"},"not_reshare":{"type":"boolean"}},"description":"reshare: the Find quotes/reshares another post (LinkedIn reshares, Twitter quote tweets, Facebook shared posts). not_reshare: original posts only."},"feedbackRating":{"type":"object","properties":{"neutral":{"type":"boolean"},"good":{"type":"boolean"},"bad":{"type":"boolean"},"none":{"type":"boolean"}},"description":"good/neutral/bad: user-assigned ratings. none: no rating given."},"run_ids":{"type":"object","additionalProperties":{"type":"boolean"}},"contact_ids":{"type":"object","additionalProperties":{"type":"boolean"}},"start":{"type":"object","additionalProperties":{"type":"boolean"},"description":"Date range start as ISO 8601 key, e.g. {\"2026-01-01T00:00:00Z\": true}"},"end":{"type":"object","additionalProperties":{"type":"boolean"},"description":"Date range end as ISO 8601 key, e.g. {\"2026-01-31T23:59:59Z\": true}"},"findsPeriod":{"type":"object","additionalProperties":{"type":"boolean"},"description":"Relative time period as key, e.g. {\"7d\": true} or {\"24h\": true}"},"tags":{"type":"object","additionalProperties":{"type":"boolean"},"description":"Filter by tag UUIDs."},"platform":{"type":"object","properties":{"Twitter":{"type":"boolean"},"LinkedIn":{"type":"boolean"},"Reddit":{"type":"boolean"},"Facebook":{"type":"boolean"}},"description":"Filter by platform."},"sentiment":{"type":"object","properties":{"positive":{"type":"boolean"},"negative":{"type":"boolean"},"neutral":{"type":"boolean"}},"description":"AI-analyzed sentiment of the find."}}},"sorts":{"type":"object","properties":{"find_date":{"type":"string","enum":["asc","desc"],"description":"Sort by the Find date"},"confidence_score":{"type":"string","enum":["asc","desc"],"description":"Sort by the Ghost's confidence score"}}},"searchText":{"type":"string","description":"Full-text search on find content"},"company_id":{"type":"string"},"range":{"type":"object","properties":{"from":{"type":"integer","minimum":0},"to":{"type":"integer","minimum":0}},"required":["from","to"]},"countMode":{"type":"string","enum":["exact","planned","estimated"]}},"required":["filters","sorts","company_id"]},"pagination":{"type":"object","properties":{"page":{"type":"integer","minimum":1,"default":1,"description":"Page number for pagination (1-based)","example":1},"limit":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Number of items per page (max 100)","example":50}},"default":{"page":1,"limit":50},"additionalProperties":false}},"required":["findQueryParams"],"additionalProperties":false,"examples":[{"findQueryParams":{"company_id":"123e4567-e89b-12d3-a456-426614174000","searchText":"CRM","filters":{"services":{"Reddit":true,"LinkedIn":true},"readStatus":{"unread":true},"findsPeriod":{"7d":true}},"sorts":{"find_date":"desc"}},"pagination":{"page":1,"limit":25}}]},"UpdateFindResponse":{"type":"object","properties":{"find":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the find","example":"123e4567-e89b-12d3-a456-426614174000"},"company_id":{"type":"string","format":"uuid","description":"Company that owns this find","example":"123e4567-e89b-12d3-a456-426614174000"},"ghost_id":{"type":["string","null"],"format":"uuid","description":"Ghost that discovered this find","example":"123e4567-e89b-12d3-a456-426614174000"},"contact_id":{"type":["string","null"],"format":"uuid","description":"Associated contact profile","example":"123e4567-e89b-12d3-a456-426614174000"},"assigned_uid":{"type":["string","null"],"format":"uuid","description":"User assigned to handle this find","example":"123e4567-e89b-12d3-a456-426614174000"},"service":{"type":"string","enum":["Twitter","LinkedIn","Reddit","Facebook","LinkedIn_People","LinkedIn_Company"],"description":"Platform where the find was discovered","example":"Twitter"},"unique_id":{"type":"string","description":"Platform-specific unique identifier","example":"1234567890123456789"},"data":{"anyOf":[{"type":"object","properties":{"quoted_status_id":{"type":["number","null"],"default":null},"quoted_status_id_str":{"type":["string","null"],"default":null},"is_quote_status":{"type":"boolean","default":false},"quoted_status":{"type":["object","null"],"properties":{"tweet_created_at":{"type":"string"},"id":{"type":"number"},"id_str":{"type":"string"},"text":{"type":["string","null"],"default":null},"full_text":{"type":["string","null"],"default":null},"source":{"type":"string"},"truncated":{"type":"boolean"},"in_reply_to_status_id":{"type":["number","null"],"default":null},"in_reply_to_status_id_str":{"type":["string","null"],"default":null},"in_reply_to_user_id":{"type":["number","null"],"default":null},"in_reply_to_user_id_str":{"type":["string","null"],"default":null},"in_reply_to_screen_name":{"type":["string","null"],"default":null},"user":{"type":"object","properties":{"id":{"type":"number"},"id_str":{"type":"string"},"name":{"type":"string"},"screen_name":{"type":"string"},"location":{"type":["string","null"],"default":null},"url":{"type":["string","null"],"default":null},"description":{"type":["string","null"],"default":null},"protected":{"type":"boolean"},"verified":{"type":"boolean"},"followers_count":{"type":"number"},"friends_count":{"type":"number"},"listed_count":{"type":"number"},"favourites_count":{"type":"number"},"statuses_count":{"type":"number"},"created_at":{"type":"string"},"profile_banner_url":{"type":["string","null"],"default":null},"profile_image_url_https":{"type":"string"},"can_dm":{"type":"boolean"}},"required":["id","id_str","name","screen_name","protected","verified","followers_count","friends_count","listed_count","favourites_count","statuses_count","created_at","profile_image_url_https","can_dm"]}},"default":null,"required":["tweet_created_at","id","id_str","source","truncated","user"]},"retweeted_status":{"type":["object","null"],"properties":{"tweet_created_at":{"type":"string"},"id":{"type":"number"},"id_str":{"type":"string"},"text":{"type":["string","null"],"default":null},"full_text":{"type":["string","null"],"default":null},"source":{"type":"string"},"truncated":{"type":"boolean"},"in_reply_to_status_id":{"type":["number","null"],"default":null},"in_reply_to_status_id_str":{"type":["string","null"],"default":null},"in_reply_to_user_id":{"type":["number","null"],"default":null},"in_reply_to_user_id_str":{"type":["string","null"],"default":null},"in_reply_to_screen_name":{"type":["string","null"],"default":null},"user":{"type":"object","properties":{"id":{"type":"number"},"id_str":{"type":"string"},"name":{"type":"string"},"screen_name":{"type":"string"},"location":{"type":["string","null"],"default":null},"url":{"type":["string","null"],"default":null},"description":{"type":["string","null"],"default":null},"protected":{"type":"boolean"},"verified":{"type":"boolean"},"followers_count":{"type":"number"},"friends_count":{"type":"number"},"listed_count":{"type":"number"},"favourites_count":{"type":"number"},"statuses_count":{"type":"number"},"created_at":{"type":"string"},"profile_banner_url":{"type":["string","null"],"default":null},"profile_image_url_https":{"type":"string"},"can_dm":{"type":"boolean"}},"required":["id","id_str","name","screen_name","protected","verified","followers_count","friends_count","listed_count","favourites_count","statuses_count","created_at","profile_image_url_https","can_dm"]}},"default":null,"required":["tweet_created_at","id","id_str","source","truncated","user"]},"quote_count":{"type":["number","null"],"default":null},"reply_count":{"type":"number"},"retweet_count":{"type":"number"},"favorite_count":{"type":["number","null"],"default":null},"lang":{"type":["string","null"],"default":"und"},"views_count":{"type":["number","null"],"default":null},"bookmark_count":{"type":"number"},"entities":{"type":"object","properties":{"user_mentions":{"type":"array","items":{"type":"object","properties":{"id_str":{"type":"string"},"name":{"type":"string"},"screen_name":{"type":"string"},"indices":{"type":"array","items":{"type":"number"}}},"required":["id_str","name","screen_name","indices"]},"default":[]},"urls":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"expanded_url":{"type":"string"},"display_url":{"type":"string"},"indices":{"type":"array","items":{"type":"number"}}},"required":["url","display_url","indices"]},"default":[]},"hashtags":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"indices":{"type":"array","items":{"type":"number"}}},"required":["text","indices"]},"default":[]},"symbols":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"indices":{"type":"array","items":{"type":"number"}}},"required":["text","indices"]},"default":[]},"media":{"type":"array","items":{"type":"object","properties":{"display_url":{"type":"string"},"expanded_url":{"type":"string"},"ext_alt_text":{"type":["string","null"],"default":null},"id":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"default":null},"id_str":{"type":"string"},"indices":{"type":"array","items":{"type":"number"}},"media_url_https":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string"},"ext_media_availability":{"type":"object","properties":{"status":{"type":"string","enum":["Available","Unavailable"]}},"required":["status"]},"media_key":{"type":"string","default":""},"sizes":{"anyOf":[{"type":"object","properties":{"large":{"type":["object","null"],"properties":{"h":{"type":"number"},"resize":{"type":["string","null"],"enum":["crop","fit",null],"default":"fit"},"w":{"type":"number"}},"default":null,"required":["h","w"]},"medium":{"type":["object","null"],"properties":{"h":{"type":"number"},"resize":{"type":["string","null"],"enum":["crop","fit",null],"default":"fit"},"w":{"type":"number"}},"default":null,"required":["h","w"]},"small":{"type":["object","null"],"properties":{"h":{"type":"number"},"resize":{"type":["string","null"],"enum":["crop","fit",null],"default":"fit"},"w":{"type":"number"}},"default":null,"required":["h","w"]},"thumb":{"type":["object","null"],"properties":{"h":{"type":"number"},"resize":{"type":["string","null"],"enum":["crop","fit",null],"default":"fit"},"w":{"type":"number"}},"default":null,"required":["h","w"]}}},{"type":"array","items":{"type":"object","properties":{"h":{"type":"number"},"resize":{"type":["string","null"],"enum":["crop","fit",null],"default":"fit"},"w":{"type":"number"}},"required":["h","w"]}}]},"original_info":{"type":"object","properties":{"width":{"type":"number"},"height":{"type":"number"},"focus_rects":{"type":"array","items":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"h":{"type":"number"},"w":{"type":"number"}},"required":["x","y","h","w"]},"default":[]}},"required":["width","height"]}},"required":["id_str","indices","type"]},"default":[]}}},"tweet_created_at":{"type":"string"},"id":{"type":"number"},"id_str":{"type":"string"},"text":{"type":["string","null"],"default":null},"full_text":{"type":["string","null"],"default":null},"source":{"type":"string"},"truncated":{"type":"boolean"},"in_reply_to_status_id":{"type":["number","null"],"default":null},"in_reply_to_status_id_str":{"type":["string","null"],"default":null},"in_reply_to_user_id":{"type":["number","null"],"default":null},"in_reply_to_user_id_str":{"type":["string","null"],"default":null},"in_reply_to_screen_name":{"type":["string","null"],"default":null},"user":{"type":"object","properties":{"id":{"type":"number"},"id_str":{"type":"string"},"name":{"type":"string"},"screen_name":{"type":"string"},"location":{"type":["string","null"],"default":null},"url":{"type":["string","null"],"default":null},"description":{"type":["string","null"],"default":null},"protected":{"type":"boolean"},"verified":{"type":"boolean"},"followers_count":{"type":"number"},"friends_count":{"type":"number"},"listed_count":{"type":"number"},"favourites_count":{"type":"number"},"statuses_count":{"type":"number"},"created_at":{"type":"string"},"profile_banner_url":{"type":["string","null"],"default":null},"profile_image_url_https":{"type":"string"},"can_dm":{"type":"boolean"}},"required":["id","id_str","name","screen_name","protected","verified","followers_count","friends_count","listed_count","favourites_count","statuses_count","created_at","profile_image_url_https","can_dm"]}},"required":["reply_count","retweet_count","bookmark_count","entities","tweet_created_at","id","id_str","source","truncated","user"],"title":"Tweet"},{"type":"object","properties":{"attached_image_content":{"type":["string","null"]},"attached_image_url":{"type":["string","null"],"format":"uri"},"attached_image_url_s3":{"type":["string","null"],"format":"uri"},"attached_link":{"type":["string","null"],"format":"uri"},"attached_link_description":{"type":["string","null"]},"attached_medias_id":{"type":["array","null"],"items":{"type":"string"}},"attached_medias_preview_content":{"type":["array","null"],"items":{"type":["string","null"]}},"attached_medias_preview_url":{"type":["array","null"],"items":{"type":["string","null"],"format":"uri"}},"attached_medias_preview_url_s3":{"type":["string","null"],"format":"uri"},"attached_post_id":{"type":["string","null"]},"attached_video_preview_url":{"type":["string","null"],"format":"uri"},"attached_video_preview_url_s3":{"type":["string","null"],"format":"uri"},"attached_video_url":{"type":["string","null"],"format":"uri"},"comments_count":{"type":["integer","null"]},"created_time":{"type":"string"},"fact_checks":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":["string","null"]},"provider_id":{"type":"string"},"provider_name":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["id","title","subtitle","provider_id","provider_name","url"]}},"group_id":{"type":["string","null"]},"id":{"type":"string"},"overlay_warning":{"type":["string","null"]},"owner_full_name":{"type":"string"},"owner_id":{"type":"string"},"owner_username":{"type":["string","null"]},"post_screenshot":{"type":["string","null"],"format":"uri"},"post_type":{"type":"string","enum":["text","image","video","album","shared_link","shared_post"]},"reactions_angry_count":{"type":["integer","null"]},"reactions_haha_count":{"type":["integer","null"]},"reactions_like_count":{"type":["integer","null"]},"reactions_love_count":{"type":["integer","null"]},"reactions_sad_count":{"type":["integer","null"]},"reactions_support_count":{"type":["integer","null"]},"reactions_total_count":{"type":["integer","null"]},"reactions_wow_count":{"type":["integer","null"]},"recommends":{"type":["boolean","null"]},"shares_count":{"type":["integer","null"]},"text":{"type":["string","null"]},"text_lang":{"type":["string","null"]},"text_tagged_users":{"type":["array","null"],"items":{"type":"string"}},"text_tags":{"type":["array","null"],"items":{"type":"string"}},"timestamp":{"type":"integer"},"video_duration":{"type":["integer","null"]},"video_view_count":{"type":["integer","null"]},"posterType":{"type":["string","null"],"enum":["user","page","group",null],"default":"user"},"stored":{"type":"string","format":"date-time"}},"required":["attached_image_content","attached_image_url","attached_image_url_s3","attached_link","attached_link_description","attached_medias_id","attached_medias_preview_content","attached_medias_preview_url","attached_medias_preview_url_s3","attached_post_id","attached_video_preview_url","attached_video_preview_url_s3","attached_video_url","comments_count","created_time","fact_checks","group_id","id","overlay_warning","owner_full_name","owner_id","owner_username","post_screenshot","post_type","reactions_angry_count","reactions_haha_count","reactions_like_count","reactions_love_count","reactions_sad_count","reactions_support_count","reactions_total_count","reactions_wow_count","recommends","shares_count","text","text_lang","text_tagged_users","text_tags","timestamp","video_duration","video_view_count"],"title":"Facebook post"},{"type":"object","properties":{"urn":{"type":"string","pattern":"^urn:([^:]*:){2}[^:]*$"},"shareUrn":{"type":["string","null"],"pattern":"^urn:([^:]*:){2}[^:]*$"},"approxPublishedAt":{"type":["string","null"]},"timestamp":{"type":"number"},"engagement":{"type":"object","properties":{"comments":{"type":"number"},"reactions":{"type":"object","properties":{"LIKE":{"type":"number","default":0},"PRAISE":{"type":"number","default":0},"EMPATHY":{"type":"number","default":0},"INTEREST":{"type":"number","default":0},"APPRECIATION":{"type":"number","default":0},"ENTERTAINMENT":{"type":"number","default":0}}},"shares":{"type":"number"}},"required":["comments","reactions","shares"]},"content":{"type":"object","properties":{"edited":{"type":"boolean"},"text":{"type":["string","null"]},"textAttributes":{"type":"array","items":{"type":"object","properties":{"startIndex":{"type":"number"},"endIndex":{"type":"number"},"url":{"type":"string"}},"required":["startIndex","endIndex","url"]}},"quotePost":{"type":"boolean"},"quotedPost":{"type":["object","null"],"properties":{"urn":{"type":"string","pattern":"^urn:([^:]*:){2}[^:]*$"},"text":{"type":"string"},"author":{"type":["object","null"],"properties":{"name":{"type":"string"},"profileUrl":{"type":"string","format":"uri"},"type":{"type":"string","enum":["Person","Company"]}},"default":null,"required":["name","profileUrl","type"]}},"default":null,"required":["urn","text"]},"hasImage":{"type":"boolean"},"hasMultipleImages":{"type":"boolean"},"hasVideo":{"type":"boolean"},"hasDocument":{"type":"boolean"},"hasLink":{"type":"boolean"},"isCelebration":{"type":"boolean"},"isJobPosting":{"type":"boolean"},"media":{"type":"object","properties":{"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"position":{"type":"number"},"colSpan":{"type":"number"},"alt":{"type":"string"},"width":{"type":"number"},"height":{"type":"number"}},"required":["url"]}},"videos":{"type":"array","items":{"type":"object","properties":{"contentUrl":{"type":"string","format":"uri"},"thumbnailUrl":{"type":"string","format":"uri"},"duration":{"type":"string"},"width":{"type":"number"},"height":{"type":"number"},"captionUrl":{"type":"string","format":"uri"}}}},"articles":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string"},"thumbnailUrl":{"type":"string","format":"uri"}},"required":["url","title"]}},"document":{"type":"object","properties":{"manifestUrl":{"type":"string","format":"uri"},"title":{"type":"string"},"documentUrl":{"type":"string","format":"uri"}},"required":["manifestUrl"]},"poll":{"type":"object","properties":{"question":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"urn":{"type":"string"}},"required":["text","urn"]}},"multiSelect":{"type":"boolean"}},"required":["question","options","multiSelect"]},"openToWork":{"type":"object","properties":{"rolesLookingFor":{"type":"array","items":{"type":"string"}},"detailsUrl":{"type":"string","format":"uri"}},"required":["rolesLookingFor","detailsUrl"]},"celebration":{"type":"object","properties":{"title":{"type":"string"},"imageUrl":{"type":"string","format":"uri"},"type":{"type":"string","enum":["NEW_POSITION","WORK_ANNIVERSARY","OTHER"],"default":"OTHER"}},"required":["title"]}},"required":["images","videos","articles"]},"jobPostingDetails":{"type":["object","null"],"properties":{"title":{"type":"string"},"companyName":{"type":"string"},"companyUrn":{"type":["string","null"],"pattern":"^urn:([^:]*:){2}[^:]*$"},"companyLogo":{"type":"string"},"jobPostingUrl":{"type":["string","null"],"format":"uri"},"location":{"type":"string"},"type":{"type":["string","null"]}},"required":["title","companyName","companyLogo","location"]}},"required":["edited","text","quotePost","hasImage","hasVideo","hasDocument","hasLink","isCelebration","isJobPosting"]},"group":{"type":["object","null"],"properties":{"urn":{"type":"string","pattern":"^urn:([^:]*:){2}[^:]*$"},"name":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["urn","name","url"]},"permissions":{"type":"object","properties":{"canComment":{"type":"boolean"},"canReact":{"type":"boolean"},"canShare":{"type":"boolean"},"canMessage":{"type":"boolean"}},"required":["canComment","canReact","canShare","canMessage"]},"poster":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["Company"]},"name":{"type":"string"},"followerCount":{"type":"number"},"logo":{"type":"string"},"urn":{"type":"string","pattern":"^urn:([^:]*:){2}[^:]*$"},"pageUrl":{"type":"string"},"locations":{"type":"array","items":{"type":"object","properties":{"country":{"type":["string","null"]},"state":{"type":["string","null"]},"city":{"type":["string","null"]},"headquarters":{"type":"boolean"}},"required":["country","state","city","headquarters"]}},"contactInfo":{"type":"object","properties":{"website":{"type":["string","null"]},"phoneNumber":{"type":["string","null"]}},"required":["website","phoneNumber"]},"size":{"type":["number","null"]},"yearFounded":{"type":["number","null"]},"companyType":{"type":["string","null"],"default":"UNKNOWN"},"tagline":{"type":["string","null"]},"description":{"type":["string","null"]},"premium":{"type":["boolean","null"]},"isFullDetails":{"type":"boolean","default":true},"version":{"type":"number","default":1}},"required":["type","name","followerCount","logo","urn","pageUrl","locations","contactInfo","size","yearFounded","tagline","description"],"title":"Company"},{"type":"object","properties":{"type":{"type":"string","enum":["Person"]},"name":{"type":"string"},"title":{"type":["string","null"]},"profileUrl":{"type":"string","format":"uri"},"profileImage":{"type":["string","null"]},"urn":{"type":"string","pattern":"^urn:([^:]*:){2}[^:]*$"},"location":{"type":["object","null"],"properties":{"country":{"type":["string","null"]},"state":{"type":["string","null"]},"city":{"type":["string","null"]}},"required":["country","state","city"]},"followersCount":{"type":"number","default":0},"premium":{"type":["boolean","null"]},"currentPosition":{"type":["object","null"],"properties":{"companyUrn":{"type":["string","null"],"pattern":"^urn:([^:]*:){2}[^:]*$"},"vanityId":{"type":["string","null"]},"name":{"type":"string"},"minEmployeeCount":{"type":["number","null"]},"industry":{"type":["string","null"]},"jobLocation":{"type":["object","null"],"properties":{"country":{"type":["string","null"]},"state":{"type":["string","null"]},"city":{"type":["string","null"]}},"required":["country","state","city"]},"domain":{"type":["string","null"]},"locationRaw":{"type":["string","null"]},"description":{"type":["string","null"]},"followers":{"type":["number","null"]},"slogan":{"type":["string","null"]},"type":{"type":["string","null"]},"yearFounded":{"type":["number","null"]},"tags":{"type":["array","null"],"items":{"type":"string"}}},"required":["name","minEmployeeCount","industry","jobLocation"]},"isFullDetails":{"type":"boolean","default":true},"version":{"type":"number","default":1}},"required":["type","name","title","profileUrl","profileImage","urn","location","currentPosition"],"title":"Person"}]},"fromCache":{"type":"boolean"}},"required":["urn","approxPublishedAt","engagement","content","group","permissions","poster"],"title":"LinkedIn post"},{"type":"object","properties":{"type":{"type":"string","enum":["post"],"description":"Content type"},"title":{"type":"string","description":"Title of the post"},"contains_media":{"type":"boolean","description":"Whether the post contains media (image/video/gallery)"},"can_crosspost":{"type":"boolean","description":"Whether the post can be crossposted"},"contains_spoiler":{"type":"boolean","description":"Whether the post contains spoilers"},"media":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["image"]},"url":{"type":"string","format":"uri"}},"required":["type","url"],"title":"Image"},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"url":{"type":"string","format":"uri"}},"required":["type","url"],"title":"Video"},{"type":"object","properties":{"type":{"type":"string","enum":["gallery"]},"urls":{"type":"array","items":{"type":"string","format":"uri"}}},"required":["type","urls"],"title":"Gallery"},{"type":"null"}],"description":"Attached media data"},"children":{"type":"array","items":{}},"id":{"type":"string","pattern":"^t[1-6]_[a-z0-9]+$","description":"Reddit fullname ID"},"body":{"type":"string","description":"Text content of the post or comment"},"poster":{"type":"object","properties":{"username":{"type":"string","description":"Reddit username"},"id":{"type":"string","pattern":"^t[1-6]_[a-z0-9]+$","description":"Reddit fullname ID of the author (t2_ prefix)"},"profile_img":{"type":"string","format":"uri","description":"URL to the author's profile image"}},"required":["username","id","profile_img"],"description":"The author of the post or comment"},"subreddit":{"type":"string","description":"Subreddit name the content was posted in"},"subreddit_id":{"type":"string","pattern":"^t[1-6]_[a-z0-9]+$","description":"Reddit fullname ID of the subreddit"},"created_at":{"type":"string","description":"When the content was created (ISO string)"},"can_comment":{"type":"boolean","description":"Whether the content can be commented on"},"contains_links":{"type":"boolean","description":"Whether the content contains links"},"lang":{"type":["string","null"],"description":"Detected language code"},"url":{"type":"string","format":"uri","description":"Full URL to the content"},"sentiment":{"type":["string","null"],"enum":["positive","negative","neutral","unknown",null],"description":"Detected sentiment of the content"}},"required":["type","title","contains_media","can_crosspost","contains_spoiler","id","body","poster","subreddit","subreddit_id","created_at","can_comment","contains_links","lang","url","sentiment"],"title":"Post"},{"type":"object","properties":{"type":{"type":"string","enum":["comment"],"description":"Content type"},"parent_id":{"type":"string","pattern":"^t[1-6]_[a-z0-9]+$","description":"Reddit fullname of the parent post or comment this is replying to"},"parent":{},"children":{"type":"array","items":{}},"id":{"type":"string","pattern":"^t[1-6]_[a-z0-9]+$","description":"Reddit fullname ID"},"body":{"type":"string","description":"Text content of the post or comment"},"poster":{"type":"object","properties":{"username":{"type":"string","description":"Reddit username"},"id":{"type":"string","pattern":"^t[1-6]_[a-z0-9]+$","description":"Reddit fullname ID of the author (t2_ prefix)"},"profile_img":{"type":"string","format":"uri","description":"URL to the author's profile image"}},"required":["username","id","profile_img"],"description":"The author of the post or comment"},"subreddit":{"type":"string","description":"Subreddit name the content was posted in"},"subreddit_id":{"type":"string","pattern":"^t[1-6]_[a-z0-9]+$","description":"Reddit fullname ID of the subreddit"},"created_at":{"type":"string","description":"When the content was created (ISO string)"},"can_comment":{"type":"boolean","description":"Whether the content can be commented on"},"contains_links":{"type":"boolean","description":"Whether the content contains links"},"lang":{"type":["string","null"],"description":"Detected language code"},"url":{"type":"string","format":"uri","description":"Full URL to the content"},"sentiment":{"type":["string","null"],"enum":["positive","negative","neutral","unknown",null],"description":"Detected sentiment of the content"}},"required":["type","parent_id","id","body","poster","subreddit","subreddit_id","created_at","can_comment","contains_links","lang","url","sentiment"],"title":"Comment"}],"description":"Platform-specific data for the find"},"analysis":{"type":["object","null"],"properties":{"summary":{"type":"string"},"logic":{"type":"string"}},"required":["summary","logic"],"description":"AI analysis of the find relevance","example":{"logic":"The profile shows active engagement in relevant topics.","summary":"This find appears to be a highly relevant lead based on their activity and interests."}},"confidence_score":{"type":["number","null"],"description":"AI confidence score for find relevance (0-1)","example":0.85},"find_date":{"type":"string","format":"date-time","description":"When the content was originally created","example":"2024-01-15T14:30:00Z"},"engagement_status":{"type":"string","enum":["none","acted_on"],"description":"Current engagement status","example":"none"},"read_status":{"type":"string","enum":["unread","read"],"description":"Whether the find has been reviewed","example":"unread"},"result":{"type":"string","enum":["none","failed","goal"],"description":"Outcome of engagement with this find","example":"none"},"rating":{"type":["string","null"],"enum":["bad","neutral","good",null],"description":"Quality rating given by user","example":"good"},"favorited":{"type":"boolean","description":"Whether the find is marked as favorite","example":true},"feedback":{"type":["string","null"],"description":"User feedback on the find quality","example":"Great lead, highly relevant to our target market"},"notes":{"type":["string","null"],"description":"Private notes about the find","example":"Follow up next week after product launch"},"run_id":{"type":["number","null"],"description":"Ghost run that discovered this find","example":12345},"sentiment":{"type":["string","null"],"enum":["positive","negative","neutral",null],"description":"AI-determined sentiment of the find","example":"positive"},"updated_at":{"type":"string","format":"date-time","description":"When the find was last modified","example":"2024-01-15T14:30:00Z"}},"required":["id","company_id","ghost_id","contact_id","assigned_uid","service","unique_id","data","analysis","confidence_score","find_date","engagement_status","read_status","result","rating","favorited","feedback","notes","run_id","sentiment","updated_at"],"description":"Find object"}},"required":["find"]},"UpdateFindRequest":{"type":"object","properties":{"assigned_uid":{"type":["string","null"],"format":"uuid","description":"User assigned to handle this find","example":"123e4567-e89b-12d3-a456-426614174000"},"engagement_status":{"type":"string","enum":["none","acted_on"],"description":"Current engagement status","example":"none"},"read_status":{"type":"string","enum":["unread","read"],"description":"Whether the find has been reviewed","example":"unread"},"result":{"type":"string","enum":["none","failed","goal"],"description":"Outcome of engagement with this find","example":"none"},"rating":{"type":["string","null"],"enum":["bad","neutral","good",null],"description":"Quality rating given by user","example":"good"},"favorited":{"type":"boolean","description":"Whether the find is marked as favorite","example":true},"feedback":{"type":["string","null"],"description":"User feedback on the find quality","example":"Great lead, highly relevant to our target market"},"notes":{"type":["string","null"],"description":"Private notes about the find","example":"Follow up next week after product launch"}},"required":["assigned_uid","engagement_status","read_status","result","rating","favorited","feedback","notes"],"examples":[{"assigned_uid":"7c9e6679-7425-40de-944b-e07fc1f90ae7","engagement_status":"acted_on","read_status":"read","result":"goal","rating":"good","favorited":true,"feedback":"Exactly the kind of buyer we want to hear from","notes":"Replied on Oct 2. Follow up after their trial ends."}]},"SearchContactsResponse":{"type":"object","properties":{"contacts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the contact","example":"123e4567-e89b-12d3-a456-426614174000"},"company_id":{"type":"string","format":"uuid","description":"Company that owns this contact","example":"123e4567-e89b-12d3-a456-426614174000"},"display_name":{"type":"string","description":"Display name for the contact","example":"John Doe"},"first_name":{"type":["string","null"],"description":"First name of the contact","example":"John"},"last_name":{"type":["string","null"],"description":"Last name of the contact","example":"Doe"},"company_name":{"type":["string","null"],"description":"Company or organization name","example":"Acme Corp"},"is_blocked":{"type":"boolean","description":"Whether this contact is blocked","example":false},"is_company":{"type":"boolean","description":"Whether this represents a company profile","example":false},"is_platform_name":{"type":"boolean","description":"Whether this is a platform-generated name","example":false},"discovered_source":{"type":"string","enum":["manual","twitter","linkedIn","reddit","facebook"],"description":"Platform where contact was discovered","example":"twitter"},"profile_image":{"type":["string","null"],"description":"URL to profile image","example":"https://example.com/avatar.jpg"},"notes":{"type":["string","null"],"description":"Private notes about this contact","example":"Potential customer, interested in our API"},"created_at":{"type":"string","format":"date-time","description":"When the contact was first discovered","example":"2024-01-15T14:30:00Z"},"updated_at":{"type":"string","format":"date-time","description":"When the contact was last modified","example":"2024-01-15T14:30:00Z"}},"required":["id","company_id","display_name","first_name","last_name","company_name","is_blocked","is_company","is_platform_name","discovered_source","profile_image","notes","created_at","updated_at"]},"description":"Array of contact records matching the search criteria"},"pagination":{"type":"object","properties":{"page":{"type":"integer","description":"Current page number","example":1},"limit":{"type":"integer","description":"Items per page","example":50},"total":{"type":"integer","description":"Total number of items across all pages","example":150},"total_pages":{"type":"integer","description":"Total number of pages","example":3}},"required":["page","limit","total","total_pages"],"description":"Pagination metadata for the results"}},"required":["contacts","pagination"]},"SearchContactsRequest":{"type":"object","properties":{"filters":{"type":"object","properties":{"searchText":{"type":"string","description":"Search in contact names and company names","example":"John Doe"},"status":{"type":"string","enum":["blocked","unblocked","all"],"default":"all","description":"Filter by blocked status","example":"unblocked"},"sources":{"type":"array","items":{"type":"string","enum":["manual","twitter","linkedIn","reddit","facebook"]}},"hasExternalContacts":{"type":"boolean"},"isCompany":{"type":"boolean"},"isPlatformName":{"type":"boolean"},"dateRange":{"type":"object","properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"}}}},"default":{}},"pagination":{"type":"object","properties":{"page":{"type":"integer","minimum":1,"default":1,"description":"Page number for pagination (1-based)","example":1},"limit":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Number of items per page (max 100)","example":50}},"default":{},"additionalProperties":false},"sort":{"type":"object","properties":{"field":{"type":"string","enum":["display_name","created_at","updated_at","first_name","last_name"],"default":"created_at","description":"Field to sort contacts by","example":"created_at"},"direction":{"type":"string","enum":["asc","desc"],"default":"desc","description":"Sort direction","example":"desc"}},"default":{}}},"additionalProperties":false,"examples":[{"filters":{"searchText":"Dana","status":"unblocked","isCompany":false},"sort":{"field":"created_at","direction":"desc"},"pagination":{"page":1,"limit":25}}]},"SearchGhostsResponse":{"type":"object","properties":{"ghosts":{"type":"array","items":{"$ref":"#/components/schemas/GhostDetail"}},"pagination":{"type":"object","properties":{"page":{"type":"integer","description":"Current page number","example":1},"limit":{"type":"integer","description":"Items per page","example":50},"total":{"type":"integer","description":"Total number of items across all pages","example":150},"total_pages":{"type":"integer","description":"Total number of pages","example":3}},"required":["page","limit","total","total_pages"],"description":"Pagination metadata for the results"}},"required":["ghosts","pagination"]},"SearchGhostsRequest":{"type":"object","properties":{"ghostQueryParams":{"type":"object","properties":{"filters":{"type":"object","properties":{"services":{"type":"array","items":{"type":"string","enum":["Twitter","LinkedIn","Reddit","Facebook","LinkedIn_People","LinkedIn_Company"]},"description":"Filter by service type (e.g. Twitter, LinkedIn, Reddit, Facebook)"},"platforms":{"type":"array","items":{"type":"string","enum":["Twitter","LinkedIn","Reddit","Facebook"]},"description":"Filter by platform (expands to all services for that platform, e.g. LinkedIn includes LinkedIn_People)"},"name":{"type":"string","description":"Search Ghosts by its name"},"autoRun":{"type":"boolean","description":"Filter by if the ghost is set to auto-run"},"hasNotifications":{"type":"boolean","description":"Filter by whether notifications are enabled"},"assignedTo":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Filter by assigned team member UUIDs"},"suggestedResponsesEnabled":{"type":"boolean","description":"Filter by if suggested responses are enabled/disabled"},"dateRange":{"type":"object","properties":{"start":{"type":"string","description":"Start date (ISO 8601)"},"end":{"type":"string","description":"End date (ISO 8601)"}},"description":"Filter by creation date range"}},"default":{}},"sorts":{"type":"object","properties":{"field":{"type":"string","enum":["name","created_at"],"description":"Value to sort by"},"direction":{"type":"string","enum":["asc","desc"],"description":"Sort direction"}},"description":"Sorting options for the search results"},"company_id":{"type":"string"},"pagination":{"type":"object","properties":{"page":{"type":"integer","exclusiveMinimum":0,"default":1},"limit":{"type":"integer","exclusiveMinimum":0,"default":8}}}},"required":["company_id"]},"pagination":{"type":"object","properties":{"page":{"type":"integer","minimum":1,"default":1,"description":"Page number for pagination (1-based)","example":1},"limit":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Number of items per page (max 100)","example":50}},"default":{"page":1,"limit":50},"additionalProperties":false}},"required":["ghostQueryParams"],"additionalProperties":false,"examples":[{"ghostQueryParams":{"company_id":"123e4567-e89b-12d3-a456-426614174000","filters":{"platforms":["LinkedIn"],"name":"CRM"},"sorts":{"field":"created_at","direction":"desc"}},"pagination":{"page":1,"limit":25}}]},"ScanGhostResponse":{"type":"object","properties":{"runId":{"type":"number","description":"The ID of the created scan","example":12345},"status":{"type":"string","enum":["running","succeeded","failed","skipped","offline","queued","preprocessing","cancelled","partial"],"description":"The status of the scan: running, succeeded, failed, skipped, offline, queued, preprocessing, cancelled, partial","example":"running"},"message":{"type":"string","description":"The message from the response","example":"Ghost scan triggered successfully"}},"required":["runId","status","message"]},"ScanStatusResponse":{"type":"object","properties":{"runId":{"type":"number","description":"The ID of the scan run","example":12345},"status":{"type":"string","enum":["running","succeeded","failed","skipped","offline","queued","preprocessing","cancelled","partial"],"description":"The status of the scan: running, succeeded, failed, skipped, offline, queued, preprocessing, cancelled, partial","example":"succeeded"},"startTime":{"type":"string","format":"date-time","description":"When the scan started (ISO 8601)","example":"2024-01-15T10:30:00Z"},"endTime":{"type":["string","null"],"format":"date-time","description":"When the scan ended (ISO 8601), null if still running","example":"2024-01-15T10:35:00Z"},"duration":{"type":["number","null"],"description":"Duration in milliseconds, null if still running","example":300000},"totalDiscovered":{"type":["number","null"],"description":"Total findings discovered during the scan","example":15},"error":{"description":"Error details if the scan failed","example":null}},"required":["runId","status","startTime","endTime","duration","totalDiscovered"]},"DeleteScanResponse":{"type":"object","properties":{"message":{"type":"string","description":"Description of the action taken","example":"Scan cancelled successfully"},"action":{"type":"string","enum":["cancelled","deleted"],"description":"The action that was performed","example":"cancelled"}},"required":["message","action"]},"CreateGhostResponse":{"type":"object","properties":{"ghost":{"$ref":"#/components/schemas/GhostDetail"},"runId":{"type":["number","null"],"description":"The scan started by `runImmediately`; null when no scan was requested or it failed to start","example":90412}},"required":["ghost","runId"]},"CreateGhostRequest":{"type":"object","properties":{"service":{"type":"string","enum":["Twitter","LinkedIn","Reddit","Facebook","LinkedIn_People","LinkedIn_Company"],"description":"The service this Ghost monitors"},"nickname":{"type":"string","minLength":1,"maxLength":100,"description":"The display name for the Ghost","examples":["CRM switchers"]},"goal":{"type":"string","minLength":1,"maxLength":2000,"description":"Natural language description of what the Ghost should find. Search queries determine what content is fetched; the goal determines how AI scores and filters that content. Be specific about the type of content, industry, and intent you want to match.\n\nGreat goals answer the following three basic questions:\n\n1. The perfect Find for me looks like...\n2. Don't show me Finds that look like...\n3. I want to engage with these Finds because...\n\nThe more detailed, the better!","examples":["People who are frustrated with their current CRM and are asking for alternatives or recommendations. Don't show me vendors promoting their own product, job postings, or generic sales advice. I want to engage with these Finds because we sell a CRM for small sales teams and can offer a genuinely helpful recommendation."]},"threshold":{"type":"number","minimum":0.1,"maximum":1,"description":"Match confidence threshold (0.1-1.0). Lower values return more results but less relevant, higher values return fewer but more precise matches. Steps of 0.1","examples":[0.7]},"tone":{"type":["string","null"],"maxLength":2000,"description":"Tone for AI-generated responses. Null uses the brand default tone.","examples":["Friendly and helpful, like a peer who has tried a few CRMs. No hard sell."]},"generateResponses":{"type":"boolean","description":"Enable AI-generated response suggestions for Finds. Requires Engage plan."},"frequency":{"oneOf":[{"type":"object","properties":{"value":{"type":"string","enum":["10","15","30"]},"unit":{"type":"string","enum":["minutes"]}},"required":["value","unit"],"title":"Minutes"},{"type":"object","properties":{"value":{"type":"string","enum":["1","2","3","4","5","6","7","8","9","10","11","12"]},"unit":{"type":"string","enum":["hours"]}},"required":["value","unit"],"title":"Hours"},{"type":"object","properties":{"value":{"type":"string","enum":["1","2","3","4","5","6","7"]},"unit":{"type":"string","enum":["days"]}},"required":["value","unit"],"title":"Days"}],"description":"How often the Ghost scans for new content.","examples":[{"value":"1","unit":"days"},{"value":"6","unit":"hours"}]},"maxFinds":{"type":"integer","minimum":0,"maximum":100,"description":"Maximum finds per scan. 0 means unlimited.","examples":[25]},"autoAssign":{"type":["string","null"],"format":"uuid","description":"UUID of a team member to auto-assign finds to. Use search_team_members to find valid IDs. Requires Engage plan.","examples":["7c9e6679-7425-40de-944b-e07fc1f90ae7"]},"serviceSettings":{"anyOf":[{"type":"object","properties":{"searchQueries":{"anyOf":[{"type":"object","properties":{"queries":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","examples":["\"CRM alternative\" OR \"switching CRMs\"","CRM (recommend OR recommendation) -hiring"]},"filters":{"type":["object","null"],"properties":{"images":{"type":["boolean","null"]},"url":{"type":["string","null"],"pattern":"^(?:(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,6})$"},"lang":{"anyOf":[{"type":"string","enum":["aa","ab","ae","af","ak","am","an","ar","as","av","ay","az","ba","be","bg","bi","bm","bn","bo","br","bs","ca","ce","ch","co","cr","cs","cu","cv","cy","da","de","dv","dz","ee","el","en","eo","es","et","eu","fa","ff","fi","fj","fo","fr","fy","ga","gd","gl","gn","gu","gv","ha","he","hi","ho","hr","ht","hu","hy","hz","ia","id","ie","ig","ii","ik","io","is","it","iu","ja","jv","ka","kg","ki","kj","kk","kl","km","kn","ko","kr","ks","ku","kv","kw","ky","la","lb","lg","li","ln","lo","lt","lu","lv","mg","mh","mi","mk","ml","mn","mr","ms","mt","my","na","nb","nd","ne","ng","nl","nn","no","nr","nv","ny","oc","oj","om","or","os","pa","pi","pl","ps","pt","qu","rm","rn","ro","ru","rw","sa","sc","sd","se","sg","si","sk","sl","sm","sn","so","sq","sr","ss","st","su","sv","sw","ta","te","tg","th","ti","tk","tl","tn","to","tr","ts","tt","tw","ty","ug","uk","ur","uz","ve","vi","vo","wa","wo","xh","yi","yo","za","zh","zu"]},{"type":"array","items":{"type":"string","enum":["aa","ab","ae","af","ak","am","an","ar","as","av","ay","az","ba","be","bg","bi","bm","bn","bo","br","bs","ca","ce","ch","co","cr","cs","cu","cv","cy","da","de","dv","dz","ee","el","en","eo","es","et","eu","fa","ff","fi","fj","fo","fr","fy","ga","gd","gl","gn","gu","gv","ha","he","hi","ho","hr","ht","hu","hy","hz","ia","id","ie","ig","ii","ik","io","is","it","iu","ja","jv","ka","kg","ki","kj","kk","kl","km","kn","ko","kr","ks","ku","kv","kw","ky","la","lb","lg","li","ln","lo","lt","lu","lv","mg","mh","mi","mk","ml","mn","mr","ms","mt","my","na","nb","nd","ne","ng","nl","nn","no","nr","nv","ny","oc","oj","om","or","os","pa","pi","pl","ps","pt","qu","rm","rn","ro","ru","rw","sa","sc","sd","se","sg","si","sk","sl","sm","sn","so","sq","sr","ss","st","su","sv","sw","ta","te","tg","th","ti","tk","tl","tn","to","tr","ts","tt","tw","ty","ug","uk","ur","uz","ve","vi","vo","wa","wo","xh","yi","yo","za","zh","zu"]}},{"type":"null"}]},"from":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"replyingTo":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"mentioning":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"verified":{"type":["boolean","null"]},"near":{"type":["object","null"],"properties":{"country":{"type":["string","null"]},"state":{"type":["string","null"]},"city":{"type":["string","null"]}},"required":["country","state","city"]},"retweets":{"type":["boolean","null"]},"replies":{"type":["boolean","null"]},"quotes":{"type":["boolean","null"]},"hashtags":{"type":["boolean","null"]},"news":{"type":["boolean","null"]},"sfw":{"type":["boolean","null"]},"videos":{"type":["boolean","null"]},"links":{"type":["boolean","null"]},"place":{"anyOf":[{"type":"string","enum":["96683cc9126741d1","7142eb97ae21e839","4ec01c9dbc693497","463f5d9615d7d1be","fbd6d2f5a4e4a15e","e8ad2641c1cb666c","e0060cda70f5f341","de599025180e2ee7","65b4760a2b411e11","94965b2c45386f87","25530ba03b7d90c6","f54a2170ff4b15f7","3376992a082d67c7","30410557050f13a5","4e7c21fd2af027c6","f3bfc7dcc928977f","ecdce75d48b13b64","d9074951d5976bdf","c799e2d3a79f810e","81b8dcbe189773f2","78bfaf3f12c05982","ea679934779f45c7","8198e85105936d3c","879d7cfc66c9c290","6b5d375c346e3be9","c29833e68a86e703","82b141af443cb1b8","2ee7eeaa84dbe65a","1ef1183ed7056dc1","e7c97cdfef3a741a","e222580e9a58b499","d0e642e8a900f679","d5cde4dddd7e6f94","a9928b6eaeb54f86","34ed2e67dd5a22bb","58f54743b1a62911","8d65596349ee2e01","f7531639e8db5e12","f0af1239cbebb474","1d834adff5d584df","6416b8512febefc9","1b107df3ccc0aaa1","4d3b316fe2e52b29","3b98b02fba3f9753","47a3cf27863714de","3f14ce28dc7c4566","06ef846bfc783874","0b039ce18ddf1cb9","c00e5392b3fa46fb","173c2bb9d42baaa5","2edb6e240797c549","0639360bd49a15e3","288de3df481163e8"]},{"type":"array","items":{"type":"string","enum":["96683cc9126741d1","7142eb97ae21e839","4ec01c9dbc693497","463f5d9615d7d1be","fbd6d2f5a4e4a15e","e8ad2641c1cb666c","e0060cda70f5f341","de599025180e2ee7","65b4760a2b411e11","94965b2c45386f87","25530ba03b7d90c6","f54a2170ff4b15f7","3376992a082d67c7","30410557050f13a5","4e7c21fd2af027c6","f3bfc7dcc928977f","ecdce75d48b13b64","d9074951d5976bdf","c799e2d3a79f810e","81b8dcbe189773f2","78bfaf3f12c05982","ea679934779f45c7","8198e85105936d3c","879d7cfc66c9c290","6b5d375c346e3be9","c29833e68a86e703","82b141af443cb1b8","2ee7eeaa84dbe65a","1ef1183ed7056dc1","e7c97cdfef3a741a","e222580e9a58b499","d0e642e8a900f679","d5cde4dddd7e6f94","a9928b6eaeb54f86","34ed2e67dd5a22bb","58f54743b1a62911","8d65596349ee2e01","f7531639e8db5e12","f0af1239cbebb474","1d834adff5d584df","6416b8512febefc9","1b107df3ccc0aaa1","4d3b316fe2e52b29","3b98b02fba3f9753","47a3cf27863714de","3f14ce28dc7c4566","06ef846bfc783874","0b039ce18ddf1cb9","c00e5392b3fa46fb","173c2bb9d42baaa5","2edb6e240797c549","0639360bd49a15e3","288de3df481163e8"]}},{"type":"null"}]},"tags":{"type":["boolean","null"]},"minFollowers":{"type":["number","null"]},"minFollowing":{"type":["number","null"]},"minTweets":{"type":["number","null"]},"canDM":{"type":["boolean","null"]}},"default":{}}},"required":["value"]},"minItems":1,"maxItems":15},"global":{"type":"object","properties":{"images":{"type":["boolean","null"]},"url":{"type":["string","null"],"pattern":"^(?:(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,6})$"},"lang":{"anyOf":[{"type":"string","enum":["aa","ab","ae","af","ak","am","an","ar","as","av","ay","az","ba","be","bg","bi","bm","bn","bo","br","bs","ca","ce","ch","co","cr","cs","cu","cv","cy","da","de","dv","dz","ee","el","en","eo","es","et","eu","fa","ff","fi","fj","fo","fr","fy","ga","gd","gl","gn","gu","gv","ha","he","hi","ho","hr","ht","hu","hy","hz","ia","id","ie","ig","ii","ik","io","is","it","iu","ja","jv","ka","kg","ki","kj","kk","kl","km","kn","ko","kr","ks","ku","kv","kw","ky","la","lb","lg","li","ln","lo","lt","lu","lv","mg","mh","mi","mk","ml","mn","mr","ms","mt","my","na","nb","nd","ne","ng","nl","nn","no","nr","nv","ny","oc","oj","om","or","os","pa","pi","pl","ps","pt","qu","rm","rn","ro","ru","rw","sa","sc","sd","se","sg","si","sk","sl","sm","sn","so","sq","sr","ss","st","su","sv","sw","ta","te","tg","th","ti","tk","tl","tn","to","tr","ts","tt","tw","ty","ug","uk","ur","uz","ve","vi","vo","wa","wo","xh","yi","yo","za","zh","zu"]},{"type":"array","items":{"type":"string","enum":["aa","ab","ae","af","ak","am","an","ar","as","av","ay","az","ba","be","bg","bi","bm","bn","bo","br","bs","ca","ce","ch","co","cr","cs","cu","cv","cy","da","de","dv","dz","ee","el","en","eo","es","et","eu","fa","ff","fi","fj","fo","fr","fy","ga","gd","gl","gn","gu","gv","ha","he","hi","ho","hr","ht","hu","hy","hz","ia","id","ie","ig","ii","ik","io","is","it","iu","ja","jv","ka","kg","ki","kj","kk","kl","km","kn","ko","kr","ks","ku","kv","kw","ky","la","lb","lg","li","ln","lo","lt","lu","lv","mg","mh","mi","mk","ml","mn","mr","ms","mt","my","na","nb","nd","ne","ng","nl","nn","no","nr","nv","ny","oc","oj","om","or","os","pa","pi","pl","ps","pt","qu","rm","rn","ro","ru","rw","sa","sc","sd","se","sg","si","sk","sl","sm","sn","so","sq","sr","ss","st","su","sv","sw","ta","te","tg","th","ti","tk","tl","tn","to","tr","ts","tt","tw","ty","ug","uk","ur","uz","ve","vi","vo","wa","wo","xh","yi","yo","za","zh","zu"]}},{"type":"null"}]},"from":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"replyingTo":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"mentioning":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"verified":{"type":["boolean","null"]},"near":{"type":["object","null"],"properties":{"country":{"type":["string","null"]},"state":{"type":["string","null"]},"city":{"type":["string","null"]}},"required":["country","state","city"]},"retweets":{"type":["boolean","null"]},"replies":{"type":["boolean","null"]},"quotes":{"type":["boolean","null"]},"hashtags":{"type":["boolean","null"]},"news":{"type":["boolean","null"]},"sfw":{"type":["boolean","null"]},"videos":{"type":["boolean","null"]},"links":{"type":["boolean","null"]},"place":{"anyOf":[{"type":"string","enum":["96683cc9126741d1","7142eb97ae21e839","4ec01c9dbc693497","463f5d9615d7d1be","fbd6d2f5a4e4a15e","e8ad2641c1cb666c","e0060cda70f5f341","de599025180e2ee7","65b4760a2b411e11","94965b2c45386f87","25530ba03b7d90c6","f54a2170ff4b15f7","3376992a082d67c7","30410557050f13a5","4e7c21fd2af027c6","f3bfc7dcc928977f","ecdce75d48b13b64","d9074951d5976bdf","c799e2d3a79f810e","81b8dcbe189773f2","78bfaf3f12c05982","ea679934779f45c7","8198e85105936d3c","879d7cfc66c9c290","6b5d375c346e3be9","c29833e68a86e703","82b141af443cb1b8","2ee7eeaa84dbe65a","1ef1183ed7056dc1","e7c97cdfef3a741a","e222580e9a58b499","d0e642e8a900f679","d5cde4dddd7e6f94","a9928b6eaeb54f86","34ed2e67dd5a22bb","58f54743b1a62911","8d65596349ee2e01","f7531639e8db5e12","f0af1239cbebb474","1d834adff5d584df","6416b8512febefc9","1b107df3ccc0aaa1","4d3b316fe2e52b29","3b98b02fba3f9753","47a3cf27863714de","3f14ce28dc7c4566","06ef846bfc783874","0b039ce18ddf1cb9","c00e5392b3fa46fb","173c2bb9d42baaa5","2edb6e240797c549","0639360bd49a15e3","288de3df481163e8"]},{"type":"array","items":{"type":"string","enum":["96683cc9126741d1","7142eb97ae21e839","4ec01c9dbc693497","463f5d9615d7d1be","fbd6d2f5a4e4a15e","e8ad2641c1cb666c","e0060cda70f5f341","de599025180e2ee7","65b4760a2b411e11","94965b2c45386f87","25530ba03b7d90c6","f54a2170ff4b15f7","3376992a082d67c7","30410557050f13a5","4e7c21fd2af027c6","f3bfc7dcc928977f","ecdce75d48b13b64","d9074951d5976bdf","c799e2d3a79f810e","81b8dcbe189773f2","78bfaf3f12c05982","ea679934779f45c7","8198e85105936d3c","879d7cfc66c9c290","6b5d375c346e3be9","c29833e68a86e703","82b141af443cb1b8","2ee7eeaa84dbe65a","1ef1183ed7056dc1","e7c97cdfef3a741a","e222580e9a58b499","d0e642e8a900f679","d5cde4dddd7e6f94","a9928b6eaeb54f86","34ed2e67dd5a22bb","58f54743b1a62911","8d65596349ee2e01","f7531639e8db5e12","f0af1239cbebb474","1d834adff5d584df","6416b8512febefc9","1b107df3ccc0aaa1","4d3b316fe2e52b29","3b98b02fba3f9753","47a3cf27863714de","3f14ce28dc7c4566","06ef846bfc783874","0b039ce18ddf1cb9","c00e5392b3fa46fb","173c2bb9d42baaa5","2edb6e240797c549","0639360bd49a15e3","288de3df481163e8"]}},{"type":"null"}]},"tags":{"type":["boolean","null"]},"minFollowers":{"type":["number","null"]},"minFollowing":{"type":["number","null"]},"minTweets":{"type":["number","null"]},"canDM":{"type":["boolean","null"]}},"default":{}}},"required":["queries"],"title":"Queries with global filters"},{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","examples":["\"CRM alternative\" OR \"switching CRMs\"","CRM (recommend OR recommendation) -hiring"]},"filters":{"type":["object","null"],"properties":{"images":{"type":["boolean","null"]},"url":{"type":["string","null"],"pattern":"^(?:(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,6})$"},"lang":{"anyOf":[{"type":"string","enum":["aa","ab","ae","af","ak","am","an","ar","as","av","ay","az","ba","be","bg","bi","bm","bn","bo","br","bs","ca","ce","ch","co","cr","cs","cu","cv","cy","da","de","dv","dz","ee","el","en","eo","es","et","eu","fa","ff","fi","fj","fo","fr","fy","ga","gd","gl","gn","gu","gv","ha","he","hi","ho","hr","ht","hu","hy","hz","ia","id","ie","ig","ii","ik","io","is","it","iu","ja","jv","ka","kg","ki","kj","kk","kl","km","kn","ko","kr","ks","ku","kv","kw","ky","la","lb","lg","li","ln","lo","lt","lu","lv","mg","mh","mi","mk","ml","mn","mr","ms","mt","my","na","nb","nd","ne","ng","nl","nn","no","nr","nv","ny","oc","oj","om","or","os","pa","pi","pl","ps","pt","qu","rm","rn","ro","ru","rw","sa","sc","sd","se","sg","si","sk","sl","sm","sn","so","sq","sr","ss","st","su","sv","sw","ta","te","tg","th","ti","tk","tl","tn","to","tr","ts","tt","tw","ty","ug","uk","ur","uz","ve","vi","vo","wa","wo","xh","yi","yo","za","zh","zu"]},{"type":"array","items":{"type":"string","enum":["aa","ab","ae","af","ak","am","an","ar","as","av","ay","az","ba","be","bg","bi","bm","bn","bo","br","bs","ca","ce","ch","co","cr","cs","cu","cv","cy","da","de","dv","dz","ee","el","en","eo","es","et","eu","fa","ff","fi","fj","fo","fr","fy","ga","gd","gl","gn","gu","gv","ha","he","hi","ho","hr","ht","hu","hy","hz","ia","id","ie","ig","ii","ik","io","is","it","iu","ja","jv","ka","kg","ki","kj","kk","kl","km","kn","ko","kr","ks","ku","kv","kw","ky","la","lb","lg","li","ln","lo","lt","lu","lv","mg","mh","mi","mk","ml","mn","mr","ms","mt","my","na","nb","nd","ne","ng","nl","nn","no","nr","nv","ny","oc","oj","om","or","os","pa","pi","pl","ps","pt","qu","rm","rn","ro","ru","rw","sa","sc","sd","se","sg","si","sk","sl","sm","sn","so","sq","sr","ss","st","su","sv","sw","ta","te","tg","th","ti","tk","tl","tn","to","tr","ts","tt","tw","ty","ug","uk","ur","uz","ve","vi","vo","wa","wo","xh","yi","yo","za","zh","zu"]}},{"type":"null"}]},"from":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"replyingTo":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"mentioning":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"verified":{"type":["boolean","null"]},"near":{"type":["object","null"],"properties":{"country":{"type":["string","null"]},"state":{"type":["string","null"]},"city":{"type":["string","null"]}},"required":["country","state","city"]},"retweets":{"type":["boolean","null"]},"replies":{"type":["boolean","null"]},"quotes":{"type":["boolean","null"]},"hashtags":{"type":["boolean","null"]},"news":{"type":["boolean","null"]},"sfw":{"type":["boolean","null"]},"videos":{"type":["boolean","null"]},"links":{"type":["boolean","null"]},"place":{"anyOf":[{"type":"string","enum":["96683cc9126741d1","7142eb97ae21e839","4ec01c9dbc693497","463f5d9615d7d1be","fbd6d2f5a4e4a15e","e8ad2641c1cb666c","e0060cda70f5f341","de599025180e2ee7","65b4760a2b411e11","94965b2c45386f87","25530ba03b7d90c6","f54a2170ff4b15f7","3376992a082d67c7","30410557050f13a5","4e7c21fd2af027c6","f3bfc7dcc928977f","ecdce75d48b13b64","d9074951d5976bdf","c799e2d3a79f810e","81b8dcbe189773f2","78bfaf3f12c05982","ea679934779f45c7","8198e85105936d3c","879d7cfc66c9c290","6b5d375c346e3be9","c29833e68a86e703","82b141af443cb1b8","2ee7eeaa84dbe65a","1ef1183ed7056dc1","e7c97cdfef3a741a","e222580e9a58b499","d0e642e8a900f679","d5cde4dddd7e6f94","a9928b6eaeb54f86","34ed2e67dd5a22bb","58f54743b1a62911","8d65596349ee2e01","f7531639e8db5e12","f0af1239cbebb474","1d834adff5d584df","6416b8512febefc9","1b107df3ccc0aaa1","4d3b316fe2e52b29","3b98b02fba3f9753","47a3cf27863714de","3f14ce28dc7c4566","06ef846bfc783874","0b039ce18ddf1cb9","c00e5392b3fa46fb","173c2bb9d42baaa5","2edb6e240797c549","0639360bd49a15e3","288de3df481163e8"]},{"type":"array","items":{"type":"string","enum":["96683cc9126741d1","7142eb97ae21e839","4ec01c9dbc693497","463f5d9615d7d1be","fbd6d2f5a4e4a15e","e8ad2641c1cb666c","e0060cda70f5f341","de599025180e2ee7","65b4760a2b411e11","94965b2c45386f87","25530ba03b7d90c6","f54a2170ff4b15f7","3376992a082d67c7","30410557050f13a5","4e7c21fd2af027c6","f3bfc7dcc928977f","ecdce75d48b13b64","d9074951d5976bdf","c799e2d3a79f810e","81b8dcbe189773f2","78bfaf3f12c05982","ea679934779f45c7","8198e85105936d3c","879d7cfc66c9c290","6b5d375c346e3be9","c29833e68a86e703","82b141af443cb1b8","2ee7eeaa84dbe65a","1ef1183ed7056dc1","e7c97cdfef3a741a","e222580e9a58b499","d0e642e8a900f679","d5cde4dddd7e6f94","a9928b6eaeb54f86","34ed2e67dd5a22bb","58f54743b1a62911","8d65596349ee2e01","f7531639e8db5e12","f0af1239cbebb474","1d834adff5d584df","6416b8512febefc9","1b107df3ccc0aaa1","4d3b316fe2e52b29","3b98b02fba3f9753","47a3cf27863714de","3f14ce28dc7c4566","06ef846bfc783874","0b039ce18ddf1cb9","c00e5392b3fa46fb","173c2bb9d42baaa5","2edb6e240797c549","0639360bd49a15e3","288de3df481163e8"]}},{"type":"null"}]},"tags":{"type":["boolean","null"]},"minFollowers":{"type":["number","null"]},"minFollowing":{"type":["number","null"]},"minTweets":{"type":["number","null"]},"canDM":{"type":["boolean","null"]}},"default":{}}},"required":["value"]},"minItems":1,"maxItems":15,"deprecated":true,"title":"Queries only"}]},"onlyTweets":{"type":"boolean","default":false},"responseTypes":{"type":["object","null"],"properties":{"like":{"type":["boolean","null"],"default":true},"reply":{"type":["boolean","null"],"default":true},"retweet":{"type":["boolean","null"],"default":true},"follow":{"type":["boolean","null"],"default":true},"dm":{"type":["boolean","null"],"default":true},"quote":{"type":["boolean","null"],"default":true}},"default":null}},"required":["searchQueries"],"title":"Twitter"},{"type":"object","properties":{"searchQueries":{"anyOf":[{"type":"object","properties":{"queries":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","examples":["CRM (alternative OR switching OR \"moving away\")","\"sales team\" \"new CRM\""]},"filters":{"type":["object","null"],"properties":{"hasImage":{"type":["boolean","null"]},"hasVideo":{"type":["boolean","null"]},"hasHashtags":{"type":["boolean","null"]},"hasLink":{"type":["boolean","null"]},"hasDocument":{"type":["boolean","null"]},"posterType":{"type":["string","null"],"enum":["Person","Company",null]},"isJobPosting":{"type":["boolean","null"]},"isQuoting":{"type":["boolean","null"]},"isCelebration":{"type":["boolean","null"]},"permission.canReact":{"type":["boolean","null"]},"permission.canComment":{"type":["boolean","null"]},"permission.canMessage":{"type":["boolean","null"]},"permission.canShare":{"type":["boolean","null"]},"profile.industry":{"anyOf":[{"type":"string","enum":["1","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115","116","117","118","119","120","121","122","123","124","125","126","127","128","129","130","131","132","133","134","135","136","137","138","139","140","141","142","143","145","146","147","148","150","201","256","298","332","341","345","356","382","383","384","385","386","387","388","389","390","397","398","400","404","406","408","413","419","428","431","435","436","453","460","481","495","504","529","562","564","598","615","616","622","625","679","690","703","709","722","727","743","773","779","784","794","799","840","849","861","871","873","876","883","887","901","923","928","935","964","973","983","994","998","1005","1029","1042","1080","1090","1095","1128","1137","1153","1157","1166","1171","1178","1187","1206","1208","1212","1221","1222","1230","1231","1250","1257","1262","1267","1285","1292","1309","1319","1324","1339","1359","1370","1407","1409","1423","1424","1431","1445","1481","1495","1497","1504","1505","1512","1517","1520","1532","1573","1594","1600","1602","1611","1623","1625","1633","1641","1644","1649","1673","1678","1696","1713","1720","1725","1737","1738","1742","1743","1745","1750","1757","1759","1770","1779","1786","1798","1810","1855","1862","1905","1909","1911","1912","1916","1923","1925","1931","1938","1956","1958","1965","1981","1986","1999","2012","2018","2019","2020","2025","2027","2029","2040","2045","2048","2050","2054","2060","2063","2069","2074","2077","2081","2091","2112","2122","2125","2128","2130","2133","2135","2139","2142","2143","2159","2161","2163","2167","2179","2181","2194","2197","2212","2214","2217","2226","2240","2247","2253","2255","2258","2259","2272","2282","2318","2353","2358","2366","2369","2374","2375","2391","2401","2458","2468","2489","2500","2934","3065","3068","3070","3081","3085","3086","3089","3095","3096","3099","3100","3101","3102","3103","3104","3105","3106","3107","3124","3125","3126","3127","3128","3129","3130","3131","3132","3133","3134","3186","3240","3241","3242","3243","3244","3245","3246","3247","3248","3249","3250","3251","3252","3253","3254","3255","3256"]},{"type":"array","items":{"type":"string","enum":["1","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115","116","117","118","119","120","121","122","123","124","125","126","127","128","129","130","131","132","133","134","135","136","137","138","139","140","141","142","143","145","146","147","148","150","201","256","298","332","341","345","356","382","383","384","385","386","387","388","389","390","397","398","400","404","406","408","413","419","428","431","435","436","453","460","481","495","504","529","562","564","598","615","616","622","625","679","690","703","709","722","727","743","773","779","784","794","799","840","849","861","871","873","876","883","887","901","923","928","935","964","973","983","994","998","1005","1029","1042","1080","1090","1095","1128","1137","1153","1157","1166","1171","1178","1187","1206","1208","1212","1221","1222","1230","1231","1250","1257","1262","1267","1285","1292","1309","1319","1324","1339","1359","1370","1407","1409","1423","1424","1431","1445","1481","1495","1497","1504","1505","1512","1517","1520","1532","1573","1594","1600","1602","1611","1623","1625","1633","1641","1644","1649","1673","1678","1696","1713","1720","1725","1737","1738","1742","1743","1745","1750","1757","1759","1770","1779","1786","1798","1810","1855","1862","1905","1909","1911","1912","1916","1923","1925","1931","1938","1956","1958","1965","1981","1986","1999","2012","2018","2019","2020","2025","2027","2029","2040","2045","2048","2050","2054","2060","2063","2069","2074","2077","2081","2091","2112","2122","2125","2128","2130","2133","2135","2139","2142","2143","2159","2161","2163","2167","2179","2181","2194","2197","2212","2214","2217","2226","2240","2247","2253","2255","2258","2259","2272","2282","2318","2353","2358","2366","2369","2374","2375","2391","2401","2458","2468","2489","2500","2934","3065","3068","3070","3081","3085","3086","3089","3095","3096","3099","3100","3101","3102","3103","3104","3105","3106","3107","3124","3125","3126","3127","3128","3129","3130","3131","3132","3133","3134","3186","3240","3241","3242","3243","3244","3245","3246","3247","3248","3249","3250","3251","3252","3253","3254","3255","3256"]}},{"type":"null"}]},"profile.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"profile.minFollowerCount":{"type":["number","null"]},"company.minFollowerCount":{"type":["number","null"]},"profile.title":{"type":["string","null"]},"profile.currentPosition.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"profile.currentPosition.hasJob":{"type":["boolean","null"]},"profile.currentPosition.minEmployeeCount":{"type":["number","null"]},"profile.currentPosition.maxEmployeeCount":{"type":["number","null"]},"company.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"company.companyAge":{"type":["number","null"]},"company.companySize":{"type":["number","null"]},"company.contactInfo.hasWebsite":{"type":["boolean","null"]},"company.contactInfo.hasPhoneNumber":{"type":["boolean","null"]},"company.companyType":{"type":["string","null"],"enum":["PROFIT","NON_PROFIT",null]}},"default":{}}},"required":["value"]},"minItems":1,"maxItems":15},"global":{"type":"object","properties":{"hasImage":{"type":["boolean","null"]},"hasVideo":{"type":["boolean","null"]},"hasHashtags":{"type":["boolean","null"]},"hasLink":{"type":["boolean","null"]},"hasDocument":{"type":["boolean","null"]},"posterType":{"type":["string","null"],"enum":["Person","Company",null]},"isJobPosting":{"type":["boolean","null"]},"isQuoting":{"type":["boolean","null"]},"isCelebration":{"type":["boolean","null"]},"permission.canReact":{"type":["boolean","null"]},"permission.canComment":{"type":["boolean","null"]},"permission.canMessage":{"type":["boolean","null"]},"permission.canShare":{"type":["boolean","null"]},"profile.industry":{"anyOf":[{"type":"string","enum":["1","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115","116","117","118","119","120","121","122","123","124","125","126","127","128","129","130","131","132","133","134","135","136","137","138","139","140","141","142","143","145","146","147","148","150","201","256","298","332","341","345","356","382","383","384","385","386","387","388","389","390","397","398","400","404","406","408","413","419","428","431","435","436","453","460","481","495","504","529","562","564","598","615","616","622","625","679","690","703","709","722","727","743","773","779","784","794","799","840","849","861","871","873","876","883","887","901","923","928","935","964","973","983","994","998","1005","1029","1042","1080","1090","1095","1128","1137","1153","1157","1166","1171","1178","1187","1206","1208","1212","1221","1222","1230","1231","1250","1257","1262","1267","1285","1292","1309","1319","1324","1339","1359","1370","1407","1409","1423","1424","1431","1445","1481","1495","1497","1504","1505","1512","1517","1520","1532","1573","1594","1600","1602","1611","1623","1625","1633","1641","1644","1649","1673","1678","1696","1713","1720","1725","1737","1738","1742","1743","1745","1750","1757","1759","1770","1779","1786","1798","1810","1855","1862","1905","1909","1911","1912","1916","1923","1925","1931","1938","1956","1958","1965","1981","1986","1999","2012","2018","2019","2020","2025","2027","2029","2040","2045","2048","2050","2054","2060","2063","2069","2074","2077","2081","2091","2112","2122","2125","2128","2130","2133","2135","2139","2142","2143","2159","2161","2163","2167","2179","2181","2194","2197","2212","2214","2217","2226","2240","2247","2253","2255","2258","2259","2272","2282","2318","2353","2358","2366","2369","2374","2375","2391","2401","2458","2468","2489","2500","2934","3065","3068","3070","3081","3085","3086","3089","3095","3096","3099","3100","3101","3102","3103","3104","3105","3106","3107","3124","3125","3126","3127","3128","3129","3130","3131","3132","3133","3134","3186","3240","3241","3242","3243","3244","3245","3246","3247","3248","3249","3250","3251","3252","3253","3254","3255","3256"]},{"type":"array","items":{"type":"string","enum":["1","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115","116","117","118","119","120","121","122","123","124","125","126","127","128","129","130","131","132","133","134","135","136","137","138","139","140","141","142","143","145","146","147","148","150","201","256","298","332","341","345","356","382","383","384","385","386","387","388","389","390","397","398","400","404","406","408","413","419","428","431","435","436","453","460","481","495","504","529","562","564","598","615","616","622","625","679","690","703","709","722","727","743","773","779","784","794","799","840","849","861","871","873","876","883","887","901","923","928","935","964","973","983","994","998","1005","1029","1042","1080","1090","1095","1128","1137","1153","1157","1166","1171","1178","1187","1206","1208","1212","1221","1222","1230","1231","1250","1257","1262","1267","1285","1292","1309","1319","1324","1339","1359","1370","1407","1409","1423","1424","1431","1445","1481","1495","1497","1504","1505","1512","1517","1520","1532","1573","1594","1600","1602","1611","1623","1625","1633","1641","1644","1649","1673","1678","1696","1713","1720","1725","1737","1738","1742","1743","1745","1750","1757","1759","1770","1779","1786","1798","1810","1855","1862","1905","1909","1911","1912","1916","1923","1925","1931","1938","1956","1958","1965","1981","1986","1999","2012","2018","2019","2020","2025","2027","2029","2040","2045","2048","2050","2054","2060","2063","2069","2074","2077","2081","2091","2112","2122","2125","2128","2130","2133","2135","2139","2142","2143","2159","2161","2163","2167","2179","2181","2194","2197","2212","2214","2217","2226","2240","2247","2253","2255","2258","2259","2272","2282","2318","2353","2358","2366","2369","2374","2375","2391","2401","2458","2468","2489","2500","2934","3065","3068","3070","3081","3085","3086","3089","3095","3096","3099","3100","3101","3102","3103","3104","3105","3106","3107","3124","3125","3126","3127","3128","3129","3130","3131","3132","3133","3134","3186","3240","3241","3242","3243","3244","3245","3246","3247","3248","3249","3250","3251","3252","3253","3254","3255","3256"]}},{"type":"null"}]},"profile.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"profile.minFollowerCount":{"type":["number","null"]},"company.minFollowerCount":{"type":["number","null"]},"profile.title":{"type":["string","null"]},"profile.currentPosition.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"profile.currentPosition.hasJob":{"type":["boolean","null"]},"profile.currentPosition.minEmployeeCount":{"type":["number","null"]},"profile.currentPosition.maxEmployeeCount":{"type":["number","null"]},"company.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"company.companyAge":{"type":["number","null"]},"company.companySize":{"type":["number","null"]},"company.contactInfo.hasWebsite":{"type":["boolean","null"]},"company.contactInfo.hasPhoneNumber":{"type":["boolean","null"]},"company.companyType":{"type":["string","null"],"enum":["PROFIT","NON_PROFIT",null]}},"default":{}}},"required":["queries"],"title":"Queries with global filters"},{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","examples":["CRM (alternative OR switching OR \"moving away\")","\"sales team\" \"new CRM\""]},"filters":{"type":["object","null"],"properties":{"hasImage":{"type":["boolean","null"]},"hasVideo":{"type":["boolean","null"]},"hasHashtags":{"type":["boolean","null"]},"hasLink":{"type":["boolean","null"]},"hasDocument":{"type":["boolean","null"]},"posterType":{"type":["string","null"],"enum":["Person","Company",null]},"isJobPosting":{"type":["boolean","null"]},"isQuoting":{"type":["boolean","null"]},"isCelebration":{"type":["boolean","null"]},"permission.canReact":{"type":["boolean","null"]},"permission.canComment":{"type":["boolean","null"]},"permission.canMessage":{"type":["boolean","null"]},"permission.canShare":{"type":["boolean","null"]},"profile.industry":{"anyOf":[{"type":"string","enum":["1","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115","116","117","118","119","120","121","122","123","124","125","126","127","128","129","130","131","132","133","134","135","136","137","138","139","140","141","142","143","145","146","147","148","150","201","256","298","332","341","345","356","382","383","384","385","386","387","388","389","390","397","398","400","404","406","408","413","419","428","431","435","436","453","460","481","495","504","529","562","564","598","615","616","622","625","679","690","703","709","722","727","743","773","779","784","794","799","840","849","861","871","873","876","883","887","901","923","928","935","964","973","983","994","998","1005","1029","1042","1080","1090","1095","1128","1137","1153","1157","1166","1171","1178","1187","1206","1208","1212","1221","1222","1230","1231","1250","1257","1262","1267","1285","1292","1309","1319","1324","1339","1359","1370","1407","1409","1423","1424","1431","1445","1481","1495","1497","1504","1505","1512","1517","1520","1532","1573","1594","1600","1602","1611","1623","1625","1633","1641","1644","1649","1673","1678","1696","1713","1720","1725","1737","1738","1742","1743","1745","1750","1757","1759","1770","1779","1786","1798","1810","1855","1862","1905","1909","1911","1912","1916","1923","1925","1931","1938","1956","1958","1965","1981","1986","1999","2012","2018","2019","2020","2025","2027","2029","2040","2045","2048","2050","2054","2060","2063","2069","2074","2077","2081","2091","2112","2122","2125","2128","2130","2133","2135","2139","2142","2143","2159","2161","2163","2167","2179","2181","2194","2197","2212","2214","2217","2226","2240","2247","2253","2255","2258","2259","2272","2282","2318","2353","2358","2366","2369","2374","2375","2391","2401","2458","2468","2489","2500","2934","3065","3068","3070","3081","3085","3086","3089","3095","3096","3099","3100","3101","3102","3103","3104","3105","3106","3107","3124","3125","3126","3127","3128","3129","3130","3131","3132","3133","3134","3186","3240","3241","3242","3243","3244","3245","3246","3247","3248","3249","3250","3251","3252","3253","3254","3255","3256"]},{"type":"array","items":{"type":"string","enum":["1","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115","116","117","118","119","120","121","122","123","124","125","126","127","128","129","130","131","132","133","134","135","136","137","138","139","140","141","142","143","145","146","147","148","150","201","256","298","332","341","345","356","382","383","384","385","386","387","388","389","390","397","398","400","404","406","408","413","419","428","431","435","436","453","460","481","495","504","529","562","564","598","615","616","622","625","679","690","703","709","722","727","743","773","779","784","794","799","840","849","861","871","873","876","883","887","901","923","928","935","964","973","983","994","998","1005","1029","1042","1080","1090","1095","1128","1137","1153","1157","1166","1171","1178","1187","1206","1208","1212","1221","1222","1230","1231","1250","1257","1262","1267","1285","1292","1309","1319","1324","1339","1359","1370","1407","1409","1423","1424","1431","1445","1481","1495","1497","1504","1505","1512","1517","1520","1532","1573","1594","1600","1602","1611","1623","1625","1633","1641","1644","1649","1673","1678","1696","1713","1720","1725","1737","1738","1742","1743","1745","1750","1757","1759","1770","1779","1786","1798","1810","1855","1862","1905","1909","1911","1912","1916","1923","1925","1931","1938","1956","1958","1965","1981","1986","1999","2012","2018","2019","2020","2025","2027","2029","2040","2045","2048","2050","2054","2060","2063","2069","2074","2077","2081","2091","2112","2122","2125","2128","2130","2133","2135","2139","2142","2143","2159","2161","2163","2167","2179","2181","2194","2197","2212","2214","2217","2226","2240","2247","2253","2255","2258","2259","2272","2282","2318","2353","2358","2366","2369","2374","2375","2391","2401","2458","2468","2489","2500","2934","3065","3068","3070","3081","3085","3086","3089","3095","3096","3099","3100","3101","3102","3103","3104","3105","3106","3107","3124","3125","3126","3127","3128","3129","3130","3131","3132","3133","3134","3186","3240","3241","3242","3243","3244","3245","3246","3247","3248","3249","3250","3251","3252","3253","3254","3255","3256"]}},{"type":"null"}]},"profile.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"profile.minFollowerCount":{"type":["number","null"]},"company.minFollowerCount":{"type":["number","null"]},"profile.title":{"type":["string","null"]},"profile.currentPosition.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"profile.currentPosition.hasJob":{"type":["boolean","null"]},"profile.currentPosition.minEmployeeCount":{"type":["number","null"]},"profile.currentPosition.maxEmployeeCount":{"type":["number","null"]},"company.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"company.companyAge":{"type":["number","null"]},"company.companySize":{"type":["number","null"]},"company.contactInfo.hasWebsite":{"type":["boolean","null"]},"company.contactInfo.hasPhoneNumber":{"type":["boolean","null"]},"company.companyType":{"type":["string","null"],"enum":["PROFIT","NON_PROFIT",null]}},"default":{}}},"required":["value"]},"minItems":1,"maxItems":15,"deprecated":true,"title":"Queries only"}]},"responseTypes":{"type":["object","null"],"properties":{"react":{"type":["boolean","null"],"default":true},"comment":{"type":["boolean","null"],"default":true},"connect":{"type":["boolean","null"],"default":true},"repost":{"type":["boolean","null"],"default":true},"quote":{"type":["boolean","null"],"default":true}},"default":null}},"required":["searchQueries"],"title":"LinkedIn"},{"type":"object","properties":{"searchQueries":{"type":"object","properties":{"queries":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","examples":["\"CRM alternative\" OR \"switching CRMs\"","CRM (recommend OR recommendation)"]},"filters":{"type":["object","null"],"properties":{"subreddits":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"excludeSubreddits":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"canReply":{"type":["boolean","null"]},"hasMedia":{"type":["boolean","null"]},"canCrosspost":{"type":["boolean","null"]},"containsSpoilers":{"type":["boolean","null"]},"containsLinks":{"type":["boolean","null"]},"subType":{"type":["string","null"],"enum":["public","restricted",null]},"contentType":{"type":["string","null"],"enum":["post","comment",null]},"lang":{"type":["string","null"],"enum":["French","Italian","Spanish","English","German","Chinese","Japanese","Russian","Arabic","Hebrew","Polish","Hindi","Urdu","Portuguese","Thai","Turkish","Ukrainian","Vietnamese","Greek","Malay","Korean","Bengali","Irish","Punjabi","Swedish","Welsh","Armenian","Danish","Dutch","Estonian","Finnish",null]},"sentiment":{"type":["string","null"],"enum":["positive","negative","neutral",null]},"users":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"minSubSize":{"type":["number","null"]},"domains":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"minUserKarma":{"type":["number","null"]},"minUserAccountAge":{"type":["number","null"]}},"default":{}}},"required":["value"]},"minItems":1,"maxItems":15},"global":{"type":"object","properties":{"subreddits":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"excludeSubreddits":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"canReply":{"type":["boolean","null"]},"hasMedia":{"type":["boolean","null"]},"canCrosspost":{"type":["boolean","null"]},"containsSpoilers":{"type":["boolean","null"]},"containsLinks":{"type":["boolean","null"]},"subType":{"type":["string","null"],"enum":["public","restricted",null]},"contentType":{"type":["string","null"],"enum":["post","comment",null]},"lang":{"type":["string","null"],"enum":["French","Italian","Spanish","English","German","Chinese","Japanese","Russian","Arabic","Hebrew","Polish","Hindi","Urdu","Portuguese","Thai","Turkish","Ukrainian","Vietnamese","Greek","Malay","Korean","Bengali","Irish","Punjabi","Swedish","Welsh","Armenian","Danish","Dutch","Estonian","Finnish",null]},"sentiment":{"type":["string","null"],"enum":["positive","negative","neutral",null]},"users":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"minSubSize":{"type":["number","null"]},"domains":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"minUserKarma":{"type":["number","null"]},"minUserAccountAge":{"type":["number","null"]}},"default":{}}},"required":["queries"]},"responseTypes":{"type":["object","null"],"properties":{"upvote":{"type":["boolean","null"],"default":true},"downvote":{"type":["boolean","null"],"default":true},"comment":{"type":["boolean","null"],"default":true},"message":{"type":["boolean","null"],"default":true}},"default":null},"subSafeResponses":{"type":"boolean","default":true}},"required":["searchQueries"],"title":"Reddit"},{"type":"object","properties":{"searchQueries":{"type":"object","properties":{"queries":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","examples":["CRM recommendations","switching CRM"]},"filters":{"type":["object","null"],"properties":{"lang":{"type":["string","null"],"enum":["fr","it","es","en","de","zh","ja","ru","ar","he","pl","hi","ur","pt","th","tr","uk","vi","el","ms","ko","bn","ga","pa","sv","cy","hy","da","nl","et","fi",null]},"hasHashtags":{"type":["boolean","null"]},"hasLinks":{"type":["boolean","null"]},"location":{"type":["string","null"],"enum":["107991659233606","106224666074625","106003956105810","108659242498155","111762725508574","114586701886732","115963528414384","108081209214649","110970792260960","110148382341970","106300959405546","106338002735968","106220079409935","111822758834362","104028629632792","113998391943532","105745629459139","105775436121898","108424279189115","112305682116972","112887355389124","103111876395954","109570449061083","108056275889020","104019619634224","103990676304130","109260602433140","109297442421359","107705532592043","106066949424984","103787786326610","110941395597405","114497808567786","102184499823699","111983945494775","106262189412553","115167478498675","105959272778333","109870912368806","105634782802493","115976748413086","112662855415315","108489419175297","108108762549844","109493702409366","110185085668702","105559566144042","109412232411040","109375499081852","110893392264912","105675929465006","106057819434480","109307099087536","105479049486624","105496622817769","101881036520836","105540216147364","112548152092705","105988062765295","110714572282163","110184922344060","110884905606108","116190411724975","102146663160831","110843418940484","109692899057899","107674002595670","109486839070556","103728359665916","106078429431815","114629675219759","113564935326488","108299645860446","104029736299647","115753025103602","105653082800923","114469421897671","103145123058362","103123839728353","108285455858477","104034969634202",null]}},"default":{}}},"required":["value"]},"minItems":1,"maxItems":10},"global":{"type":"object","properties":{"lang":{"type":["string","null"],"enum":["fr","it","es","en","de","zh","ja","ru","ar","he","pl","hi","ur","pt","th","tr","uk","vi","el","ms","ko","bn","ga","pa","sv","cy","hy","da","nl","et","fi",null]},"hasHashtags":{"type":["boolean","null"]},"hasLinks":{"type":["boolean","null"]},"location":{"type":["string","null"],"enum":["107991659233606","106224666074625","106003956105810","108659242498155","111762725508574","114586701886732","115963528414384","108081209214649","110970792260960","110148382341970","106300959405546","106338002735968","106220079409935","111822758834362","104028629632792","113998391943532","105745629459139","105775436121898","108424279189115","112305682116972","112887355389124","103111876395954","109570449061083","108056275889020","104019619634224","103990676304130","109260602433140","109297442421359","107705532592043","106066949424984","103787786326610","110941395597405","114497808567786","102184499823699","111983945494775","106262189412553","115167478498675","105959272778333","109870912368806","105634782802493","115976748413086","112662855415315","108489419175297","108108762549844","109493702409366","110185085668702","105559566144042","109412232411040","109375499081852","110893392264912","105675929465006","106057819434480","109307099087536","105479049486624","105496622817769","101881036520836","105540216147364","112548152092705","105988062765295","110714572282163","110184922344060","110884905606108","116190411724975","102146663160831","110843418940484","109692899057899","107674002595670","109486839070556","103728359665916","106078429431815","114629675219759","113564935326488","108299645860446","104029736299647","115753025103602","105653082800923","114469421897671","103145123058362","103123839728353","108285455858477","104034969634202",null]}},"default":{}}},"required":["queries"]},"responseTypes":{"type":["object","null"],"properties":{"upvote":{"type":["boolean","null"],"default":true},"comment":{"type":["boolean","null"],"default":true},"message":{"type":["boolean","null"],"default":true}},"default":null}},"required":["searchQueries"],"title":"Facebook"},{"type":"object","properties":{"users":{"type":"object","properties":{"value":{"type":["string","null"],"default":null,"description":"The people to monitor, as one string with one LinkedIn profile URL or username per line (max 5000). Set this yourself to monitor a fixed list. When `smartSync`, `smartSearch` or `connectionsSync` is set, leave it out: PitchGhost fills and maintains the list from that source.","examples":["https://www.linkedin.com/in/dana-whitfield\nhttps://www.linkedin.com/in/marcus-oyelaran\npriya-raman"]},"smartSync":{"oneOf":[{"type":"object","properties":{"crm":{"type":"string","enum":["hubspot"]},"list":{"type":"object","properties":{"name":{"type":"string"},"id":{"type":"string"},"url":{"type":"string"}},"required":["name","id","url"]},"cache":{"type":["array","null"],"items":{"type":"object","properties":{"profile":{"type":"string"},"recordId":{"type":"string"}},"required":["profile","recordId"]},"description":"Maintained by PitchGhost. Do not set."},"enrich":{"type":"boolean"},"syncType":{"type":"string","enum":["notes","task","none"]},"syncOptions":{"type":"object","properties":{"urgency":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"dueDate":{"type":"number","exclusiveMinimum":0,"maximum":31}},"default":{"urgency":"MEDIUM","dueDate":3},"required":["urgency","dueDate"]}},"required":["crm","list","syncType"],"title":"HubSpot"},{"type":"object","properties":{"syncType":{"type":"string","enum":["sequence","task","none"],"default":"none"},"crm":{"type":"string","enum":["apollo"]},"cache":{"type":["array","null"],"items":{"type":"object","properties":{"profile":{"type":"string"},"recordId":{"type":"string"}},"required":["profile","recordId"]},"description":"Maintained by PitchGhost. Do not set."},"list":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"syncOptions":{"type":"object","properties":{"priority":{"type":"string","enum":["low","medium","high"]},"due_at":{"type":["number","null"]},"user_id":{"type":"string"},"type":{"type":"string","enum":["call","outreach_manual_email","linkedin_step_connect","linkedin_step_view_profile","linkedin_step_interact_post","action_item"]},"status":{"type":"string","enum":["scheduled","completed","archived"]},"sequence_id":{"type":"string"},"emailer_campaign_id":{"type":"string"},"send_email_from_email_account_id":{"type":"string"}}}},"required":["crm","list"],"title":"Apollo"},{"type":"object","properties":{"crm":{"type":"string","enum":["salesforce"]},"list":{"type":"object","properties":{"name":{"type":"string"},"id":{"type":"string"},"url":{"type":"string"}},"required":["name","id","url"]},"enrich":{"type":"boolean"},"cache":{"type":["array","null"],"items":{"type":"object","properties":{"profile":{"type":"string"},"recordId":{"type":"string"}},"required":["profile","recordId"]},"description":"Maintained by PitchGhost. Do not set."},"syncType":{"type":"string","enum":["note","task","none"],"default":"none"},"binding":{"type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"company":{"type":"string"},"linkedin_url":{"type":"string"}},"required":["first_name","last_name","company","linkedin_url"]},"syncOptions":{"type":"object","properties":{"activityDate":{"type":["number","null"]},"task_ownerId":{"type":"string"}},"required":["activityDate","task_ownerId"]}},"required":["crm","list","binding"],"title":"Salesforce"},{"type":"object","properties":{"crm":{"type":"string","enum":["intercom"]},"segment":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"enrich":{"type":"boolean"},"binding":{"type":"object","properties":{"linkedin_url":{"type":"string"}}},"cache":{"type":["array","null"],"items":{"type":"object","properties":{"profile":{"type":"string"},"recordId":{"type":"string"}},"required":["profile","recordId"]},"description":"Maintained by PitchGhost. Do not set."},"syncType":{"type":"string","enum":["none","ticket"],"default":"none"},"syncOptions":{"type":"object","properties":{"skip_notification":{"type":"boolean"},"ticket_type_id":{"type":"string"},"ticket_category":{"type":"string","enum":["Back-office","Tracker","Customer"]},"assignee_id":{"type":"string"}}}},"required":["crm","segment","binding"],"title":"Intercom"},{"type":"object","properties":{"crm":{"type":"string","enum":["folk"]},"group":{"type":"object","properties":{"name":{"type":"string"},"id":{"type":"string"}},"required":["name","id"]},"enrich":{"type":"boolean"},"binding":{"type":"object","properties":{"linkedin_url":{"type":"string"}}},"cache":{"type":["array","null"],"items":{"type":"object","properties":{"profile":{"type":"string"},"recordId":{"type":"string"}},"required":["profile","recordId"]},"description":"Maintained by PitchGhost. Do not set."},"syncType":{"type":"string","enum":["none","note","interaction"],"default":"none"},"syncOptions":{"type":"object","properties":{"note_visibility":{"type":"string","enum":["public","private"],"default":"public"},"interaction_type":{"type":"string","enum":["linkedin","call","meeting","message","coffee"],"default":"linkedin"}}}},"required":["crm","group","binding"],"title":"Folk"},{"type":"object","properties":{"crm":{"type":"string","enum":["gohighlevel"]},"tag":{"type":"string"},"binding":{"type":"object","properties":{"linkedin_url":{"type":"string"}}},"cache":{"type":["array","null"],"items":{"type":"object","properties":{"profile":{"type":"string"},"recordId":{"type":"string"}},"required":["profile","recordId"]},"description":"Maintained by PitchGhost. Do not set."},"enrich":{"type":"boolean"},"syncType":{"type":"string","enum":["notes","task","none"],"default":"none"},"syncOptions":{"type":"object","properties":{"assignedTo":{"type":"string"},"dueDate":{"type":"number","exclusiveMinimum":0,"maximum":31}}}},"required":["crm","tag","binding"],"title":"HighLevel"},{"type":"null"}],"default":null,"description":"Monitor the people in a CRM list, segment, group or tag instead of a fixed list. The CRM must already be connected in PitchGhost. `crm` picks the CRM and decides which other fields apply."},"smartSearch":{"type":["object","null"],"properties":{"criteria":{"type":"object","properties":{"locations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"LinkedIn's numeric id for this item.","examples":[103644278]},"name":{"type":"string","description":"The item's display name.","examples":["United States"]}},"required":["id","name"]}},"companies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"LinkedIn's numeric id for this item.","examples":[103644278]},"name":{"type":"string","description":"The item's display name.","examples":["United States"]}},"required":["id","name"]}},"pastCompanies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"LinkedIn's numeric id for this item.","examples":[103644278]},"name":{"type":"string","description":"The item's display name.","examples":["United States"]}},"required":["id","name"]}},"schools":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"LinkedIn's numeric id for this item.","examples":[103644278]},"name":{"type":"string","description":"The item's display name.","examples":["United States"]}},"required":["id","name"]}},"industries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"LinkedIn's numeric id for this item.","examples":[103644278]},"name":{"type":"string","description":"The item's display name.","examples":["United States"]}},"required":["id","name"]}},"services":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"LinkedIn's numeric id for this item.","examples":[103644278]},"name":{"type":"string","description":"The item's display name.","examples":["United States"]}},"required":["id","name"]}},"title":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string","minLength":1,"maxLength":512},"maxItems":30}],"description":"Job titles to match, up to 30.","examples":[["Head of Sales","VP Sales"]]}},"description":"Who to search for. At least one criterion is required."},"refinements":{"type":"object","properties":{"minFollowerCount":{"type":"number","minimum":0},"companyEmployeeMaxCount":{"type":"number","minimum":0},"companyEmployeeMinCount":{"type":"number","minimum":0},"premium":{"type":"boolean"},"verified":{"type":"boolean"}},"description":"Optional extra limits applied to the people the search returns."}},"default":null,"required":["criteria"],"description":"Monitor everyone matching a LinkedIn people search (job titles, companies, locations and so on) instead of a fixed list."},"connectionsSync":{"type":["object","null"],"properties":{"sourceProfile":{"type":"object","properties":{"integrationId":{"type":"string","description":"The `integrationId` of the connected LinkedIn account, from `GET /pitchghost/action-accounts`.","examples":["5d0c2a51-93b7-4f6e-b0a4-8e1f3c7d2a96"]},"vanityId":{"type":"string","description":"The account's LinkedIn vanity name: the last part of its profile URL, linkedin.com/in/<vanityId>.","examples":["dana-whitfield"]},"displayName":{"type":"string","description":"The account owner's name, shown in the app.","examples":["Dana Whitfield"]}},"required":["integrationId","vanityId","displayName"],"description":"The connected LinkedIn account whose connections are monitored."}},"default":null,"required":["sourceProfile"],"description":"Monitor the 1st-degree connections of one of your connected LinkedIn accounts instead of a fixed list."},"filters":{"type":"null","description":"Not used for this Ghost type. Leave out or send null."}},"description":"Who this Ghost monitors. Choose exactly one source: a fixed list in `value`, or one of `smartSync`, `smartSearch` or `connectionsSync`. Only one of those three can be set at a time.","examples":[{"value":"https://www.linkedin.com/in/dana-whitfield\nhttps://www.linkedin.com/in/marcus-oyelaran"},{"smartSearch":{"criteria":{"title":["Head of Sales","VP Sales"],"locations":[{"id":103644278,"name":"United States"}]},"refinements":{"companyEmployeeMinCount":11,"companyEmployeeMaxCount":200}}},{"connectionsSync":{"sourceProfile":{"integrationId":"5d0c2a51-93b7-4f6e-b0a4-8e1f3c7d2a96","vanityId":"dana-whitfield","displayName":"Dana Whitfield"}}}]},"responseTypes":{"type":["object","null"],"properties":{"react":{"type":["boolean","null"],"default":true},"comment":{"type":["boolean","null"],"default":true},"connect":{"type":["boolean","null"],"default":true},"repost":{"type":["boolean","null"],"default":true},"quote":{"type":["boolean","null"],"default":true}},"default":null,"description":"Which suggested response types to generate when `generateResponses` is on. Set a type to false to turn it off; null or omitted means all types.","examples":[{"comment":true,"react":true,"connect":false}]}},"required":["users"],"title":"LinkedIn People"},{"type":"object","properties":{"companies":{"type":"object","properties":{"value":{"type":["string","null"],"default":null,"description":"The company pages to monitor, as one string with one LinkedIn company page URL per line (max 5000). The page's slug, the last part of linkedin.com/company/<slug>, also works.","examples":["https://www.linkedin.com/company/acme-robotics\nnorthwind-traders"]},"filters":{"type":"null","description":"Not used for this Ghost type. Leave out or send null."}}},"responseTypes":{"type":["object","null"],"properties":{"react":{"type":["boolean","null"],"default":true},"comment":{"type":["boolean","null"],"default":true},"connect":{"type":["boolean","null"],"default":true},"repost":{"type":["boolean","null"],"default":true},"quote":{"type":["boolean","null"],"default":true}},"default":null}},"required":["companies"],"title":"LinkedIn Company"}],"description":"Service-specific settings for the Ghost"},"runImmediately":{"type":"boolean","default":false,"description":"Start a scan as soon as the Ghost is created"}},"required":["service","nickname","goal","serviceSettings"],"examples":[{"service":"Reddit","nickname":"CRM switchers","goal":"People who are frustrated with their current CRM and are asking for alternatives or recommendations. Don't show me vendors promoting their own product, job postings, or generic sales advice. I want to engage with these Finds because we sell a CRM for small sales teams and can offer a genuinely helpful recommendation.","threshold":0.7,"frequency":{"value":"1","unit":"days"},"maxFinds":25,"serviceSettings":{"searchQueries":{"queries":[{"value":"\"CRM alternative\" OR \"switching CRMs\"","filters":{}},{"value":"CRM (recommend OR recommendation)","filters":{"subreddits":["sales","smallbusiness"]}}],"global":{"contentType":"post"}},"responseTypes":null,"subSafeResponses":true},"runImmediately":true},{"service":"LinkedIn","nickname":"Sales leaders rethinking their CRM","goal":"Posts from sales and revenue leaders describing problems with their CRM or asking their network what to switch to. Skip posts from CRM vendors and recruiters.","serviceSettings":{"searchQueries":{"queries":[{"value":"CRM (alternative OR switching OR \"moving away\")","filters":{}}],"global":{"posterType":"Person"}},"responseTypes":null},"runImmediately":true},{"service":"Twitter","nickname":"CRM complaints on X","goal":"People venting about their CRM or asking what to use instead. Skip marketing threads and giveaways.","frequency":{"value":"6","unit":"hours"},"serviceSettings":{"searchQueries":{"queries":[{"value":"\"CRM alternative\" OR \"switching CRMs\"","filters":{}}],"global":{"retweets":false}},"onlyTweets":true,"responseTypes":null},"runImmediately":true},{"service":"Facebook","nickname":"CRM recommendations in groups","goal":"Small business owners asking which CRM to use. Skip posts selling CRM consulting.","serviceSettings":{"searchQueries":{"queries":[{"value":"CRM recommendations","filters":{}}],"global":{}},"responseTypes":null},"runImmediately":true},{"service":"LinkedIn_People","nickname":"Target account champions","goal":"Posts from these prospects about sales process, tooling, or team growth that give us a natural reason to start a conversation.","serviceSettings":{"users":{"value":"https://www.linkedin.com/in/dana-whitfield\nhttps://www.linkedin.com/in/marcus-oyelaran"},"responseTypes":null},"runImmediately":true},{"service":"LinkedIn_Company","nickname":"Target account pages","goal":"Company announcements about funding, hiring a sales team, or new offices that signal they may need a CRM.","serviceSettings":{"companies":{"value":"https://www.linkedin.com/company/acme-robotics\nhttps://www.linkedin.com/company/northwind-traders"},"responseTypes":null},"runImmediately":true}]},"DeleteGhostResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","examples":["123e4567-e89b-12d3-a456-426614174000"]},"deleted":{"type":"boolean","enum":[true]},"findsRetained":{"type":"boolean","description":"Whether the Ghost's Finds were kept","examples":[true]}},"required":["id","deleted","findsRetained"]},"SearchEstimateResponse":{"type":"object","properties":{"numResults":{"type":"number","description":"Estimated raw search results over a 7-day window. An estimate, not a guarantee.","examples":[340]},"sampleFindIds":{"type":"array","items":{"type":"string"},"description":"Platform-native IDs of sample results stored.","examples":[["t3_1k2x9ab","t1_mz4q7lp"]]},"samples":{"type":"array","items":{"type":"string"},"description":"Formatted example results, present when includeSamples was true.","examples":[["r/sales, u/pipeline_pat: We outgrew our CRM last quarter. Anyone switched to something lighter and not regretted it?"]]}},"required":["numResults","sampleFindIds"]},"SearchEstimateErrorResponse":{"type":"object","properties":{"error":{"type":"string","description":"Error message"}},"required":["error"]},"PublicSearchEstimateRequest":{"allOf":[{"oneOf":[{"type":"object","properties":{"service":{"type":"string","enum":["Twitter"]},"query":{"type":"object","properties":{"value":{"type":"string","examples":["\"CRM alternative\" OR \"switching CRMs\"","CRM (recommend OR recommendation) -hiring"]},"filters":{"type":["object","null"],"properties":{"images":{"type":["boolean","null"]},"url":{"type":["string","null"],"pattern":"^(?:(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,6})$"},"lang":{"anyOf":[{"type":"string","enum":["aa","ab","ae","af","ak","am","an","ar","as","av","ay","az","ba","be","bg","bi","bm","bn","bo","br","bs","ca","ce","ch","co","cr","cs","cu","cv","cy","da","de","dv","dz","ee","el","en","eo","es","et","eu","fa","ff","fi","fj","fo","fr","fy","ga","gd","gl","gn","gu","gv","ha","he","hi","ho","hr","ht","hu","hy","hz","ia","id","ie","ig","ii","ik","io","is","it","iu","ja","jv","ka","kg","ki","kj","kk","kl","km","kn","ko","kr","ks","ku","kv","kw","ky","la","lb","lg","li","ln","lo","lt","lu","lv","mg","mh","mi","mk","ml","mn","mr","ms","mt","my","na","nb","nd","ne","ng","nl","nn","no","nr","nv","ny","oc","oj","om","or","os","pa","pi","pl","ps","pt","qu","rm","rn","ro","ru","rw","sa","sc","sd","se","sg","si","sk","sl","sm","sn","so","sq","sr","ss","st","su","sv","sw","ta","te","tg","th","ti","tk","tl","tn","to","tr","ts","tt","tw","ty","ug","uk","ur","uz","ve","vi","vo","wa","wo","xh","yi","yo","za","zh","zu"]},{"type":"array","items":{"type":"string","enum":["aa","ab","ae","af","ak","am","an","ar","as","av","ay","az","ba","be","bg","bi","bm","bn","bo","br","bs","ca","ce","ch","co","cr","cs","cu","cv","cy","da","de","dv","dz","ee","el","en","eo","es","et","eu","fa","ff","fi","fj","fo","fr","fy","ga","gd","gl","gn","gu","gv","ha","he","hi","ho","hr","ht","hu","hy","hz","ia","id","ie","ig","ii","ik","io","is","it","iu","ja","jv","ka","kg","ki","kj","kk","kl","km","kn","ko","kr","ks","ku","kv","kw","ky","la","lb","lg","li","ln","lo","lt","lu","lv","mg","mh","mi","mk","ml","mn","mr","ms","mt","my","na","nb","nd","ne","ng","nl","nn","no","nr","nv","ny","oc","oj","om","or","os","pa","pi","pl","ps","pt","qu","rm","rn","ro","ru","rw","sa","sc","sd","se","sg","si","sk","sl","sm","sn","so","sq","sr","ss","st","su","sv","sw","ta","te","tg","th","ti","tk","tl","tn","to","tr","ts","tt","tw","ty","ug","uk","ur","uz","ve","vi","vo","wa","wo","xh","yi","yo","za","zh","zu"]}},{"type":"null"}]},"from":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"replyingTo":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"mentioning":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"verified":{"type":["boolean","null"]},"near":{"type":["object","null"],"properties":{"country":{"type":["string","null"]},"state":{"type":["string","null"]},"city":{"type":["string","null"]}},"required":["country","state","city"]},"retweets":{"type":["boolean","null"]},"replies":{"type":["boolean","null"]},"quotes":{"type":["boolean","null"]},"hashtags":{"type":["boolean","null"]},"news":{"type":["boolean","null"]},"sfw":{"type":["boolean","null"]},"videos":{"type":["boolean","null"]},"links":{"type":["boolean","null"]},"place":{"anyOf":[{"type":"string","enum":["96683cc9126741d1","7142eb97ae21e839","4ec01c9dbc693497","463f5d9615d7d1be","fbd6d2f5a4e4a15e","e8ad2641c1cb666c","e0060cda70f5f341","de599025180e2ee7","65b4760a2b411e11","94965b2c45386f87","25530ba03b7d90c6","f54a2170ff4b15f7","3376992a082d67c7","30410557050f13a5","4e7c21fd2af027c6","f3bfc7dcc928977f","ecdce75d48b13b64","d9074951d5976bdf","c799e2d3a79f810e","81b8dcbe189773f2","78bfaf3f12c05982","ea679934779f45c7","8198e85105936d3c","879d7cfc66c9c290","6b5d375c346e3be9","c29833e68a86e703","82b141af443cb1b8","2ee7eeaa84dbe65a","1ef1183ed7056dc1","e7c97cdfef3a741a","e222580e9a58b499","d0e642e8a900f679","d5cde4dddd7e6f94","a9928b6eaeb54f86","34ed2e67dd5a22bb","58f54743b1a62911","8d65596349ee2e01","f7531639e8db5e12","f0af1239cbebb474","1d834adff5d584df","6416b8512febefc9","1b107df3ccc0aaa1","4d3b316fe2e52b29","3b98b02fba3f9753","47a3cf27863714de","3f14ce28dc7c4566","06ef846bfc783874","0b039ce18ddf1cb9","c00e5392b3fa46fb","173c2bb9d42baaa5","2edb6e240797c549","0639360bd49a15e3","288de3df481163e8"]},{"type":"array","items":{"type":"string","enum":["96683cc9126741d1","7142eb97ae21e839","4ec01c9dbc693497","463f5d9615d7d1be","fbd6d2f5a4e4a15e","e8ad2641c1cb666c","e0060cda70f5f341","de599025180e2ee7","65b4760a2b411e11","94965b2c45386f87","25530ba03b7d90c6","f54a2170ff4b15f7","3376992a082d67c7","30410557050f13a5","4e7c21fd2af027c6","f3bfc7dcc928977f","ecdce75d48b13b64","d9074951d5976bdf","c799e2d3a79f810e","81b8dcbe189773f2","78bfaf3f12c05982","ea679934779f45c7","8198e85105936d3c","879d7cfc66c9c290","6b5d375c346e3be9","c29833e68a86e703","82b141af443cb1b8","2ee7eeaa84dbe65a","1ef1183ed7056dc1","e7c97cdfef3a741a","e222580e9a58b499","d0e642e8a900f679","d5cde4dddd7e6f94","a9928b6eaeb54f86","34ed2e67dd5a22bb","58f54743b1a62911","8d65596349ee2e01","f7531639e8db5e12","f0af1239cbebb474","1d834adff5d584df","6416b8512febefc9","1b107df3ccc0aaa1","4d3b316fe2e52b29","3b98b02fba3f9753","47a3cf27863714de","3f14ce28dc7c4566","06ef846bfc783874","0b039ce18ddf1cb9","c00e5392b3fa46fb","173c2bb9d42baaa5","2edb6e240797c549","0639360bd49a15e3","288de3df481163e8"]}},{"type":"null"}]},"tags":{"type":["boolean","null"]},"minFollowers":{"type":["number","null"]},"minFollowing":{"type":["number","null"]},"minTweets":{"type":["number","null"]},"canDM":{"type":["boolean","null"]}},"default":{}}},"required":["value"]}},"required":["service","query"],"title":"Twitter"},{"type":"object","properties":{"service":{"type":"string","enum":["LinkedIn"]},"query":{"type":"object","properties":{"value":{"type":"string","examples":["CRM (alternative OR switching OR \"moving away\")","\"sales team\" \"new CRM\""]},"filters":{"type":["object","null"],"properties":{"hasImage":{"type":["boolean","null"]},"hasVideo":{"type":["boolean","null"]},"hasHashtags":{"type":["boolean","null"]},"hasLink":{"type":["boolean","null"]},"hasDocument":{"type":["boolean","null"]},"posterType":{"type":["string","null"],"enum":["Person","Company",null]},"isJobPosting":{"type":["boolean","null"]},"isQuoting":{"type":["boolean","null"]},"isCelebration":{"type":["boolean","null"]},"permission.canReact":{"type":["boolean","null"]},"permission.canComment":{"type":["boolean","null"]},"permission.canMessage":{"type":["boolean","null"]},"permission.canShare":{"type":["boolean","null"]},"profile.industry":{"anyOf":[{"type":"string","enum":["1","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115","116","117","118","119","120","121","122","123","124","125","126","127","128","129","130","131","132","133","134","135","136","137","138","139","140","141","142","143","145","146","147","148","150","201","256","298","332","341","345","356","382","383","384","385","386","387","388","389","390","397","398","400","404","406","408","413","419","428","431","435","436","453","460","481","495","504","529","562","564","598","615","616","622","625","679","690","703","709","722","727","743","773","779","784","794","799","840","849","861","871","873","876","883","887","901","923","928","935","964","973","983","994","998","1005","1029","1042","1080","1090","1095","1128","1137","1153","1157","1166","1171","1178","1187","1206","1208","1212","1221","1222","1230","1231","1250","1257","1262","1267","1285","1292","1309","1319","1324","1339","1359","1370","1407","1409","1423","1424","1431","1445","1481","1495","1497","1504","1505","1512","1517","1520","1532","1573","1594","1600","1602","1611","1623","1625","1633","1641","1644","1649","1673","1678","1696","1713","1720","1725","1737","1738","1742","1743","1745","1750","1757","1759","1770","1779","1786","1798","1810","1855","1862","1905","1909","1911","1912","1916","1923","1925","1931","1938","1956","1958","1965","1981","1986","1999","2012","2018","2019","2020","2025","2027","2029","2040","2045","2048","2050","2054","2060","2063","2069","2074","2077","2081","2091","2112","2122","2125","2128","2130","2133","2135","2139","2142","2143","2159","2161","2163","2167","2179","2181","2194","2197","2212","2214","2217","2226","2240","2247","2253","2255","2258","2259","2272","2282","2318","2353","2358","2366","2369","2374","2375","2391","2401","2458","2468","2489","2500","2934","3065","3068","3070","3081","3085","3086","3089","3095","3096","3099","3100","3101","3102","3103","3104","3105","3106","3107","3124","3125","3126","3127","3128","3129","3130","3131","3132","3133","3134","3186","3240","3241","3242","3243","3244","3245","3246","3247","3248","3249","3250","3251","3252","3253","3254","3255","3256"]},{"type":"array","items":{"type":"string","enum":["1","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115","116","117","118","119","120","121","122","123","124","125","126","127","128","129","130","131","132","133","134","135","136","137","138","139","140","141","142","143","145","146","147","148","150","201","256","298","332","341","345","356","382","383","384","385","386","387","388","389","390","397","398","400","404","406","408","413","419","428","431","435","436","453","460","481","495","504","529","562","564","598","615","616","622","625","679","690","703","709","722","727","743","773","779","784","794","799","840","849","861","871","873","876","883","887","901","923","928","935","964","973","983","994","998","1005","1029","1042","1080","1090","1095","1128","1137","1153","1157","1166","1171","1178","1187","1206","1208","1212","1221","1222","1230","1231","1250","1257","1262","1267","1285","1292","1309","1319","1324","1339","1359","1370","1407","1409","1423","1424","1431","1445","1481","1495","1497","1504","1505","1512","1517","1520","1532","1573","1594","1600","1602","1611","1623","1625","1633","1641","1644","1649","1673","1678","1696","1713","1720","1725","1737","1738","1742","1743","1745","1750","1757","1759","1770","1779","1786","1798","1810","1855","1862","1905","1909","1911","1912","1916","1923","1925","1931","1938","1956","1958","1965","1981","1986","1999","2012","2018","2019","2020","2025","2027","2029","2040","2045","2048","2050","2054","2060","2063","2069","2074","2077","2081","2091","2112","2122","2125","2128","2130","2133","2135","2139","2142","2143","2159","2161","2163","2167","2179","2181","2194","2197","2212","2214","2217","2226","2240","2247","2253","2255","2258","2259","2272","2282","2318","2353","2358","2366","2369","2374","2375","2391","2401","2458","2468","2489","2500","2934","3065","3068","3070","3081","3085","3086","3089","3095","3096","3099","3100","3101","3102","3103","3104","3105","3106","3107","3124","3125","3126","3127","3128","3129","3130","3131","3132","3133","3134","3186","3240","3241","3242","3243","3244","3245","3246","3247","3248","3249","3250","3251","3252","3253","3254","3255","3256"]}},{"type":"null"}]},"profile.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"profile.minFollowerCount":{"type":["number","null"]},"company.minFollowerCount":{"type":["number","null"]},"profile.title":{"type":["string","null"]},"profile.currentPosition.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"profile.currentPosition.hasJob":{"type":["boolean","null"]},"profile.currentPosition.minEmployeeCount":{"type":["number","null"]},"profile.currentPosition.maxEmployeeCount":{"type":["number","null"]},"company.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"company.companyAge":{"type":["number","null"]},"company.companySize":{"type":["number","null"]},"company.contactInfo.hasWebsite":{"type":["boolean","null"]},"company.contactInfo.hasPhoneNumber":{"type":["boolean","null"]},"company.companyType":{"type":["string","null"],"enum":["PROFIT","NON_PROFIT",null]}},"default":{}}},"required":["value"]}},"required":["service","query"],"title":"LinkedIn"},{"type":"object","properties":{"service":{"type":"string","enum":["Reddit"]},"query":{"type":"object","properties":{"value":{"type":"string","examples":["\"CRM alternative\" OR \"switching CRMs\"","CRM (recommend OR recommendation)"]},"filters":{"type":["object","null"],"properties":{"subreddits":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"excludeSubreddits":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"canReply":{"type":["boolean","null"]},"hasMedia":{"type":["boolean","null"]},"canCrosspost":{"type":["boolean","null"]},"containsSpoilers":{"type":["boolean","null"]},"containsLinks":{"type":["boolean","null"]},"subType":{"type":["string","null"],"enum":["public","restricted",null]},"contentType":{"type":["string","null"],"enum":["post","comment",null]},"lang":{"type":["string","null"],"enum":["French","Italian","Spanish","English","German","Chinese","Japanese","Russian","Arabic","Hebrew","Polish","Hindi","Urdu","Portuguese","Thai","Turkish","Ukrainian","Vietnamese","Greek","Malay","Korean","Bengali","Irish","Punjabi","Swedish","Welsh","Armenian","Danish","Dutch","Estonian","Finnish",null]},"sentiment":{"type":["string","null"],"enum":["positive","negative","neutral",null]},"users":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"minSubSize":{"type":["number","null"]},"domains":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"minUserKarma":{"type":["number","null"]},"minUserAccountAge":{"type":["number","null"]}},"default":{}}},"required":["value"]}},"required":["service","query"],"title":"Reddit"},{"type":"object","properties":{"service":{"type":"string","enum":["Facebook"]},"query":{"type":"object","properties":{"value":{"type":"string","examples":["CRM recommendations","switching CRM"]},"filters":{"type":["object","null"],"properties":{"lang":{"type":["string","null"],"enum":["fr","it","es","en","de","zh","ja","ru","ar","he","pl","hi","ur","pt","th","tr","uk","vi","el","ms","ko","bn","ga","pa","sv","cy","hy","da","nl","et","fi",null]},"hasHashtags":{"type":["boolean","null"]},"hasLinks":{"type":["boolean","null"]},"location":{"type":["string","null"],"enum":["107991659233606","106224666074625","106003956105810","108659242498155","111762725508574","114586701886732","115963528414384","108081209214649","110970792260960","110148382341970","106300959405546","106338002735968","106220079409935","111822758834362","104028629632792","113998391943532","105745629459139","105775436121898","108424279189115","112305682116972","112887355389124","103111876395954","109570449061083","108056275889020","104019619634224","103990676304130","109260602433140","109297442421359","107705532592043","106066949424984","103787786326610","110941395597405","114497808567786","102184499823699","111983945494775","106262189412553","115167478498675","105959272778333","109870912368806","105634782802493","115976748413086","112662855415315","108489419175297","108108762549844","109493702409366","110185085668702","105559566144042","109412232411040","109375499081852","110893392264912","105675929465006","106057819434480","109307099087536","105479049486624","105496622817769","101881036520836","105540216147364","112548152092705","105988062765295","110714572282163","110184922344060","110884905606108","116190411724975","102146663160831","110843418940484","109692899057899","107674002595670","109486839070556","103728359665916","106078429431815","114629675219759","113564935326488","108299645860446","104029736299647","115753025103602","105653082800923","114469421897671","103145123058362","103123839728353","108285455858477","104034969634202",null]}},"default":{}}},"required":["value"]}},"required":["service","query"],"title":"Facebook"}]},{"type":"object","properties":{"includeSamples":{"type":"boolean","default":false,"description":"Include formatted example results in the response.","examples":[true]}}}],"examples":[{"service":"Reddit","query":{"value":"\"CRM alternative\" OR \"switching CRMs\"","filters":{"subreddits":["sales","smallbusiness"]}},"includeSamples":true},{"service":"LinkedIn","query":{"value":"CRM (alternative OR switching OR \"moving away\")","filters":{"posterType":"Person"}}},{"service":"Twitter","query":{"value":"\"CRM alternative\" OR \"switching CRMs\""}},{"service":"Facebook","query":{"value":"CRM recommendations"}}]},"ActionAccountsResponse":{"type":"object","properties":{"accounts":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"integrationService":{"type":"string","enum":["linkedin"]},"accountType":{"type":"string","enum":["PERSONAL","COMPANY"]},"integrationId":{"type":"string","description":"PitchGhost internal ID for this integration record","examples":["5d0c2a51-93b7-4f6e-b0a4-8e1f3c7d2a96"]},"accountId":{"type":"string","description":"Integration service specific account ID","examples":["ACoAABx4k2MB7gq1n0ZfTt3yYw"]},"displayName":{"type":"string","examples":["Dana Whitfield"]},"handle":{"type":["string","null"],"description":"Username or handle where applicable","examples":["dana-whitfield"]},"profilePictureUrl":{"type":["string","null"],"examples":["https://media.licdn.com/dms/image/v2/D4E03AQF/profile-displayphoto-shrink_200_200/0/1716400000000"]},"status":{"type":"string","enum":["valid","expired","invalid"],"description":"Whether this account is valid and can be used for actions","examples":["valid"]},"access":{"type":"string","enum":["company","restricted"],"description":"Who can act with this account. 'company': every member and every API key. 'restricted': only the members and API keys its linker has allowed.","examples":["company"]},"linkedBy":{"type":"string","format":"uuid","description":"The team member who linked this account","examples":["7c9e6679-7425-40de-944b-e07fc1f90ae7"]},"linkedByName":{"type":["string","null"],"description":"Name of the team member who linked this account","examples":["Dana Whitfield"]},"usableByThisKey":{"type":"boolean","examples":[true],"description":"Whether this API key can take actions with the account: it is shared with the whole company (`access: 'company'`), or the member who linked it allowed this key."}},"required":["integrationService","accountType","integrationId","accountId","displayName","handle","profilePictureUrl","status","access","linkedBy","linkedByName","usableByThisKey"],"title":"LinkedIn"},{"type":"object","properties":{"integrationService":{"type":"string","enum":["twitter"]},"integrationId":{"type":"string","description":"PitchGhost internal ID for this integration record","examples":["5d0c2a51-93b7-4f6e-b0a4-8e1f3c7d2a96"]},"accountId":{"type":"string","description":"Integration service specific account ID","examples":["ACoAABx4k2MB7gq1n0ZfTt3yYw"]},"displayName":{"type":"string","examples":["Dana Whitfield"]},"handle":{"type":["string","null"],"description":"Username or handle where applicable","examples":["dana-whitfield"]},"profilePictureUrl":{"type":["string","null"],"examples":["https://media.licdn.com/dms/image/v2/D4E03AQF/profile-displayphoto-shrink_200_200/0/1716400000000"]},"status":{"type":"string","enum":["valid","expired","invalid"],"description":"Whether this account is valid and can be used for actions","examples":["valid"]},"access":{"type":"string","enum":["company","restricted"],"description":"Who can act with this account. 'company': every member and every API key. 'restricted': only the members and API keys its linker has allowed.","examples":["company"]},"linkedBy":{"type":"string","format":"uuid","description":"The team member who linked this account","examples":["7c9e6679-7425-40de-944b-e07fc1f90ae7"]},"linkedByName":{"type":["string","null"],"description":"Name of the team member who linked this account","examples":["Dana Whitfield"]},"usableByThisKey":{"type":"boolean","examples":[true],"description":"Whether this API key can take actions with the account: it is shared with the whole company (`access: 'company'`), or the member who linked it allowed this key."}},"required":["integrationService","integrationId","accountId","displayName","handle","profilePictureUrl","status","access","linkedBy","linkedByName","usableByThisKey"],"title":"Twitter"},{"type":"object","properties":{"integrationService":{"type":"string","enum":["reddit"]},"integrationId":{"type":"string","description":"PitchGhost internal ID for this integration record","examples":["5d0c2a51-93b7-4f6e-b0a4-8e1f3c7d2a96"]},"accountId":{"type":"string","description":"Integration service specific account ID","examples":["ACoAABx4k2MB7gq1n0ZfTt3yYw"]},"displayName":{"type":"string","examples":["Dana Whitfield"]},"handle":{"type":["string","null"],"description":"Username or handle where applicable","examples":["dana-whitfield"]},"profilePictureUrl":{"type":["string","null"],"examples":["https://media.licdn.com/dms/image/v2/D4E03AQF/profile-displayphoto-shrink_200_200/0/1716400000000"]},"status":{"type":"string","enum":["valid","expired","invalid"],"description":"Whether this account is valid and can be used for actions","examples":["valid"]},"access":{"type":"string","enum":["company","restricted"],"description":"Who can act with this account. 'company': every member and every API key. 'restricted': only the members and API keys its linker has allowed.","examples":["company"]},"linkedBy":{"type":"string","format":"uuid","description":"The team member who linked this account","examples":["7c9e6679-7425-40de-944b-e07fc1f90ae7"]},"linkedByName":{"type":["string","null"],"description":"Name of the team member who linked this account","examples":["Dana Whitfield"]},"usableByThisKey":{"type":"boolean","examples":[true],"description":"Whether this API key can take actions with the account: it is shared with the whole company (`access: 'company'`), or the member who linked it allowed this key."}},"required":["integrationService","integrationId","accountId","displayName","handle","profilePictureUrl","status","access","linkedBy","linkedByName","usableByThisKey"],"title":"Reddit"}]},"description":"Connected accounts, newest first. `integrationId` is the `accountId` to pass when taking an action."},"total":{"type":"integer","examples":[3]}},"required":["accounts","total"]},"ActionsResponse":{"type":"object","properties":{"actions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","examples":["0b6f1c1e-4a8d-4c53-9d1e-2f6a7c0c9b11"]},"status":{"type":"string","enum":["not_taken","taken","rate_limited","queued","failed"],"examples":["queued"]},"service":{"type":"string","enum":["Twitter","LinkedIn","Reddit","Facebook","LinkedIn_People","LinkedIn_Company"],"examples":["LinkedIn"]},"action":{"type":["string","null"],"description":"Human-readable action verb (e.g. \"Comment\"); null when unparseable.","examples":["Comment"]},"content":{"type":["string","null"],"description":"The text content, for text actions.","examples":["We moved off a heavyweight CRM last year for the same reason. Happy to share what we compared if useful."]},"account":{"oneOf":[{"type":"object","properties":{"accountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"type":"string"},"avatarUrl":{"type":["string","null"]},"externalAccountId":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["Twitter"]},"verified":{"type":"boolean"},"subscriptionType":{"type":"string"}},"required":["accountId","displayName","handle","avatarUrl","platform","verified"],"title":"Twitter"},{"type":"object","properties":{"accountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"type":"string"},"avatarUrl":{"type":["string","null"]},"externalAccountId":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["LinkedIn"]},"accountType":{"type":"string","enum":["PERSONAL","COMPANY"]},"profileId":{"type":["string","null"]},"premiumSubscriber":{"type":"boolean"},"role":{"type":"string","enum":["SUPER_ADMINISTRATOR","CONTENT_ADMINISTRATOR","ANALYST","DIRECT_SPONSORED_CONTENT_POSTER","LEAD_GEN_FORMS_MANAGER","LEAD_CAPTURE_ADMINISTRATOR"]}},"required":["accountId","displayName","handle","avatarUrl","platform","accountType","profileId"],"title":"LinkedIn"},{"type":"object","properties":{"accountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"type":"string"},"avatarUrl":{"type":["string","null"]},"externalAccountId":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["Reddit"]}},"required":["accountId","displayName","handle","avatarUrl","platform"],"title":"Reddit"},{"type":"object","properties":{"accountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"type":["string","null"]},"avatarUrl":{"type":["string","null"]},"externalAccountId":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["Facebook"]}},"required":["accountId","displayName","handle","avatarUrl","platform"],"title":"Facebook"},{"type":"null"}],"description":"The canonical acting-account snapshot (accountId can be passed back as an `accounts` filter); null when we could not parse it."},"takenBy":{"type":["object","null"],"properties":{"uid":{"type":"string","format":"uuid","examples":["7c9e6679-7425-40de-944b-e07fc1f90ae7"]},"fullName":{"type":["string","null"],"examples":["Dana Whitfield"]}},"required":["uid","fullName"],"description":"The team member who queued or took the action."},"findId":{"type":"string","description":"The linked Find.","examples":["3f2b8c9a-1d47-4e0b-8a55-6c1d2e9f7a40"]},"findText":{"type":["string","null"],"description":"Short snippet of the linked Find content.","examples":["We outgrew our CRM last quarter. Anyone switched to something lighter?"]},"createdAt":{"type":"string","examples":["2026-10-02T14:05:11Z"]},"actionDate":{"type":["string","null"],"description":"When the action was taken; null while queued.","examples":["2026-10-02T14:21:40Z"]},"error":{"type":["string","null"],"description":"The failure message, for failed actions.","examples":["Comments are turned off on this post"]},"attempts":{"type":["number","null"],"description":"Delivery attempts so far, for queued actions.","examples":[1]},"nextAttempt":{"type":["string","null"],"format":"date-time","description":"When a queued action is next eligible to run (pushed back by rate limits).","examples":["2026-10-02T14:20:00Z"]},"holdReason":{"type":["string","null"],"enum":["rate_limited","retry",null],"description":"Why a queued action is waiting past normal spacing: a platform rate limit or a retry after a temporary error. Null when it is simply next in line."}},"required":["id","status","service","action","content","account","takenBy","findId","findText","createdAt","actionDate","error","attempts","nextAttempt","holdReason"]}},"pagination":{"type":"object","properties":{"page":{"type":"integer","description":"Current page number","example":1},"limit":{"type":"integer","description":"Items per page","example":50},"total":{"type":"integer","description":"Total number of items across all pages","example":150},"total_pages":{"type":"integer","description":"Total number of pages","example":3}},"required":["page","limit","total","total_pages"]}},"required":["actions","pagination"]},"FindActionsResponse":{"type":"object","properties":{"findId":{"type":"string","format":"uuid","examples":["3f2b8c9a-1d47-4e0b-8a55-6c1d2e9f7a40"]},"pending":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","examples":["0b6f1c1e-4a8d-4c53-9d1e-2f6a7c0c9b11"]},"action":{"anyOf":[{"type":["object","null"],"properties":{"action":{"type":"string","enum":["like","reply","retweet","follow","dm","quote"]},"content":{"type":["string","null"],"default":null},"account":{"anyOf":[{"type":"object","properties":{"accountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"type":"string"},"avatarUrl":{"type":["string","null"]},"externalAccountId":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["Twitter"]},"verified":{"type":"boolean"},"subscriptionType":{"type":"string"}},"required":["accountId","displayName","handle","avatarUrl","platform","verified"],"title":"Current"},{"type":"object","properties":{"accountId":{"type":"string"},"name":{"type":"string"},"screen_name":{"type":"string"},"avatar_image_url":{"type":"string","format":"uri"},"is_verified":{"type":"boolean"},"subscription_type":{"type":"string"},"external_account_id":{"type":"string","format":"uuid"}},"required":["accountId","name","screen_name","avatar_image_url","is_verified"],"deprecated":true,"title":"Legacy"},{"type":"null"}],"default":null},"result":{"type":["object","null"],"properties":{"externalId":{"type":"string"},"url":{"type":["string","null"]},"recordedAt":{"type":"string","format":"date-time"}},"default":null,"required":["externalId","url","recordedAt"]}},"default":null,"required":["action"],"title":"Twitter"},{"type":["object","null"],"properties":{"action":{"type":"string","enum":["react","comment","connect","repost","quote"]},"content":{"type":["string","null"],"default":null},"reactionType":{"type":["string","null"],"enum":["like","celebration","support","love","insightful","funny",null],"default":null},"account":{"anyOf":[{"type":"object","properties":{"accountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"type":"string"},"avatarUrl":{"type":["string","null"]},"externalAccountId":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["LinkedIn"]},"accountType":{"type":"string","enum":["PERSONAL","COMPANY"]},"profileId":{"type":["string","null"]},"premiumSubscriber":{"type":"boolean"},"role":{"type":"string","enum":["SUPER_ADMINISTRATOR","CONTENT_ADMINISTRATOR","ANALYST","DIRECT_SPONSORED_CONTENT_POSTER","LEAD_GEN_FORMS_MANAGER","LEAD_CAPTURE_ADMINISTRATOR"]}},"required":["accountId","displayName","handle","avatarUrl","platform","accountType","profileId"],"title":"Current"},{"oneOf":[{"type":"object","properties":{"accountType":{"type":"string","enum":["PERSONAL"]},"profileId":{"type":"string"},"accountId":{"type":["string","null"]},"firstName":{"type":"string"},"lastName":{"type":"string"},"profilePicture":{"type":["string","null"]},"premiumSubscriber":{"type":"boolean"},"publicIdentifier":{"type":"string"}},"required":["accountType","profileId","firstName","lastName","profilePicture","premiumSubscriber","publicIdentifier"],"title":"Personal"},{"type":"object","properties":{"accountType":{"type":"string","enum":["COMPANY"]},"universalName":{"type":"string"},"name":{"type":"string"},"accountId":{"type":"string"},"logoUrl":{"type":["string","null"]},"role":{"type":"string","enum":["SUPER_ADMINISTRATOR","CONTENT_ADMINISTRATOR","ANALYST","DIRECT_SPONSORED_CONTENT_POSTER","LEAD_GEN_FORMS_MANAGER","LEAD_CAPTURE_ADMINISTRATOR"]}},"required":["accountType","universalName","name","accountId","logoUrl","role"],"title":"Company"}],"deprecated":true,"title":"Legacy"},{"type":"null"}],"default":null},"result":{"type":["object","null"],"properties":{"externalId":{"type":"string"},"url":{"type":["string","null"]},"recordedAt":{"type":"string","format":"date-time"}},"default":null,"required":["externalId","url","recordedAt"]}},"default":null,"required":["action"],"title":"LinkedIn"},{"type":["object","null"],"properties":{"action":{"type":"string","enum":["upvote","downvote","comment","message"]},"content":{"type":["string","null"],"default":null},"subject":{"type":["string","null"],"default":null},"account":{"anyOf":[{"type":"object","properties":{"accountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"type":"string"},"avatarUrl":{"type":["string","null"]},"externalAccountId":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["Reddit"]}},"required":["accountId","displayName","handle","avatarUrl","platform"],"title":"Current"},{"type":"object","properties":{"account_info":{"type":"object","properties":{"id":{"type":"string"},"username":{"type":"string"},"profile_img":{"type":"string"}},"required":["id","username","profile_img"]},"id":{"type":"string"}},"required":["account_info","id"],"deprecated":true,"title":"Legacy"},{"type":"null"}],"default":null},"safetyOverride":{"type":["boolean","null"],"default":false},"result":{"type":["object","null"],"properties":{"externalId":{"type":"string"},"url":{"type":["string","null"]},"recordedAt":{"type":"string","format":"date-time"}},"default":null,"required":["externalId","url","recordedAt"]}},"default":null,"required":["action"],"title":"Reddit"},{"type":["object","null"],"properties":{"action":{"type":"string","enum":["upvote","comment","message"]},"content":{"type":["string","null"],"default":null},"account":{"type":["object","null"],"properties":{"accountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"type":["string","null"]},"avatarUrl":{"type":["string","null"]},"externalAccountId":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["Facebook"]}},"default":null,"required":["accountId","displayName","handle","avatarUrl","platform"]},"result":{"type":["object","null"],"properties":{"externalId":{"type":"string"},"url":{"type":["string","null"]},"recordedAt":{"type":"string","format":"date-time"}},"default":null,"required":["externalId","url","recordedAt"]}},"default":null,"required":["action"],"title":"Facebook"},{"type":"null"}]},"actionDate":{"type":["string","null"],"examples":["2026-10-02T14:21:40Z"]},"createdAt":{"type":"string","examples":["2026-10-02T14:05:11Z"]},"updatedAt":{"type":"string","examples":["2026-10-02T14:21:40Z"]},"manuallyRecorded":{"type":"boolean"},"status":{"type":"string","enum":["not_taken","taken","rate_limited","queued","failed"],"examples":["not_taken"]},"error":{"type":["string","null"],"description":"Why the action failed, for failed actions.","examples":["Comments are turned off on this post"]},"takenBy":{"type":["string","null"],"format":"uuid","examples":["7c9e6679-7425-40de-944b-e07fc1f90ae7"]}},"required":["id","actionDate","createdAt","updatedAt","manuallyRecorded","status","error","takenBy"]},"description":"Suggested actions not yet taken, oldest first. Take one by passing its `id` as `findActionId`."},"queued":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","examples":["0b6f1c1e-4a8d-4c53-9d1e-2f6a7c0c9b11"]},"action":{"anyOf":[{"type":["object","null"],"properties":{"action":{"type":"string","enum":["like","reply","retweet","follow","dm","quote"]},"content":{"type":["string","null"],"default":null},"account":{"anyOf":[{"type":"object","properties":{"accountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"type":"string"},"avatarUrl":{"type":["string","null"]},"externalAccountId":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["Twitter"]},"verified":{"type":"boolean"},"subscriptionType":{"type":"string"}},"required":["accountId","displayName","handle","avatarUrl","platform","verified"],"title":"Current"},{"type":"object","properties":{"accountId":{"type":"string"},"name":{"type":"string"},"screen_name":{"type":"string"},"avatar_image_url":{"type":"string","format":"uri"},"is_verified":{"type":"boolean"},"subscription_type":{"type":"string"},"external_account_id":{"type":"string","format":"uuid"}},"required":["accountId","name","screen_name","avatar_image_url","is_verified"],"deprecated":true,"title":"Legacy"},{"type":"null"}],"default":null},"result":{"type":["object","null"],"properties":{"externalId":{"type":"string"},"url":{"type":["string","null"]},"recordedAt":{"type":"string","format":"date-time"}},"default":null,"required":["externalId","url","recordedAt"]}},"default":null,"required":["action"],"title":"Twitter"},{"type":["object","null"],"properties":{"action":{"type":"string","enum":["react","comment","connect","repost","quote"]},"content":{"type":["string","null"],"default":null},"reactionType":{"type":["string","null"],"enum":["like","celebration","support","love","insightful","funny",null],"default":null},"account":{"anyOf":[{"type":"object","properties":{"accountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"type":"string"},"avatarUrl":{"type":["string","null"]},"externalAccountId":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["LinkedIn"]},"accountType":{"type":"string","enum":["PERSONAL","COMPANY"]},"profileId":{"type":["string","null"]},"premiumSubscriber":{"type":"boolean"},"role":{"type":"string","enum":["SUPER_ADMINISTRATOR","CONTENT_ADMINISTRATOR","ANALYST","DIRECT_SPONSORED_CONTENT_POSTER","LEAD_GEN_FORMS_MANAGER","LEAD_CAPTURE_ADMINISTRATOR"]}},"required":["accountId","displayName","handle","avatarUrl","platform","accountType","profileId"],"title":"Current"},{"oneOf":[{"type":"object","properties":{"accountType":{"type":"string","enum":["PERSONAL"]},"profileId":{"type":"string"},"accountId":{"type":["string","null"]},"firstName":{"type":"string"},"lastName":{"type":"string"},"profilePicture":{"type":["string","null"]},"premiumSubscriber":{"type":"boolean"},"publicIdentifier":{"type":"string"}},"required":["accountType","profileId","firstName","lastName","profilePicture","premiumSubscriber","publicIdentifier"],"title":"Personal"},{"type":"object","properties":{"accountType":{"type":"string","enum":["COMPANY"]},"universalName":{"type":"string"},"name":{"type":"string"},"accountId":{"type":"string"},"logoUrl":{"type":["string","null"]},"role":{"type":"string","enum":["SUPER_ADMINISTRATOR","CONTENT_ADMINISTRATOR","ANALYST","DIRECT_SPONSORED_CONTENT_POSTER","LEAD_GEN_FORMS_MANAGER","LEAD_CAPTURE_ADMINISTRATOR"]}},"required":["accountType","universalName","name","accountId","logoUrl","role"],"title":"Company"}],"deprecated":true,"title":"Legacy"},{"type":"null"}],"default":null},"result":{"type":["object","null"],"properties":{"externalId":{"type":"string"},"url":{"type":["string","null"]},"recordedAt":{"type":"string","format":"date-time"}},"default":null,"required":["externalId","url","recordedAt"]}},"default":null,"required":["action"],"title":"LinkedIn"},{"type":["object","null"],"properties":{"action":{"type":"string","enum":["upvote","downvote","comment","message"]},"content":{"type":["string","null"],"default":null},"subject":{"type":["string","null"],"default":null},"account":{"anyOf":[{"type":"object","properties":{"accountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"type":"string"},"avatarUrl":{"type":["string","null"]},"externalAccountId":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["Reddit"]}},"required":["accountId","displayName","handle","avatarUrl","platform"],"title":"Current"},{"type":"object","properties":{"account_info":{"type":"object","properties":{"id":{"type":"string"},"username":{"type":"string"},"profile_img":{"type":"string"}},"required":["id","username","profile_img"]},"id":{"type":"string"}},"required":["account_info","id"],"deprecated":true,"title":"Legacy"},{"type":"null"}],"default":null},"safetyOverride":{"type":["boolean","null"],"default":false},"result":{"type":["object","null"],"properties":{"externalId":{"type":"string"},"url":{"type":["string","null"]},"recordedAt":{"type":"string","format":"date-time"}},"default":null,"required":["externalId","url","recordedAt"]}},"default":null,"required":["action"],"title":"Reddit"},{"type":["object","null"],"properties":{"action":{"type":"string","enum":["upvote","comment","message"]},"content":{"type":["string","null"],"default":null},"account":{"type":["object","null"],"properties":{"accountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"type":["string","null"]},"avatarUrl":{"type":["string","null"]},"externalAccountId":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["Facebook"]}},"default":null,"required":["accountId","displayName","handle","avatarUrl","platform"]},"result":{"type":["object","null"],"properties":{"externalId":{"type":"string"},"url":{"type":["string","null"]},"recordedAt":{"type":"string","format":"date-time"}},"default":null,"required":["externalId","url","recordedAt"]}},"default":null,"required":["action"],"title":"Facebook"},{"type":"null"}]},"actionDate":{"type":["string","null"],"examples":["2026-10-02T14:21:40Z"]},"createdAt":{"type":"string","examples":["2026-10-02T14:05:11Z"]},"updatedAt":{"type":"string","examples":["2026-10-02T14:21:40Z"]},"manuallyRecorded":{"type":"boolean"},"status":{"type":"string","enum":["not_taken","taken","rate_limited","queued","failed"],"examples":["not_taken"]},"error":{"type":["string","null"],"description":"Why the action failed, for failed actions.","examples":["Comments are turned off on this post"]},"takenBy":{"type":["string","null"],"format":"uuid","examples":["7c9e6679-7425-40de-944b-e07fc1f90ae7"]}},"required":["id","actionDate","createdAt","updatedAt","manuallyRecorded","status","error","takenBy"]},"description":"Actions waiting to run, oldest first. Cancel one with `DELETE /pitchghost/actions/{id}`."},"taken":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","examples":["0b6f1c1e-4a8d-4c53-9d1e-2f6a7c0c9b11"]},"action":{"anyOf":[{"type":["object","null"],"properties":{"action":{"type":"string","enum":["like","reply","retweet","follow","dm","quote"]},"content":{"type":["string","null"],"default":null},"account":{"anyOf":[{"type":"object","properties":{"accountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"type":"string"},"avatarUrl":{"type":["string","null"]},"externalAccountId":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["Twitter"]},"verified":{"type":"boolean"},"subscriptionType":{"type":"string"}},"required":["accountId","displayName","handle","avatarUrl","platform","verified"],"title":"Current"},{"type":"object","properties":{"accountId":{"type":"string"},"name":{"type":"string"},"screen_name":{"type":"string"},"avatar_image_url":{"type":"string","format":"uri"},"is_verified":{"type":"boolean"},"subscription_type":{"type":"string"},"external_account_id":{"type":"string","format":"uuid"}},"required":["accountId","name","screen_name","avatar_image_url","is_verified"],"deprecated":true,"title":"Legacy"},{"type":"null"}],"default":null},"result":{"type":["object","null"],"properties":{"externalId":{"type":"string"},"url":{"type":["string","null"]},"recordedAt":{"type":"string","format":"date-time"}},"default":null,"required":["externalId","url","recordedAt"]}},"default":null,"required":["action"],"title":"Twitter"},{"type":["object","null"],"properties":{"action":{"type":"string","enum":["react","comment","connect","repost","quote"]},"content":{"type":["string","null"],"default":null},"reactionType":{"type":["string","null"],"enum":["like","celebration","support","love","insightful","funny",null],"default":null},"account":{"anyOf":[{"type":"object","properties":{"accountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"type":"string"},"avatarUrl":{"type":["string","null"]},"externalAccountId":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["LinkedIn"]},"accountType":{"type":"string","enum":["PERSONAL","COMPANY"]},"profileId":{"type":["string","null"]},"premiumSubscriber":{"type":"boolean"},"role":{"type":"string","enum":["SUPER_ADMINISTRATOR","CONTENT_ADMINISTRATOR","ANALYST","DIRECT_SPONSORED_CONTENT_POSTER","LEAD_GEN_FORMS_MANAGER","LEAD_CAPTURE_ADMINISTRATOR"]}},"required":["accountId","displayName","handle","avatarUrl","platform","accountType","profileId"],"title":"Current"},{"oneOf":[{"type":"object","properties":{"accountType":{"type":"string","enum":["PERSONAL"]},"profileId":{"type":"string"},"accountId":{"type":["string","null"]},"firstName":{"type":"string"},"lastName":{"type":"string"},"profilePicture":{"type":["string","null"]},"premiumSubscriber":{"type":"boolean"},"publicIdentifier":{"type":"string"}},"required":["accountType","profileId","firstName","lastName","profilePicture","premiumSubscriber","publicIdentifier"],"title":"Personal"},{"type":"object","properties":{"accountType":{"type":"string","enum":["COMPANY"]},"universalName":{"type":"string"},"name":{"type":"string"},"accountId":{"type":"string"},"logoUrl":{"type":["string","null"]},"role":{"type":"string","enum":["SUPER_ADMINISTRATOR","CONTENT_ADMINISTRATOR","ANALYST","DIRECT_SPONSORED_CONTENT_POSTER","LEAD_GEN_FORMS_MANAGER","LEAD_CAPTURE_ADMINISTRATOR"]}},"required":["accountType","universalName","name","accountId","logoUrl","role"],"title":"Company"}],"deprecated":true,"title":"Legacy"},{"type":"null"}],"default":null},"result":{"type":["object","null"],"properties":{"externalId":{"type":"string"},"url":{"type":["string","null"]},"recordedAt":{"type":"string","format":"date-time"}},"default":null,"required":["externalId","url","recordedAt"]}},"default":null,"required":["action"],"title":"LinkedIn"},{"type":["object","null"],"properties":{"action":{"type":"string","enum":["upvote","downvote","comment","message"]},"content":{"type":["string","null"],"default":null},"subject":{"type":["string","null"],"default":null},"account":{"anyOf":[{"type":"object","properties":{"accountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"type":"string"},"avatarUrl":{"type":["string","null"]},"externalAccountId":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["Reddit"]}},"required":["accountId","displayName","handle","avatarUrl","platform"],"title":"Current"},{"type":"object","properties":{"account_info":{"type":"object","properties":{"id":{"type":"string"},"username":{"type":"string"},"profile_img":{"type":"string"}},"required":["id","username","profile_img"]},"id":{"type":"string"}},"required":["account_info","id"],"deprecated":true,"title":"Legacy"},{"type":"null"}],"default":null},"safetyOverride":{"type":["boolean","null"],"default":false},"result":{"type":["object","null"],"properties":{"externalId":{"type":"string"},"url":{"type":["string","null"]},"recordedAt":{"type":"string","format":"date-time"}},"default":null,"required":["externalId","url","recordedAt"]}},"default":null,"required":["action"],"title":"Reddit"},{"type":["object","null"],"properties":{"action":{"type":"string","enum":["upvote","comment","message"]},"content":{"type":["string","null"],"default":null},"account":{"type":["object","null"],"properties":{"accountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"type":["string","null"]},"avatarUrl":{"type":["string","null"]},"externalAccountId":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["Facebook"]}},"default":null,"required":["accountId","displayName","handle","avatarUrl","platform"]},"result":{"type":["object","null"],"properties":{"externalId":{"type":"string"},"url":{"type":["string","null"]},"recordedAt":{"type":"string","format":"date-time"}},"default":null,"required":["externalId","url","recordedAt"]}},"default":null,"required":["action"],"title":"Facebook"},{"type":"null"}]},"actionDate":{"type":["string","null"],"examples":["2026-10-02T14:21:40Z"]},"createdAt":{"type":"string","examples":["2026-10-02T14:05:11Z"]},"updatedAt":{"type":"string","examples":["2026-10-02T14:21:40Z"]},"manuallyRecorded":{"type":"boolean"},"status":{"type":"string","enum":["not_taken","taken","rate_limited","queued","failed"],"examples":["not_taken"]},"error":{"type":["string","null"],"description":"Why the action failed, for failed actions.","examples":["Comments are turned off on this post"]},"takenBy":{"type":["string","null"],"format":"uuid","examples":["7c9e6679-7425-40de-944b-e07fc1f90ae7"]}},"required":["id","actionDate","createdAt","updatedAt","manuallyRecorded","status","error","takenBy"]},"description":"Actions already taken on the Find, oldest first."},"failed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","examples":["0b6f1c1e-4a8d-4c53-9d1e-2f6a7c0c9b11"]},"action":{"anyOf":[{"type":["object","null"],"properties":{"action":{"type":"string","enum":["like","reply","retweet","follow","dm","quote"]},"content":{"type":["string","null"],"default":null},"account":{"anyOf":[{"type":"object","properties":{"accountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"type":"string"},"avatarUrl":{"type":["string","null"]},"externalAccountId":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["Twitter"]},"verified":{"type":"boolean"},"subscriptionType":{"type":"string"}},"required":["accountId","displayName","handle","avatarUrl","platform","verified"],"title":"Current"},{"type":"object","properties":{"accountId":{"type":"string"},"name":{"type":"string"},"screen_name":{"type":"string"},"avatar_image_url":{"type":"string","format":"uri"},"is_verified":{"type":"boolean"},"subscription_type":{"type":"string"},"external_account_id":{"type":"string","format":"uuid"}},"required":["accountId","name","screen_name","avatar_image_url","is_verified"],"deprecated":true,"title":"Legacy"},{"type":"null"}],"default":null},"result":{"type":["object","null"],"properties":{"externalId":{"type":"string"},"url":{"type":["string","null"]},"recordedAt":{"type":"string","format":"date-time"}},"default":null,"required":["externalId","url","recordedAt"]}},"default":null,"required":["action"],"title":"Twitter"},{"type":["object","null"],"properties":{"action":{"type":"string","enum":["react","comment","connect","repost","quote"]},"content":{"type":["string","null"],"default":null},"reactionType":{"type":["string","null"],"enum":["like","celebration","support","love","insightful","funny",null],"default":null},"account":{"anyOf":[{"type":"object","properties":{"accountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"type":"string"},"avatarUrl":{"type":["string","null"]},"externalAccountId":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["LinkedIn"]},"accountType":{"type":"string","enum":["PERSONAL","COMPANY"]},"profileId":{"type":["string","null"]},"premiumSubscriber":{"type":"boolean"},"role":{"type":"string","enum":["SUPER_ADMINISTRATOR","CONTENT_ADMINISTRATOR","ANALYST","DIRECT_SPONSORED_CONTENT_POSTER","LEAD_GEN_FORMS_MANAGER","LEAD_CAPTURE_ADMINISTRATOR"]}},"required":["accountId","displayName","handle","avatarUrl","platform","accountType","profileId"],"title":"Current"},{"oneOf":[{"type":"object","properties":{"accountType":{"type":"string","enum":["PERSONAL"]},"profileId":{"type":"string"},"accountId":{"type":["string","null"]},"firstName":{"type":"string"},"lastName":{"type":"string"},"profilePicture":{"type":["string","null"]},"premiumSubscriber":{"type":"boolean"},"publicIdentifier":{"type":"string"}},"required":["accountType","profileId","firstName","lastName","profilePicture","premiumSubscriber","publicIdentifier"],"title":"Personal"},{"type":"object","properties":{"accountType":{"type":"string","enum":["COMPANY"]},"universalName":{"type":"string"},"name":{"type":"string"},"accountId":{"type":"string"},"logoUrl":{"type":["string","null"]},"role":{"type":"string","enum":["SUPER_ADMINISTRATOR","CONTENT_ADMINISTRATOR","ANALYST","DIRECT_SPONSORED_CONTENT_POSTER","LEAD_GEN_FORMS_MANAGER","LEAD_CAPTURE_ADMINISTRATOR"]}},"required":["accountType","universalName","name","accountId","logoUrl","role"],"title":"Company"}],"deprecated":true,"title":"Legacy"},{"type":"null"}],"default":null},"result":{"type":["object","null"],"properties":{"externalId":{"type":"string"},"url":{"type":["string","null"]},"recordedAt":{"type":"string","format":"date-time"}},"default":null,"required":["externalId","url","recordedAt"]}},"default":null,"required":["action"],"title":"LinkedIn"},{"type":["object","null"],"properties":{"action":{"type":"string","enum":["upvote","downvote","comment","message"]},"content":{"type":["string","null"],"default":null},"subject":{"type":["string","null"],"default":null},"account":{"anyOf":[{"type":"object","properties":{"accountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"type":"string"},"avatarUrl":{"type":["string","null"]},"externalAccountId":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["Reddit"]}},"required":["accountId","displayName","handle","avatarUrl","platform"],"title":"Current"},{"type":"object","properties":{"account_info":{"type":"object","properties":{"id":{"type":"string"},"username":{"type":"string"},"profile_img":{"type":"string"}},"required":["id","username","profile_img"]},"id":{"type":"string"}},"required":["account_info","id"],"deprecated":true,"title":"Legacy"},{"type":"null"}],"default":null},"safetyOverride":{"type":["boolean","null"],"default":false},"result":{"type":["object","null"],"properties":{"externalId":{"type":"string"},"url":{"type":["string","null"]},"recordedAt":{"type":"string","format":"date-time"}},"default":null,"required":["externalId","url","recordedAt"]}},"default":null,"required":["action"],"title":"Reddit"},{"type":["object","null"],"properties":{"action":{"type":"string","enum":["upvote","comment","message"]},"content":{"type":["string","null"],"default":null},"account":{"type":["object","null"],"properties":{"accountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"type":["string","null"]},"avatarUrl":{"type":["string","null"]},"externalAccountId":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["Facebook"]}},"default":null,"required":["accountId","displayName","handle","avatarUrl","platform"]},"result":{"type":["object","null"],"properties":{"externalId":{"type":"string"},"url":{"type":["string","null"]},"recordedAt":{"type":"string","format":"date-time"}},"default":null,"required":["externalId","url","recordedAt"]}},"default":null,"required":["action"],"title":"Facebook"},{"type":"null"}]},"actionDate":{"type":["string","null"],"examples":["2026-10-02T14:21:40Z"]},"createdAt":{"type":"string","examples":["2026-10-02T14:05:11Z"]},"updatedAt":{"type":"string","examples":["2026-10-02T14:21:40Z"]},"manuallyRecorded":{"type":"boolean"},"status":{"type":"string","enum":["not_taken","taken","rate_limited","queued","failed"],"examples":["not_taken"]},"error":{"type":["string","null"],"description":"Why the action failed, for failed actions.","examples":["Comments are turned off on this post"]},"takenBy":{"type":["string","null"],"format":"uuid","examples":["7c9e6679-7425-40de-944b-e07fc1f90ae7"]}},"required":["id","actionDate","createdAt","updatedAt","manuallyRecorded","status","error","takenBy"]},"description":"Actions that failed, oldest first. `error` says why."}},"required":["findId"]},"TakeActionResponse":{"type":"object","properties":{"status":{"type":"string","enum":["queued","taken","recorded"],"examples":["queued"],"description":"'queued' actions run shortly, paced on the account; follow them with `GET /pitchghost/actions`."},"action":{"type":"string","example":"comment"},"readableName":{"type":"string","example":"Comment"},"findActionId":{"type":["string","null"],"format":"uuid","description":"The suggested action that was taken, when one was used","examples":["0b6f1c1e-4a8d-4c53-9d1e-2f6a7c0c9b11"]}},"required":["status","action","readableName","findActionId"]},"TakeActionError":{"type":"object","properties":{"message":{"type":"string","examples":["This API key is not allowed to use that account"]},"code":{"type":"string","enum":["find_not_found","account_not_found","account_forbidden","suggestion_not_found","invalid_action","unsupported","safety_check","action_failed","upstream_error","invalid_member"],"examples":["account_forbidden"],"description":"Stable error code. 'safety_check' means Reddit's AI safety check flagged the text: review it, then retry with `safetyOverride: true`."}},"required":["message","code"]},"TakeActionRequest":{"type":"object","properties":{"accountId":{"type":"string","format":"uuid","examples":["5d0c2a51-93b7-4f6e-b0a4-8e1f3c7d2a96"],"description":"Required except when recording a Facebook action (`manual: true`), which needs `takenBy` instead. The `integrationId` of the action account to act with. API keys can use accounts shared with the whole company (`access: 'company'`) and personal accounts whose owner allowed this key; any other account returns `account_forbidden`. Check `usableByThisKey` in `GET /pitchghost/action-accounts`."},"findActionId":{"type":"string","format":"uuid","examples":["0b6f1c1e-4a8d-4c53-9d1e-2f6a7c0c9b11"],"description":"Take a suggested action from `GET /pitchghost/finds/{id}/actions` as stored. When set, `action`, `content`, `reactionType` and `subject` are ignored."},"action":{"type":"string","enum":["comment","connect","dm","downvote","follow","like","message","quote","react","reply","repost","retweet","upvote"],"description":"The action verb for the Find's platform, e.g. LinkedIn `comment`, `react`, `connect`, `repost`, `quote`. Required unless `findActionId` is set.","example":"comment"},"content":{"type":"string","examples":["We moved off a heavyweight CRM last year for the same reason. Happy to share what we compared if useful."],"description":"Text for text actions (comments, replies, quotes, messages, connection notes)."},"reactionType":{"type":"string","enum":["like","celebration","support","love","insightful","funny"],"description":"LinkedIn reaction for `react`. Defaults to `like`.","examples":["insightful"]},"subject":{"type":"string","description":"Subject line for a Reddit `message`.","examples":["Your CRM question in r/sales"]},"safetyOverride":{"type":"boolean","default":false,"description":"Reddit only: proceed after a `safety_check` error has been reviewed by a person."},"manual":{"type":"boolean","default":false,"description":"Record that the action was already taken outside PitchGhost instead of taking it."},"takenBy":{"type":"string","format":"uuid","examples":["7c9e6679-7425-40de-944b-e07fc1f90ae7"],"description":"The team member the action is credited to (see `GET /pitchghost/company/members`). Defaults to the member who linked the account."}},"examples":[{"accountId":"5d0c2a51-93b7-4f6e-b0a4-8e1f3c7d2a96","action":"comment","content":"We moved off a heavyweight CRM last year for the same reason. Happy to share what we compared if useful."},{"accountId":"5d0c2a51-93b7-4f6e-b0a4-8e1f3c7d2a96","findActionId":"0b6f1c1e-4a8d-4c53-9d1e-2f6a7c0c9b11"},{"accountId":"5d0c2a51-93b7-4f6e-b0a4-8e1f3c7d2a96","action":"react","reactionType":"insightful"},{"manual":true,"action":"comment","takenBy":"7c9e6679-7425-40de-944b-e07fc1f90ae7"}]},"CancelActionResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","examples":["0b6f1c1e-4a8d-4c53-9d1e-2f6a7c0c9b11"]},"cancelled":{"type":"boolean","enum":[true]}},"required":["id","cancelled"]},"DeleteFindResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","examples":["3f2b8c9a-1d47-4e0b-8a55-6c1d2e9f7a40"]},"deleted":{"type":"boolean","enum":[true]}},"required":["id","deleted"]}},"parameters":{}},"paths":{"/health":{"get":{"summary":"API Health Check","description":"Check the health status of our API layer and verify your authentication","tags":["System"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"responses":{"200":{"description":"API is healthy and authentication is valid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}},"401":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/pitchghost/ghosts":{"get":{"summary":"Get Ghosts","description":"Retrieve all ghosts for your company. Returns ghost configurations including their settings, schedules, and current status.","tags":["Ghosts"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"responses":{"200":{"description":"Successfully retrieved ghosts","content":{"application/json":{"schema":{"type":"object","properties":{"ghosts":{"type":"array","items":{"$ref":"#/components/schemas/GhostDetail"}}},"required":["ghosts"]}}}},"401":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"summary":"Create","description":"Create a Ghost. The Ghost is enabled and scheduled on creation. `threshold` defaults to 0.7, `frequency` to once a day and `maxFinds` to 0 (unlimited). Check search queries with the search estimate endpoint before creating.","tags":["Ghosts"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateGhostRequest"}}}},"responses":{"201":{"description":"The Ghost was created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateGhostResponse"}}}},"400":{"description":"Invalid request data or service-specific validation errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions or no active subscription","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/pitchghost/finds/search":{"post":{"summary":"Search","description":"Retrieve Finds with comprehensive filtering and pagination support. Supports filtering by service, engagement status, ratings, tags, date ranges, and more.","tags":["Finds"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchFindsRequest"}}}},"responses":{"200":{"description":"Successfully retrieved finds with pagination metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchFindsResponse"}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/pitchghost/finds":{"get":{"summary":"Get by ids","description":"Retrieve specific Finds by their IDs. Accepts comma-separated find IDs via the ?ids= query parameter. Returns only finds that belong to your company.","tags":["Finds"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Comma-separated list of find IDs","example":"uuid1,uuid2,uuid3"},"required":true,"description":"Comma-separated list of find IDs","name":"ids","in":"query"}],"responses":{"200":{"description":"Successfully retrieved Finds","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the find","example":"123e4567-e89b-12d3-a456-426614174000"},"company_id":{"type":"string","format":"uuid","description":"Company that owns this find","example":"123e4567-e89b-12d3-a456-426614174000"},"ghost_id":{"type":["string","null"],"format":"uuid","description":"Ghost that discovered this find","example":"123e4567-e89b-12d3-a456-426614174000"},"contact_id":{"type":["string","null"],"format":"uuid","description":"Associated contact profile","example":"123e4567-e89b-12d3-a456-426614174000"},"assigned_uid":{"type":["string","null"],"format":"uuid","description":"User assigned to handle this find","example":"123e4567-e89b-12d3-a456-426614174000"},"service":{"type":"string","enum":["Twitter","LinkedIn","Reddit","Facebook","LinkedIn_People","LinkedIn_Company"],"description":"Platform where the find was discovered","example":"Twitter"},"unique_id":{"type":"string","description":"Platform-specific unique identifier","example":"1234567890123456789"},"data":{"anyOf":[{"type":"object","properties":{"quoted_status_id":{"type":["number","null"],"default":null},"quoted_status_id_str":{"type":["string","null"],"default":null},"is_quote_status":{"type":"boolean","default":false},"quoted_status":{"type":["object","null"],"properties":{"tweet_created_at":{"type":"string"},"id":{"type":"number"},"id_str":{"type":"string"},"text":{"type":["string","null"],"default":null},"full_text":{"type":["string","null"],"default":null},"source":{"type":"string"},"truncated":{"type":"boolean"},"in_reply_to_status_id":{"type":["number","null"],"default":null},"in_reply_to_status_id_str":{"type":["string","null"],"default":null},"in_reply_to_user_id":{"type":["number","null"],"default":null},"in_reply_to_user_id_str":{"type":["string","null"],"default":null},"in_reply_to_screen_name":{"type":["string","null"],"default":null},"user":{"type":"object","properties":{"id":{"type":"number"},"id_str":{"type":"string"},"name":{"type":"string"},"screen_name":{"type":"string"},"location":{"type":["string","null"],"default":null},"url":{"type":["string","null"],"default":null},"description":{"type":["string","null"],"default":null},"protected":{"type":"boolean"},"verified":{"type":"boolean"},"followers_count":{"type":"number"},"friends_count":{"type":"number"},"listed_count":{"type":"number"},"favourites_count":{"type":"number"},"statuses_count":{"type":"number"},"created_at":{"type":"string"},"profile_banner_url":{"type":["string","null"],"default":null},"profile_image_url_https":{"type":"string"},"can_dm":{"type":"boolean"}},"required":["id","id_str","name","screen_name","protected","verified","followers_count","friends_count","listed_count","favourites_count","statuses_count","created_at","profile_image_url_https","can_dm"]}},"default":null,"required":["tweet_created_at","id","id_str","source","truncated","user"]},"retweeted_status":{"type":["object","null"],"properties":{"tweet_created_at":{"type":"string"},"id":{"type":"number"},"id_str":{"type":"string"},"text":{"type":["string","null"],"default":null},"full_text":{"type":["string","null"],"default":null},"source":{"type":"string"},"truncated":{"type":"boolean"},"in_reply_to_status_id":{"type":["number","null"],"default":null},"in_reply_to_status_id_str":{"type":["string","null"],"default":null},"in_reply_to_user_id":{"type":["number","null"],"default":null},"in_reply_to_user_id_str":{"type":["string","null"],"default":null},"in_reply_to_screen_name":{"type":["string","null"],"default":null},"user":{"type":"object","properties":{"id":{"type":"number"},"id_str":{"type":"string"},"name":{"type":"string"},"screen_name":{"type":"string"},"location":{"type":["string","null"],"default":null},"url":{"type":["string","null"],"default":null},"description":{"type":["string","null"],"default":null},"protected":{"type":"boolean"},"verified":{"type":"boolean"},"followers_count":{"type":"number"},"friends_count":{"type":"number"},"listed_count":{"type":"number"},"favourites_count":{"type":"number"},"statuses_count":{"type":"number"},"created_at":{"type":"string"},"profile_banner_url":{"type":["string","null"],"default":null},"profile_image_url_https":{"type":"string"},"can_dm":{"type":"boolean"}},"required":["id","id_str","name","screen_name","protected","verified","followers_count","friends_count","listed_count","favourites_count","statuses_count","created_at","profile_image_url_https","can_dm"]}},"default":null,"required":["tweet_created_at","id","id_str","source","truncated","user"]},"quote_count":{"type":["number","null"],"default":null},"reply_count":{"type":"number"},"retweet_count":{"type":"number"},"favorite_count":{"type":["number","null"],"default":null},"lang":{"type":["string","null"],"default":"und"},"views_count":{"type":["number","null"],"default":null},"bookmark_count":{"type":"number"},"entities":{"type":"object","properties":{"user_mentions":{"type":"array","items":{"type":"object","properties":{"id_str":{"type":"string"},"name":{"type":"string"},"screen_name":{"type":"string"},"indices":{"type":"array","items":{"type":"number"}}},"required":["id_str","name","screen_name","indices"]},"default":[]},"urls":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"expanded_url":{"type":"string"},"display_url":{"type":"string"},"indices":{"type":"array","items":{"type":"number"}}},"required":["url","display_url","indices"]},"default":[]},"hashtags":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"indices":{"type":"array","items":{"type":"number"}}},"required":["text","indices"]},"default":[]},"symbols":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"indices":{"type":"array","items":{"type":"number"}}},"required":["text","indices"]},"default":[]},"media":{"type":"array","items":{"type":"object","properties":{"display_url":{"type":"string"},"expanded_url":{"type":"string"},"ext_alt_text":{"type":["string","null"],"default":null},"id":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"default":null},"id_str":{"type":"string"},"indices":{"type":"array","items":{"type":"number"}},"media_url_https":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string"},"ext_media_availability":{"type":"object","properties":{"status":{"type":"string","enum":["Available","Unavailable"]}},"required":["status"]},"media_key":{"type":"string","default":""},"sizes":{"anyOf":[{"type":"object","properties":{"large":{"type":["object","null"],"properties":{"h":{"type":"number"},"resize":{"type":["string","null"],"enum":["crop","fit",null],"default":"fit"},"w":{"type":"number"}},"default":null,"required":["h","w"]},"medium":{"type":["object","null"],"properties":{"h":{"type":"number"},"resize":{"type":["string","null"],"enum":["crop","fit",null],"default":"fit"},"w":{"type":"number"}},"default":null,"required":["h","w"]},"small":{"type":["object","null"],"properties":{"h":{"type":"number"},"resize":{"type":["string","null"],"enum":["crop","fit",null],"default":"fit"},"w":{"type":"number"}},"default":null,"required":["h","w"]},"thumb":{"type":["object","null"],"properties":{"h":{"type":"number"},"resize":{"type":["string","null"],"enum":["crop","fit",null],"default":"fit"},"w":{"type":"number"}},"default":null,"required":["h","w"]}}},{"type":"array","items":{"type":"object","properties":{"h":{"type":"number"},"resize":{"type":["string","null"],"enum":["crop","fit",null],"default":"fit"},"w":{"type":"number"}},"required":["h","w"]}}]},"original_info":{"type":"object","properties":{"width":{"type":"number"},"height":{"type":"number"},"focus_rects":{"type":"array","items":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"h":{"type":"number"},"w":{"type":"number"}},"required":["x","y","h","w"]},"default":[]}},"required":["width","height"]}},"required":["id_str","indices","type"]},"default":[]}}},"tweet_created_at":{"type":"string"},"id":{"type":"number"},"id_str":{"type":"string"},"text":{"type":["string","null"],"default":null},"full_text":{"type":["string","null"],"default":null},"source":{"type":"string"},"truncated":{"type":"boolean"},"in_reply_to_status_id":{"type":["number","null"],"default":null},"in_reply_to_status_id_str":{"type":["string","null"],"default":null},"in_reply_to_user_id":{"type":["number","null"],"default":null},"in_reply_to_user_id_str":{"type":["string","null"],"default":null},"in_reply_to_screen_name":{"type":["string","null"],"default":null},"user":{"type":"object","properties":{"id":{"type":"number"},"id_str":{"type":"string"},"name":{"type":"string"},"screen_name":{"type":"string"},"location":{"type":["string","null"],"default":null},"url":{"type":["string","null"],"default":null},"description":{"type":["string","null"],"default":null},"protected":{"type":"boolean"},"verified":{"type":"boolean"},"followers_count":{"type":"number"},"friends_count":{"type":"number"},"listed_count":{"type":"number"},"favourites_count":{"type":"number"},"statuses_count":{"type":"number"},"created_at":{"type":"string"},"profile_banner_url":{"type":["string","null"],"default":null},"profile_image_url_https":{"type":"string"},"can_dm":{"type":"boolean"}},"required":["id","id_str","name","screen_name","protected","verified","followers_count","friends_count","listed_count","favourites_count","statuses_count","created_at","profile_image_url_https","can_dm"]}},"required":["reply_count","retweet_count","bookmark_count","entities","tweet_created_at","id","id_str","source","truncated","user"],"title":"Tweet"},{"type":"object","properties":{"attached_image_content":{"type":["string","null"]},"attached_image_url":{"type":["string","null"],"format":"uri"},"attached_image_url_s3":{"type":["string","null"],"format":"uri"},"attached_link":{"type":["string","null"],"format":"uri"},"attached_link_description":{"type":["string","null"]},"attached_medias_id":{"type":["array","null"],"items":{"type":"string"}},"attached_medias_preview_content":{"type":["array","null"],"items":{"type":["string","null"]}},"attached_medias_preview_url":{"type":["array","null"],"items":{"type":["string","null"],"format":"uri"}},"attached_medias_preview_url_s3":{"type":["string","null"],"format":"uri"},"attached_post_id":{"type":["string","null"]},"attached_video_preview_url":{"type":["string","null"],"format":"uri"},"attached_video_preview_url_s3":{"type":["string","null"],"format":"uri"},"attached_video_url":{"type":["string","null"],"format":"uri"},"comments_count":{"type":["integer","null"]},"created_time":{"type":"string"},"fact_checks":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":["string","null"]},"provider_id":{"type":"string"},"provider_name":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["id","title","subtitle","provider_id","provider_name","url"]}},"group_id":{"type":["string","null"]},"id":{"type":"string"},"overlay_warning":{"type":["string","null"]},"owner_full_name":{"type":"string"},"owner_id":{"type":"string"},"owner_username":{"type":["string","null"]},"post_screenshot":{"type":["string","null"],"format":"uri"},"post_type":{"type":"string","enum":["text","image","video","album","shared_link","shared_post"]},"reactions_angry_count":{"type":["integer","null"]},"reactions_haha_count":{"type":["integer","null"]},"reactions_like_count":{"type":["integer","null"]},"reactions_love_count":{"type":["integer","null"]},"reactions_sad_count":{"type":["integer","null"]},"reactions_support_count":{"type":["integer","null"]},"reactions_total_count":{"type":["integer","null"]},"reactions_wow_count":{"type":["integer","null"]},"recommends":{"type":["boolean","null"]},"shares_count":{"type":["integer","null"]},"text":{"type":["string","null"]},"text_lang":{"type":["string","null"]},"text_tagged_users":{"type":["array","null"],"items":{"type":"string"}},"text_tags":{"type":["array","null"],"items":{"type":"string"}},"timestamp":{"type":"integer"},"video_duration":{"type":["integer","null"]},"video_view_count":{"type":["integer","null"]},"posterType":{"type":["string","null"],"enum":["user","page","group",null],"default":"user"},"stored":{"type":"string","format":"date-time"}},"required":["attached_image_content","attached_image_url","attached_image_url_s3","attached_link","attached_link_description","attached_medias_id","attached_medias_preview_content","attached_medias_preview_url","attached_medias_preview_url_s3","attached_post_id","attached_video_preview_url","attached_video_preview_url_s3","attached_video_url","comments_count","created_time","fact_checks","group_id","id","overlay_warning","owner_full_name","owner_id","owner_username","post_screenshot","post_type","reactions_angry_count","reactions_haha_count","reactions_like_count","reactions_love_count","reactions_sad_count","reactions_support_count","reactions_total_count","reactions_wow_count","recommends","shares_count","text","text_lang","text_tagged_users","text_tags","timestamp","video_duration","video_view_count"],"title":"Facebook post"},{"type":"object","properties":{"urn":{"type":"string","pattern":"^urn:([^:]*:){2}[^:]*$"},"shareUrn":{"type":["string","null"],"pattern":"^urn:([^:]*:){2}[^:]*$"},"approxPublishedAt":{"type":["string","null"]},"timestamp":{"type":"number"},"engagement":{"type":"object","properties":{"comments":{"type":"number"},"reactions":{"type":"object","properties":{"LIKE":{"type":"number","default":0},"PRAISE":{"type":"number","default":0},"EMPATHY":{"type":"number","default":0},"INTEREST":{"type":"number","default":0},"APPRECIATION":{"type":"number","default":0},"ENTERTAINMENT":{"type":"number","default":0}}},"shares":{"type":"number"}},"required":["comments","reactions","shares"]},"content":{"type":"object","properties":{"edited":{"type":"boolean"},"text":{"type":["string","null"]},"textAttributes":{"type":"array","items":{"type":"object","properties":{"startIndex":{"type":"number"},"endIndex":{"type":"number"},"url":{"type":"string"}},"required":["startIndex","endIndex","url"]}},"quotePost":{"type":"boolean"},"quotedPost":{"type":["object","null"],"properties":{"urn":{"type":"string","pattern":"^urn:([^:]*:){2}[^:]*$"},"text":{"type":"string"},"author":{"type":["object","null"],"properties":{"name":{"type":"string"},"profileUrl":{"type":"string","format":"uri"},"type":{"type":"string","enum":["Person","Company"]}},"default":null,"required":["name","profileUrl","type"]}},"default":null,"required":["urn","text"]},"hasImage":{"type":"boolean"},"hasMultipleImages":{"type":"boolean"},"hasVideo":{"type":"boolean"},"hasDocument":{"type":"boolean"},"hasLink":{"type":"boolean"},"isCelebration":{"type":"boolean"},"isJobPosting":{"type":"boolean"},"media":{"type":"object","properties":{"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"position":{"type":"number"},"colSpan":{"type":"number"},"alt":{"type":"string"},"width":{"type":"number"},"height":{"type":"number"}},"required":["url"]}},"videos":{"type":"array","items":{"type":"object","properties":{"contentUrl":{"type":"string","format":"uri"},"thumbnailUrl":{"type":"string","format":"uri"},"duration":{"type":"string"},"width":{"type":"number"},"height":{"type":"number"},"captionUrl":{"type":"string","format":"uri"}}}},"articles":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string"},"thumbnailUrl":{"type":"string","format":"uri"}},"required":["url","title"]}},"document":{"type":"object","properties":{"manifestUrl":{"type":"string","format":"uri"},"title":{"type":"string"},"documentUrl":{"type":"string","format":"uri"}},"required":["manifestUrl"]},"poll":{"type":"object","properties":{"question":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"urn":{"type":"string"}},"required":["text","urn"]}},"multiSelect":{"type":"boolean"}},"required":["question","options","multiSelect"]},"openToWork":{"type":"object","properties":{"rolesLookingFor":{"type":"array","items":{"type":"string"}},"detailsUrl":{"type":"string","format":"uri"}},"required":["rolesLookingFor","detailsUrl"]},"celebration":{"type":"object","properties":{"title":{"type":"string"},"imageUrl":{"type":"string","format":"uri"},"type":{"type":"string","enum":["NEW_POSITION","WORK_ANNIVERSARY","OTHER"],"default":"OTHER"}},"required":["title"]}},"required":["images","videos","articles"]},"jobPostingDetails":{"type":["object","null"],"properties":{"title":{"type":"string"},"companyName":{"type":"string"},"companyUrn":{"type":["string","null"],"pattern":"^urn:([^:]*:){2}[^:]*$"},"companyLogo":{"type":"string"},"jobPostingUrl":{"type":["string","null"],"format":"uri"},"location":{"type":"string"},"type":{"type":["string","null"]}},"required":["title","companyName","companyLogo","location"]}},"required":["edited","text","quotePost","hasImage","hasVideo","hasDocument","hasLink","isCelebration","isJobPosting"]},"group":{"type":["object","null"],"properties":{"urn":{"type":"string","pattern":"^urn:([^:]*:){2}[^:]*$"},"name":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["urn","name","url"]},"permissions":{"type":"object","properties":{"canComment":{"type":"boolean"},"canReact":{"type":"boolean"},"canShare":{"type":"boolean"},"canMessage":{"type":"boolean"}},"required":["canComment","canReact","canShare","canMessage"]},"poster":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["Company"]},"name":{"type":"string"},"followerCount":{"type":"number"},"logo":{"type":"string"},"urn":{"type":"string","pattern":"^urn:([^:]*:){2}[^:]*$"},"pageUrl":{"type":"string"},"locations":{"type":"array","items":{"type":"object","properties":{"country":{"type":["string","null"]},"state":{"type":["string","null"]},"city":{"type":["string","null"]},"headquarters":{"type":"boolean"}},"required":["country","state","city","headquarters"]}},"contactInfo":{"type":"object","properties":{"website":{"type":["string","null"]},"phoneNumber":{"type":["string","null"]}},"required":["website","phoneNumber"]},"size":{"type":["number","null"]},"yearFounded":{"type":["number","null"]},"companyType":{"type":["string","null"],"default":"UNKNOWN"},"tagline":{"type":["string","null"]},"description":{"type":["string","null"]},"premium":{"type":["boolean","null"]},"isFullDetails":{"type":"boolean","default":true},"version":{"type":"number","default":1}},"required":["type","name","followerCount","logo","urn","pageUrl","locations","contactInfo","size","yearFounded","tagline","description"],"title":"Company"},{"type":"object","properties":{"type":{"type":"string","enum":["Person"]},"name":{"type":"string"},"title":{"type":["string","null"]},"profileUrl":{"type":"string","format":"uri"},"profileImage":{"type":["string","null"]},"urn":{"type":"string","pattern":"^urn:([^:]*:){2}[^:]*$"},"location":{"type":["object","null"],"properties":{"country":{"type":["string","null"]},"state":{"type":["string","null"]},"city":{"type":["string","null"]}},"required":["country","state","city"]},"followersCount":{"type":"number","default":0},"premium":{"type":["boolean","null"]},"currentPosition":{"type":["object","null"],"properties":{"companyUrn":{"type":["string","null"],"pattern":"^urn:([^:]*:){2}[^:]*$"},"vanityId":{"type":["string","null"]},"name":{"type":"string"},"minEmployeeCount":{"type":["number","null"]},"industry":{"type":["string","null"]},"jobLocation":{"type":["object","null"],"properties":{"country":{"type":["string","null"]},"state":{"type":["string","null"]},"city":{"type":["string","null"]}},"required":["country","state","city"]},"domain":{"type":["string","null"]},"locationRaw":{"type":["string","null"]},"description":{"type":["string","null"]},"followers":{"type":["number","null"]},"slogan":{"type":["string","null"]},"type":{"type":["string","null"]},"yearFounded":{"type":["number","null"]},"tags":{"type":["array","null"],"items":{"type":"string"}}},"required":["name","minEmployeeCount","industry","jobLocation"]},"isFullDetails":{"type":"boolean","default":true},"version":{"type":"number","default":1}},"required":["type","name","title","profileUrl","profileImage","urn","location","currentPosition"],"title":"Person"}]},"fromCache":{"type":"boolean"}},"required":["urn","approxPublishedAt","engagement","content","group","permissions","poster"],"title":"LinkedIn post"},{"type":"object","properties":{"type":{"type":"string","enum":["post"],"description":"Content type"},"title":{"type":"string","description":"Title of the post"},"contains_media":{"type":"boolean","description":"Whether the post contains media (image/video/gallery)"},"can_crosspost":{"type":"boolean","description":"Whether the post can be crossposted"},"contains_spoiler":{"type":"boolean","description":"Whether the post contains spoilers"},"media":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["image"]},"url":{"type":"string","format":"uri"}},"required":["type","url"],"title":"Image"},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"url":{"type":"string","format":"uri"}},"required":["type","url"],"title":"Video"},{"type":"object","properties":{"type":{"type":"string","enum":["gallery"]},"urls":{"type":"array","items":{"type":"string","format":"uri"}}},"required":["type","urls"],"title":"Gallery"},{"type":"null"}],"description":"Attached media data"},"children":{"type":"array","items":{}},"id":{"type":"string","pattern":"^t[1-6]_[a-z0-9]+$","description":"Reddit fullname ID"},"body":{"type":"string","description":"Text content of the post or comment"},"poster":{"type":"object","properties":{"username":{"type":"string","description":"Reddit username"},"id":{"type":"string","pattern":"^t[1-6]_[a-z0-9]+$","description":"Reddit fullname ID of the author (t2_ prefix)"},"profile_img":{"type":"string","format":"uri","description":"URL to the author's profile image"}},"required":["username","id","profile_img"],"description":"The author of the post or comment"},"subreddit":{"type":"string","description":"Subreddit name the content was posted in"},"subreddit_id":{"type":"string","pattern":"^t[1-6]_[a-z0-9]+$","description":"Reddit fullname ID of the subreddit"},"created_at":{"type":"string","description":"When the content was created (ISO string)"},"can_comment":{"type":"boolean","description":"Whether the content can be commented on"},"contains_links":{"type":"boolean","description":"Whether the content contains links"},"lang":{"type":["string","null"],"description":"Detected language code"},"url":{"type":"string","format":"uri","description":"Full URL to the content"},"sentiment":{"type":["string","null"],"enum":["positive","negative","neutral","unknown",null],"description":"Detected sentiment of the content"}},"required":["type","title","contains_media","can_crosspost","contains_spoiler","id","body","poster","subreddit","subreddit_id","created_at","can_comment","contains_links","lang","url","sentiment"],"title":"Post"},{"type":"object","properties":{"type":{"type":"string","enum":["comment"],"description":"Content type"},"parent_id":{"type":"string","pattern":"^t[1-6]_[a-z0-9]+$","description":"Reddit fullname of the parent post or comment this is replying to"},"parent":{},"children":{"type":"array","items":{}},"id":{"type":"string","pattern":"^t[1-6]_[a-z0-9]+$","description":"Reddit fullname ID"},"body":{"type":"string","description":"Text content of the post or comment"},"poster":{"type":"object","properties":{"username":{"type":"string","description":"Reddit username"},"id":{"type":"string","pattern":"^t[1-6]_[a-z0-9]+$","description":"Reddit fullname ID of the author (t2_ prefix)"},"profile_img":{"type":"string","format":"uri","description":"URL to the author's profile image"}},"required":["username","id","profile_img"],"description":"The author of the post or comment"},"subreddit":{"type":"string","description":"Subreddit name the content was posted in"},"subreddit_id":{"type":"string","pattern":"^t[1-6]_[a-z0-9]+$","description":"Reddit fullname ID of the subreddit"},"created_at":{"type":"string","description":"When the content was created (ISO string)"},"can_comment":{"type":"boolean","description":"Whether the content can be commented on"},"contains_links":{"type":"boolean","description":"Whether the content contains links"},"lang":{"type":["string","null"],"description":"Detected language code"},"url":{"type":"string","format":"uri","description":"Full URL to the content"},"sentiment":{"type":["string","null"],"enum":["positive","negative","neutral","unknown",null],"description":"Detected sentiment of the content"}},"required":["type","parent_id","id","body","poster","subreddit","subreddit_id","created_at","can_comment","contains_links","lang","url","sentiment"],"title":"Comment"}],"description":"Platform-specific data for the find"},"analysis":{"type":["object","null"],"properties":{"summary":{"type":"string"},"logic":{"type":"string"}},"required":["summary","logic"],"description":"AI analysis of the find relevance","example":{"logic":"The profile shows active engagement in relevant topics.","summary":"This find appears to be a highly relevant lead based on their activity and interests."}},"confidence_score":{"type":["number","null"],"description":"AI confidence score for find relevance (0-1)","example":0.85},"find_date":{"type":"string","format":"date-time","description":"When the content was originally created","example":"2024-01-15T14:30:00Z"},"engagement_status":{"type":"string","enum":["none","acted_on"],"description":"Current engagement status","example":"none"},"read_status":{"type":"string","enum":["unread","read"],"description":"Whether the find has been reviewed","example":"unread"},"result":{"type":"string","enum":["none","failed","goal"],"description":"Outcome of engagement with this find","example":"none"},"rating":{"type":["string","null"],"enum":["bad","neutral","good",null],"description":"Quality rating given by user","example":"good"},"favorited":{"type":"boolean","description":"Whether the find is marked as favorite","example":true},"feedback":{"type":["string","null"],"description":"User feedback on the find quality","example":"Great lead, highly relevant to our target market"},"notes":{"type":["string","null"],"description":"Private notes about the find","example":"Follow up next week after product launch"},"run_id":{"type":["number","null"],"description":"Ghost run that discovered this find","example":12345},"sentiment":{"type":["string","null"],"enum":["positive","negative","neutral",null],"description":"AI-determined sentiment of the find","example":"positive"},"updated_at":{"type":"string","format":"date-time","description":"When the find was last modified","example":"2024-01-15T14:30:00Z"}},"required":["id","company_id","ghost_id","contact_id","assigned_uid","service","unique_id","data","analysis","confidence_score","find_date","engagement_status","read_status","result","rating","favorited","feedback","notes","run_id","sentiment","updated_at"],"description":"Find object"}}}}},"400":{"description":"Invalid Find ID format or missing ids parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"No Finds found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/pitchghost/finds/update/:id":{"patch":{"summary":"Update","description":"Update specific fields of a Find.","tags":["Finds"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"UUID identifier","example":"123e4567-e89b-12d3-a456-426614174000"},"required":true,"description":"UUID identifier","name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateFindRequest"}}}},"responses":{"200":{"description":"Successfully updated the Find","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateFindResponse"}}}},"400":{"description":"Invalid request data or UUID format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Find not found or does not belong to the company","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/pitchghost/contacts/search":{"post":{"summary":"Search","description":"Search and filter contacts with simple filtering options. Supports text search across names and company, blocked status filtering, and pagination.","tags":["Contacts"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchContactsRequest"}}}},"responses":{"200":{"description":"Successfully retrieved contacts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchContactsResponse"}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/pitchghost/company/members":{"get":{"summary":"Get members","description":"Retrieve all team members with their profile information, roles, and contact details.","tags":["Company"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"responses":{"200":{"description":"Successfully retrieved company members","content":{"application/json":{"schema":{"type":"object","properties":{"members":{"type":"array","items":{"type":"object","properties":{"uid":{"type":"string","examples":["7c9e6679-7425-40de-944b-e07fc1f90ae7"]},"full_name":{"type":"string","examples":["Dana Whitfield"]},"profile_picture":{"type":"string","examples":["https://app.pitchghost.com/avatars/dana-whitfield.png"]},"email":{"type":"string","examples":["dana@acme.com"]},"role":{"type":"string","enum":["member","admin","owner"],"examples":["admin"]}},"required":["uid","full_name","profile_picture","email","role"]}}},"required":["members"]}}}},"401":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/pitchghost/ghosts/update/:id":{"patch":{"summary":"Update","description":"Update a Ghost. Send only the fields to change. Handles frequency changes by automatically rescheduling the ghost, and `enabled` pauses or resumes scheduled scans. The `service` cannot be changed.","tags":["Ghosts"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"UUID identifier","example":"123e4567-e89b-12d3-a456-426614174000"},"required":true,"description":"UUID identifier","name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"service":{"type":"string","enum":["Twitter","LinkedIn","Reddit","Facebook","LinkedIn_People","LinkedIn_Company"],"description":"The service this Ghost monitors"},"nickname":{"type":"string","minLength":1,"maxLength":100,"description":"The display name for the Ghost","examples":["CRM switchers"]},"goal":{"type":"string","minLength":1,"maxLength":2000,"description":"Natural language description of what the Ghost should find. Search queries determine what content is fetched; the goal determines how AI scores and filters that content. Be specific about the type of content, industry, and intent you want to match.\n\nGreat goals answer the following three basic questions:\n\n1. The perfect Find for me looks like...\n2. Don't show me Finds that look like...\n3. I want to engage with these Finds because...\n\nThe more detailed, the better!","examples":["People who are frustrated with their current CRM and are asking for alternatives or recommendations. Don't show me vendors promoting their own product, job postings, or generic sales advice. I want to engage with these Finds because we sell a CRM for small sales teams and can offer a genuinely helpful recommendation."]},"threshold":{"type":"number","minimum":0.1,"maximum":1,"description":"Match confidence threshold (0.1-1.0). Lower values return more results but less relevant, higher values return fewer but more precise matches. Steps of 0.1","examples":[0.7]},"tone":{"type":["string","null"],"maxLength":2000,"description":"Tone for AI-generated responses. Null uses the brand default tone.","examples":["Friendly and helpful, like a peer who has tried a few CRMs. No hard sell."]},"generateResponses":{"type":"boolean","description":"Enable AI-generated response suggestions for Finds. Requires Engage plan."},"frequency":{"oneOf":[{"type":"object","properties":{"value":{"type":"string","enum":["10","15","30"]},"unit":{"type":"string","enum":["minutes"]}},"required":["value","unit"],"title":"Minutes"},{"type":"object","properties":{"value":{"type":"string","enum":["1","2","3","4","5","6","7","8","9","10","11","12"]},"unit":{"type":"string","enum":["hours"]}},"required":["value","unit"],"title":"Hours"},{"type":"object","properties":{"value":{"type":"string","enum":["1","2","3","4","5","6","7"]},"unit":{"type":"string","enum":["days"]}},"required":["value","unit"],"title":"Days"}],"description":"How often the Ghost scans for new content.","examples":[{"value":"1","unit":"days"},{"value":"6","unit":"hours"}]},"maxFinds":{"type":"integer","minimum":0,"maximum":100,"description":"Maximum finds per scan. 0 means unlimited.","examples":[25]},"autoAssign":{"type":["string","null"],"format":"uuid","description":"UUID of a team member to auto-assign finds to. Use search_team_members to find valid IDs. Requires Engage plan.","examples":["7c9e6679-7425-40de-944b-e07fc1f90ae7"]},"serviceSettings":{"anyOf":[{"type":"object","properties":{"searchQueries":{"anyOf":[{"type":"object","properties":{"queries":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","examples":["\"CRM alternative\" OR \"switching CRMs\"","CRM (recommend OR recommendation) -hiring"]},"filters":{"type":["object","null"],"properties":{"images":{"type":["boolean","null"]},"url":{"type":["string","null"],"pattern":"^(?:(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,6})$"},"lang":{"anyOf":[{"type":"string","enum":["aa","ab","ae","af","ak","am","an","ar","as","av","ay","az","ba","be","bg","bi","bm","bn","bo","br","bs","ca","ce","ch","co","cr","cs","cu","cv","cy","da","de","dv","dz","ee","el","en","eo","es","et","eu","fa","ff","fi","fj","fo","fr","fy","ga","gd","gl","gn","gu","gv","ha","he","hi","ho","hr","ht","hu","hy","hz","ia","id","ie","ig","ii","ik","io","is","it","iu","ja","jv","ka","kg","ki","kj","kk","kl","km","kn","ko","kr","ks","ku","kv","kw","ky","la","lb","lg","li","ln","lo","lt","lu","lv","mg","mh","mi","mk","ml","mn","mr","ms","mt","my","na","nb","nd","ne","ng","nl","nn","no","nr","nv","ny","oc","oj","om","or","os","pa","pi","pl","ps","pt","qu","rm","rn","ro","ru","rw","sa","sc","sd","se","sg","si","sk","sl","sm","sn","so","sq","sr","ss","st","su","sv","sw","ta","te","tg","th","ti","tk","tl","tn","to","tr","ts","tt","tw","ty","ug","uk","ur","uz","ve","vi","vo","wa","wo","xh","yi","yo","za","zh","zu"]},{"type":"array","items":{"type":"string","enum":["aa","ab","ae","af","ak","am","an","ar","as","av","ay","az","ba","be","bg","bi","bm","bn","bo","br","bs","ca","ce","ch","co","cr","cs","cu","cv","cy","da","de","dv","dz","ee","el","en","eo","es","et","eu","fa","ff","fi","fj","fo","fr","fy","ga","gd","gl","gn","gu","gv","ha","he","hi","ho","hr","ht","hu","hy","hz","ia","id","ie","ig","ii","ik","io","is","it","iu","ja","jv","ka","kg","ki","kj","kk","kl","km","kn","ko","kr","ks","ku","kv","kw","ky","la","lb","lg","li","ln","lo","lt","lu","lv","mg","mh","mi","mk","ml","mn","mr","ms","mt","my","na","nb","nd","ne","ng","nl","nn","no","nr","nv","ny","oc","oj","om","or","os","pa","pi","pl","ps","pt","qu","rm","rn","ro","ru","rw","sa","sc","sd","se","sg","si","sk","sl","sm","sn","so","sq","sr","ss","st","su","sv","sw","ta","te","tg","th","ti","tk","tl","tn","to","tr","ts","tt","tw","ty","ug","uk","ur","uz","ve","vi","vo","wa","wo","xh","yi","yo","za","zh","zu"]}},{"type":"null"}]},"from":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"replyingTo":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"mentioning":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"verified":{"type":["boolean","null"]},"near":{"type":["object","null"],"properties":{"country":{"type":["string","null"]},"state":{"type":["string","null"]},"city":{"type":["string","null"]}},"required":["country","state","city"]},"retweets":{"type":["boolean","null"]},"replies":{"type":["boolean","null"]},"quotes":{"type":["boolean","null"]},"hashtags":{"type":["boolean","null"]},"news":{"type":["boolean","null"]},"sfw":{"type":["boolean","null"]},"videos":{"type":["boolean","null"]},"links":{"type":["boolean","null"]},"place":{"anyOf":[{"type":"string","enum":["96683cc9126741d1","7142eb97ae21e839","4ec01c9dbc693497","463f5d9615d7d1be","fbd6d2f5a4e4a15e","e8ad2641c1cb666c","e0060cda70f5f341","de599025180e2ee7","65b4760a2b411e11","94965b2c45386f87","25530ba03b7d90c6","f54a2170ff4b15f7","3376992a082d67c7","30410557050f13a5","4e7c21fd2af027c6","f3bfc7dcc928977f","ecdce75d48b13b64","d9074951d5976bdf","c799e2d3a79f810e","81b8dcbe189773f2","78bfaf3f12c05982","ea679934779f45c7","8198e85105936d3c","879d7cfc66c9c290","6b5d375c346e3be9","c29833e68a86e703","82b141af443cb1b8","2ee7eeaa84dbe65a","1ef1183ed7056dc1","e7c97cdfef3a741a","e222580e9a58b499","d0e642e8a900f679","d5cde4dddd7e6f94","a9928b6eaeb54f86","34ed2e67dd5a22bb","58f54743b1a62911","8d65596349ee2e01","f7531639e8db5e12","f0af1239cbebb474","1d834adff5d584df","6416b8512febefc9","1b107df3ccc0aaa1","4d3b316fe2e52b29","3b98b02fba3f9753","47a3cf27863714de","3f14ce28dc7c4566","06ef846bfc783874","0b039ce18ddf1cb9","c00e5392b3fa46fb","173c2bb9d42baaa5","2edb6e240797c549","0639360bd49a15e3","288de3df481163e8"]},{"type":"array","items":{"type":"string","enum":["96683cc9126741d1","7142eb97ae21e839","4ec01c9dbc693497","463f5d9615d7d1be","fbd6d2f5a4e4a15e","e8ad2641c1cb666c","e0060cda70f5f341","de599025180e2ee7","65b4760a2b411e11","94965b2c45386f87","25530ba03b7d90c6","f54a2170ff4b15f7","3376992a082d67c7","30410557050f13a5","4e7c21fd2af027c6","f3bfc7dcc928977f","ecdce75d48b13b64","d9074951d5976bdf","c799e2d3a79f810e","81b8dcbe189773f2","78bfaf3f12c05982","ea679934779f45c7","8198e85105936d3c","879d7cfc66c9c290","6b5d375c346e3be9","c29833e68a86e703","82b141af443cb1b8","2ee7eeaa84dbe65a","1ef1183ed7056dc1","e7c97cdfef3a741a","e222580e9a58b499","d0e642e8a900f679","d5cde4dddd7e6f94","a9928b6eaeb54f86","34ed2e67dd5a22bb","58f54743b1a62911","8d65596349ee2e01","f7531639e8db5e12","f0af1239cbebb474","1d834adff5d584df","6416b8512febefc9","1b107df3ccc0aaa1","4d3b316fe2e52b29","3b98b02fba3f9753","47a3cf27863714de","3f14ce28dc7c4566","06ef846bfc783874","0b039ce18ddf1cb9","c00e5392b3fa46fb","173c2bb9d42baaa5","2edb6e240797c549","0639360bd49a15e3","288de3df481163e8"]}},{"type":"null"}]},"tags":{"type":["boolean","null"]},"minFollowers":{"type":["number","null"]},"minFollowing":{"type":["number","null"]},"minTweets":{"type":["number","null"]},"canDM":{"type":["boolean","null"]}},"default":{}}},"required":["value"]},"minItems":1,"maxItems":15},"global":{"type":"object","properties":{"images":{"type":["boolean","null"]},"url":{"type":["string","null"],"pattern":"^(?:(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,6})$"},"lang":{"anyOf":[{"type":"string","enum":["aa","ab","ae","af","ak","am","an","ar","as","av","ay","az","ba","be","bg","bi","bm","bn","bo","br","bs","ca","ce","ch","co","cr","cs","cu","cv","cy","da","de","dv","dz","ee","el","en","eo","es","et","eu","fa","ff","fi","fj","fo","fr","fy","ga","gd","gl","gn","gu","gv","ha","he","hi","ho","hr","ht","hu","hy","hz","ia","id","ie","ig","ii","ik","io","is","it","iu","ja","jv","ka","kg","ki","kj","kk","kl","km","kn","ko","kr","ks","ku","kv","kw","ky","la","lb","lg","li","ln","lo","lt","lu","lv","mg","mh","mi","mk","ml","mn","mr","ms","mt","my","na","nb","nd","ne","ng","nl","nn","no","nr","nv","ny","oc","oj","om","or","os","pa","pi","pl","ps","pt","qu","rm","rn","ro","ru","rw","sa","sc","sd","se","sg","si","sk","sl","sm","sn","so","sq","sr","ss","st","su","sv","sw","ta","te","tg","th","ti","tk","tl","tn","to","tr","ts","tt","tw","ty","ug","uk","ur","uz","ve","vi","vo","wa","wo","xh","yi","yo","za","zh","zu"]},{"type":"array","items":{"type":"string","enum":["aa","ab","ae","af","ak","am","an","ar","as","av","ay","az","ba","be","bg","bi","bm","bn","bo","br","bs","ca","ce","ch","co","cr","cs","cu","cv","cy","da","de","dv","dz","ee","el","en","eo","es","et","eu","fa","ff","fi","fj","fo","fr","fy","ga","gd","gl","gn","gu","gv","ha","he","hi","ho","hr","ht","hu","hy","hz","ia","id","ie","ig","ii","ik","io","is","it","iu","ja","jv","ka","kg","ki","kj","kk","kl","km","kn","ko","kr","ks","ku","kv","kw","ky","la","lb","lg","li","ln","lo","lt","lu","lv","mg","mh","mi","mk","ml","mn","mr","ms","mt","my","na","nb","nd","ne","ng","nl","nn","no","nr","nv","ny","oc","oj","om","or","os","pa","pi","pl","ps","pt","qu","rm","rn","ro","ru","rw","sa","sc","sd","se","sg","si","sk","sl","sm","sn","so","sq","sr","ss","st","su","sv","sw","ta","te","tg","th","ti","tk","tl","tn","to","tr","ts","tt","tw","ty","ug","uk","ur","uz","ve","vi","vo","wa","wo","xh","yi","yo","za","zh","zu"]}},{"type":"null"}]},"from":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"replyingTo":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"mentioning":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"verified":{"type":["boolean","null"]},"near":{"type":["object","null"],"properties":{"country":{"type":["string","null"]},"state":{"type":["string","null"]},"city":{"type":["string","null"]}},"required":["country","state","city"]},"retweets":{"type":["boolean","null"]},"replies":{"type":["boolean","null"]},"quotes":{"type":["boolean","null"]},"hashtags":{"type":["boolean","null"]},"news":{"type":["boolean","null"]},"sfw":{"type":["boolean","null"]},"videos":{"type":["boolean","null"]},"links":{"type":["boolean","null"]},"place":{"anyOf":[{"type":"string","enum":["96683cc9126741d1","7142eb97ae21e839","4ec01c9dbc693497","463f5d9615d7d1be","fbd6d2f5a4e4a15e","e8ad2641c1cb666c","e0060cda70f5f341","de599025180e2ee7","65b4760a2b411e11","94965b2c45386f87","25530ba03b7d90c6","f54a2170ff4b15f7","3376992a082d67c7","30410557050f13a5","4e7c21fd2af027c6","f3bfc7dcc928977f","ecdce75d48b13b64","d9074951d5976bdf","c799e2d3a79f810e","81b8dcbe189773f2","78bfaf3f12c05982","ea679934779f45c7","8198e85105936d3c","879d7cfc66c9c290","6b5d375c346e3be9","c29833e68a86e703","82b141af443cb1b8","2ee7eeaa84dbe65a","1ef1183ed7056dc1","e7c97cdfef3a741a","e222580e9a58b499","d0e642e8a900f679","d5cde4dddd7e6f94","a9928b6eaeb54f86","34ed2e67dd5a22bb","58f54743b1a62911","8d65596349ee2e01","f7531639e8db5e12","f0af1239cbebb474","1d834adff5d584df","6416b8512febefc9","1b107df3ccc0aaa1","4d3b316fe2e52b29","3b98b02fba3f9753","47a3cf27863714de","3f14ce28dc7c4566","06ef846bfc783874","0b039ce18ddf1cb9","c00e5392b3fa46fb","173c2bb9d42baaa5","2edb6e240797c549","0639360bd49a15e3","288de3df481163e8"]},{"type":"array","items":{"type":"string","enum":["96683cc9126741d1","7142eb97ae21e839","4ec01c9dbc693497","463f5d9615d7d1be","fbd6d2f5a4e4a15e","e8ad2641c1cb666c","e0060cda70f5f341","de599025180e2ee7","65b4760a2b411e11","94965b2c45386f87","25530ba03b7d90c6","f54a2170ff4b15f7","3376992a082d67c7","30410557050f13a5","4e7c21fd2af027c6","f3bfc7dcc928977f","ecdce75d48b13b64","d9074951d5976bdf","c799e2d3a79f810e","81b8dcbe189773f2","78bfaf3f12c05982","ea679934779f45c7","8198e85105936d3c","879d7cfc66c9c290","6b5d375c346e3be9","c29833e68a86e703","82b141af443cb1b8","2ee7eeaa84dbe65a","1ef1183ed7056dc1","e7c97cdfef3a741a","e222580e9a58b499","d0e642e8a900f679","d5cde4dddd7e6f94","a9928b6eaeb54f86","34ed2e67dd5a22bb","58f54743b1a62911","8d65596349ee2e01","f7531639e8db5e12","f0af1239cbebb474","1d834adff5d584df","6416b8512febefc9","1b107df3ccc0aaa1","4d3b316fe2e52b29","3b98b02fba3f9753","47a3cf27863714de","3f14ce28dc7c4566","06ef846bfc783874","0b039ce18ddf1cb9","c00e5392b3fa46fb","173c2bb9d42baaa5","2edb6e240797c549","0639360bd49a15e3","288de3df481163e8"]}},{"type":"null"}]},"tags":{"type":["boolean","null"]},"minFollowers":{"type":["number","null"]},"minFollowing":{"type":["number","null"]},"minTweets":{"type":["number","null"]},"canDM":{"type":["boolean","null"]}},"default":{}}},"required":["queries"],"title":"Queries with global filters"},{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","examples":["\"CRM alternative\" OR \"switching CRMs\"","CRM (recommend OR recommendation) -hiring"]},"filters":{"type":["object","null"],"properties":{"images":{"type":["boolean","null"]},"url":{"type":["string","null"],"pattern":"^(?:(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,6})$"},"lang":{"anyOf":[{"type":"string","enum":["aa","ab","ae","af","ak","am","an","ar","as","av","ay","az","ba","be","bg","bi","bm","bn","bo","br","bs","ca","ce","ch","co","cr","cs","cu","cv","cy","da","de","dv","dz","ee","el","en","eo","es","et","eu","fa","ff","fi","fj","fo","fr","fy","ga","gd","gl","gn","gu","gv","ha","he","hi","ho","hr","ht","hu","hy","hz","ia","id","ie","ig","ii","ik","io","is","it","iu","ja","jv","ka","kg","ki","kj","kk","kl","km","kn","ko","kr","ks","ku","kv","kw","ky","la","lb","lg","li","ln","lo","lt","lu","lv","mg","mh","mi","mk","ml","mn","mr","ms","mt","my","na","nb","nd","ne","ng","nl","nn","no","nr","nv","ny","oc","oj","om","or","os","pa","pi","pl","ps","pt","qu","rm","rn","ro","ru","rw","sa","sc","sd","se","sg","si","sk","sl","sm","sn","so","sq","sr","ss","st","su","sv","sw","ta","te","tg","th","ti","tk","tl","tn","to","tr","ts","tt","tw","ty","ug","uk","ur","uz","ve","vi","vo","wa","wo","xh","yi","yo","za","zh","zu"]},{"type":"array","items":{"type":"string","enum":["aa","ab","ae","af","ak","am","an","ar","as","av","ay","az","ba","be","bg","bi","bm","bn","bo","br","bs","ca","ce","ch","co","cr","cs","cu","cv","cy","da","de","dv","dz","ee","el","en","eo","es","et","eu","fa","ff","fi","fj","fo","fr","fy","ga","gd","gl","gn","gu","gv","ha","he","hi","ho","hr","ht","hu","hy","hz","ia","id","ie","ig","ii","ik","io","is","it","iu","ja","jv","ka","kg","ki","kj","kk","kl","km","kn","ko","kr","ks","ku","kv","kw","ky","la","lb","lg","li","ln","lo","lt","lu","lv","mg","mh","mi","mk","ml","mn","mr","ms","mt","my","na","nb","nd","ne","ng","nl","nn","no","nr","nv","ny","oc","oj","om","or","os","pa","pi","pl","ps","pt","qu","rm","rn","ro","ru","rw","sa","sc","sd","se","sg","si","sk","sl","sm","sn","so","sq","sr","ss","st","su","sv","sw","ta","te","tg","th","ti","tk","tl","tn","to","tr","ts","tt","tw","ty","ug","uk","ur","uz","ve","vi","vo","wa","wo","xh","yi","yo","za","zh","zu"]}},{"type":"null"}]},"from":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"replyingTo":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"mentioning":{"type":["string","null"],"minLength":1,"pattern":"^[^@]*$"},"verified":{"type":["boolean","null"]},"near":{"type":["object","null"],"properties":{"country":{"type":["string","null"]},"state":{"type":["string","null"]},"city":{"type":["string","null"]}},"required":["country","state","city"]},"retweets":{"type":["boolean","null"]},"replies":{"type":["boolean","null"]},"quotes":{"type":["boolean","null"]},"hashtags":{"type":["boolean","null"]},"news":{"type":["boolean","null"]},"sfw":{"type":["boolean","null"]},"videos":{"type":["boolean","null"]},"links":{"type":["boolean","null"]},"place":{"anyOf":[{"type":"string","enum":["96683cc9126741d1","7142eb97ae21e839","4ec01c9dbc693497","463f5d9615d7d1be","fbd6d2f5a4e4a15e","e8ad2641c1cb666c","e0060cda70f5f341","de599025180e2ee7","65b4760a2b411e11","94965b2c45386f87","25530ba03b7d90c6","f54a2170ff4b15f7","3376992a082d67c7","30410557050f13a5","4e7c21fd2af027c6","f3bfc7dcc928977f","ecdce75d48b13b64","d9074951d5976bdf","c799e2d3a79f810e","81b8dcbe189773f2","78bfaf3f12c05982","ea679934779f45c7","8198e85105936d3c","879d7cfc66c9c290","6b5d375c346e3be9","c29833e68a86e703","82b141af443cb1b8","2ee7eeaa84dbe65a","1ef1183ed7056dc1","e7c97cdfef3a741a","e222580e9a58b499","d0e642e8a900f679","d5cde4dddd7e6f94","a9928b6eaeb54f86","34ed2e67dd5a22bb","58f54743b1a62911","8d65596349ee2e01","f7531639e8db5e12","f0af1239cbebb474","1d834adff5d584df","6416b8512febefc9","1b107df3ccc0aaa1","4d3b316fe2e52b29","3b98b02fba3f9753","47a3cf27863714de","3f14ce28dc7c4566","06ef846bfc783874","0b039ce18ddf1cb9","c00e5392b3fa46fb","173c2bb9d42baaa5","2edb6e240797c549","0639360bd49a15e3","288de3df481163e8"]},{"type":"array","items":{"type":"string","enum":["96683cc9126741d1","7142eb97ae21e839","4ec01c9dbc693497","463f5d9615d7d1be","fbd6d2f5a4e4a15e","e8ad2641c1cb666c","e0060cda70f5f341","de599025180e2ee7","65b4760a2b411e11","94965b2c45386f87","25530ba03b7d90c6","f54a2170ff4b15f7","3376992a082d67c7","30410557050f13a5","4e7c21fd2af027c6","f3bfc7dcc928977f","ecdce75d48b13b64","d9074951d5976bdf","c799e2d3a79f810e","81b8dcbe189773f2","78bfaf3f12c05982","ea679934779f45c7","8198e85105936d3c","879d7cfc66c9c290","6b5d375c346e3be9","c29833e68a86e703","82b141af443cb1b8","2ee7eeaa84dbe65a","1ef1183ed7056dc1","e7c97cdfef3a741a","e222580e9a58b499","d0e642e8a900f679","d5cde4dddd7e6f94","a9928b6eaeb54f86","34ed2e67dd5a22bb","58f54743b1a62911","8d65596349ee2e01","f7531639e8db5e12","f0af1239cbebb474","1d834adff5d584df","6416b8512febefc9","1b107df3ccc0aaa1","4d3b316fe2e52b29","3b98b02fba3f9753","47a3cf27863714de","3f14ce28dc7c4566","06ef846bfc783874","0b039ce18ddf1cb9","c00e5392b3fa46fb","173c2bb9d42baaa5","2edb6e240797c549","0639360bd49a15e3","288de3df481163e8"]}},{"type":"null"}]},"tags":{"type":["boolean","null"]},"minFollowers":{"type":["number","null"]},"minFollowing":{"type":["number","null"]},"minTweets":{"type":["number","null"]},"canDM":{"type":["boolean","null"]}},"default":{}}},"required":["value"]},"minItems":1,"maxItems":15,"deprecated":true,"title":"Queries only"}]},"onlyTweets":{"type":"boolean","default":false},"responseTypes":{"type":["object","null"],"properties":{"like":{"type":["boolean","null"],"default":true},"reply":{"type":["boolean","null"],"default":true},"retweet":{"type":["boolean","null"],"default":true},"follow":{"type":["boolean","null"],"default":true},"dm":{"type":["boolean","null"],"default":true},"quote":{"type":["boolean","null"],"default":true}},"default":null}},"required":["searchQueries"],"title":"Twitter"},{"type":"object","properties":{"searchQueries":{"anyOf":[{"type":"object","properties":{"queries":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","examples":["CRM (alternative OR switching OR \"moving away\")","\"sales team\" \"new CRM\""]},"filters":{"type":["object","null"],"properties":{"hasImage":{"type":["boolean","null"]},"hasVideo":{"type":["boolean","null"]},"hasHashtags":{"type":["boolean","null"]},"hasLink":{"type":["boolean","null"]},"hasDocument":{"type":["boolean","null"]},"posterType":{"type":["string","null"],"enum":["Person","Company",null]},"isJobPosting":{"type":["boolean","null"]},"isQuoting":{"type":["boolean","null"]},"isCelebration":{"type":["boolean","null"]},"permission.canReact":{"type":["boolean","null"]},"permission.canComment":{"type":["boolean","null"]},"permission.canMessage":{"type":["boolean","null"]},"permission.canShare":{"type":["boolean","null"]},"profile.industry":{"anyOf":[{"type":"string","enum":["1","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115","116","117","118","119","120","121","122","123","124","125","126","127","128","129","130","131","132","133","134","135","136","137","138","139","140","141","142","143","145","146","147","148","150","201","256","298","332","341","345","356","382","383","384","385","386","387","388","389","390","397","398","400","404","406","408","413","419","428","431","435","436","453","460","481","495","504","529","562","564","598","615","616","622","625","679","690","703","709","722","727","743","773","779","784","794","799","840","849","861","871","873","876","883","887","901","923","928","935","964","973","983","994","998","1005","1029","1042","1080","1090","1095","1128","1137","1153","1157","1166","1171","1178","1187","1206","1208","1212","1221","1222","1230","1231","1250","1257","1262","1267","1285","1292","1309","1319","1324","1339","1359","1370","1407","1409","1423","1424","1431","1445","1481","1495","1497","1504","1505","1512","1517","1520","1532","1573","1594","1600","1602","1611","1623","1625","1633","1641","1644","1649","1673","1678","1696","1713","1720","1725","1737","1738","1742","1743","1745","1750","1757","1759","1770","1779","1786","1798","1810","1855","1862","1905","1909","1911","1912","1916","1923","1925","1931","1938","1956","1958","1965","1981","1986","1999","2012","2018","2019","2020","2025","2027","2029","2040","2045","2048","2050","2054","2060","2063","2069","2074","2077","2081","2091","2112","2122","2125","2128","2130","2133","2135","2139","2142","2143","2159","2161","2163","2167","2179","2181","2194","2197","2212","2214","2217","2226","2240","2247","2253","2255","2258","2259","2272","2282","2318","2353","2358","2366","2369","2374","2375","2391","2401","2458","2468","2489","2500","2934","3065","3068","3070","3081","3085","3086","3089","3095","3096","3099","3100","3101","3102","3103","3104","3105","3106","3107","3124","3125","3126","3127","3128","3129","3130","3131","3132","3133","3134","3186","3240","3241","3242","3243","3244","3245","3246","3247","3248","3249","3250","3251","3252","3253","3254","3255","3256"]},{"type":"array","items":{"type":"string","enum":["1","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115","116","117","118","119","120","121","122","123","124","125","126","127","128","129","130","131","132","133","134","135","136","137","138","139","140","141","142","143","145","146","147","148","150","201","256","298","332","341","345","356","382","383","384","385","386","387","388","389","390","397","398","400","404","406","408","413","419","428","431","435","436","453","460","481","495","504","529","562","564","598","615","616","622","625","679","690","703","709","722","727","743","773","779","784","794","799","840","849","861","871","873","876","883","887","901","923","928","935","964","973","983","994","998","1005","1029","1042","1080","1090","1095","1128","1137","1153","1157","1166","1171","1178","1187","1206","1208","1212","1221","1222","1230","1231","1250","1257","1262","1267","1285","1292","1309","1319","1324","1339","1359","1370","1407","1409","1423","1424","1431","1445","1481","1495","1497","1504","1505","1512","1517","1520","1532","1573","1594","1600","1602","1611","1623","1625","1633","1641","1644","1649","1673","1678","1696","1713","1720","1725","1737","1738","1742","1743","1745","1750","1757","1759","1770","1779","1786","1798","1810","1855","1862","1905","1909","1911","1912","1916","1923","1925","1931","1938","1956","1958","1965","1981","1986","1999","2012","2018","2019","2020","2025","2027","2029","2040","2045","2048","2050","2054","2060","2063","2069","2074","2077","2081","2091","2112","2122","2125","2128","2130","2133","2135","2139","2142","2143","2159","2161","2163","2167","2179","2181","2194","2197","2212","2214","2217","2226","2240","2247","2253","2255","2258","2259","2272","2282","2318","2353","2358","2366","2369","2374","2375","2391","2401","2458","2468","2489","2500","2934","3065","3068","3070","3081","3085","3086","3089","3095","3096","3099","3100","3101","3102","3103","3104","3105","3106","3107","3124","3125","3126","3127","3128","3129","3130","3131","3132","3133","3134","3186","3240","3241","3242","3243","3244","3245","3246","3247","3248","3249","3250","3251","3252","3253","3254","3255","3256"]}},{"type":"null"}]},"profile.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"profile.minFollowerCount":{"type":["number","null"]},"company.minFollowerCount":{"type":["number","null"]},"profile.title":{"type":["string","null"]},"profile.currentPosition.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"profile.currentPosition.hasJob":{"type":["boolean","null"]},"profile.currentPosition.minEmployeeCount":{"type":["number","null"]},"profile.currentPosition.maxEmployeeCount":{"type":["number","null"]},"company.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"company.companyAge":{"type":["number","null"]},"company.companySize":{"type":["number","null"]},"company.contactInfo.hasWebsite":{"type":["boolean","null"]},"company.contactInfo.hasPhoneNumber":{"type":["boolean","null"]},"company.companyType":{"type":["string","null"],"enum":["PROFIT","NON_PROFIT",null]}},"default":{}}},"required":["value"]},"minItems":1,"maxItems":15},"global":{"type":"object","properties":{"hasImage":{"type":["boolean","null"]},"hasVideo":{"type":["boolean","null"]},"hasHashtags":{"type":["boolean","null"]},"hasLink":{"type":["boolean","null"]},"hasDocument":{"type":["boolean","null"]},"posterType":{"type":["string","null"],"enum":["Person","Company",null]},"isJobPosting":{"type":["boolean","null"]},"isQuoting":{"type":["boolean","null"]},"isCelebration":{"type":["boolean","null"]},"permission.canReact":{"type":["boolean","null"]},"permission.canComment":{"type":["boolean","null"]},"permission.canMessage":{"type":["boolean","null"]},"permission.canShare":{"type":["boolean","null"]},"profile.industry":{"anyOf":[{"type":"string","enum":["1","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115","116","117","118","119","120","121","122","123","124","125","126","127","128","129","130","131","132","133","134","135","136","137","138","139","140","141","142","143","145","146","147","148","150","201","256","298","332","341","345","356","382","383","384","385","386","387","388","389","390","397","398","400","404","406","408","413","419","428","431","435","436","453","460","481","495","504","529","562","564","598","615","616","622","625","679","690","703","709","722","727","743","773","779","784","794","799","840","849","861","871","873","876","883","887","901","923","928","935","964","973","983","994","998","1005","1029","1042","1080","1090","1095","1128","1137","1153","1157","1166","1171","1178","1187","1206","1208","1212","1221","1222","1230","1231","1250","1257","1262","1267","1285","1292","1309","1319","1324","1339","1359","1370","1407","1409","1423","1424","1431","1445","1481","1495","1497","1504","1505","1512","1517","1520","1532","1573","1594","1600","1602","1611","1623","1625","1633","1641","1644","1649","1673","1678","1696","1713","1720","1725","1737","1738","1742","1743","1745","1750","1757","1759","1770","1779","1786","1798","1810","1855","1862","1905","1909","1911","1912","1916","1923","1925","1931","1938","1956","1958","1965","1981","1986","1999","2012","2018","2019","2020","2025","2027","2029","2040","2045","2048","2050","2054","2060","2063","2069","2074","2077","2081","2091","2112","2122","2125","2128","2130","2133","2135","2139","2142","2143","2159","2161","2163","2167","2179","2181","2194","2197","2212","2214","2217","2226","2240","2247","2253","2255","2258","2259","2272","2282","2318","2353","2358","2366","2369","2374","2375","2391","2401","2458","2468","2489","2500","2934","3065","3068","3070","3081","3085","3086","3089","3095","3096","3099","3100","3101","3102","3103","3104","3105","3106","3107","3124","3125","3126","3127","3128","3129","3130","3131","3132","3133","3134","3186","3240","3241","3242","3243","3244","3245","3246","3247","3248","3249","3250","3251","3252","3253","3254","3255","3256"]},{"type":"array","items":{"type":"string","enum":["1","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115","116","117","118","119","120","121","122","123","124","125","126","127","128","129","130","131","132","133","134","135","136","137","138","139","140","141","142","143","145","146","147","148","150","201","256","298","332","341","345","356","382","383","384","385","386","387","388","389","390","397","398","400","404","406","408","413","419","428","431","435","436","453","460","481","495","504","529","562","564","598","615","616","622","625","679","690","703","709","722","727","743","773","779","784","794","799","840","849","861","871","873","876","883","887","901","923","928","935","964","973","983","994","998","1005","1029","1042","1080","1090","1095","1128","1137","1153","1157","1166","1171","1178","1187","1206","1208","1212","1221","1222","1230","1231","1250","1257","1262","1267","1285","1292","1309","1319","1324","1339","1359","1370","1407","1409","1423","1424","1431","1445","1481","1495","1497","1504","1505","1512","1517","1520","1532","1573","1594","1600","1602","1611","1623","1625","1633","1641","1644","1649","1673","1678","1696","1713","1720","1725","1737","1738","1742","1743","1745","1750","1757","1759","1770","1779","1786","1798","1810","1855","1862","1905","1909","1911","1912","1916","1923","1925","1931","1938","1956","1958","1965","1981","1986","1999","2012","2018","2019","2020","2025","2027","2029","2040","2045","2048","2050","2054","2060","2063","2069","2074","2077","2081","2091","2112","2122","2125","2128","2130","2133","2135","2139","2142","2143","2159","2161","2163","2167","2179","2181","2194","2197","2212","2214","2217","2226","2240","2247","2253","2255","2258","2259","2272","2282","2318","2353","2358","2366","2369","2374","2375","2391","2401","2458","2468","2489","2500","2934","3065","3068","3070","3081","3085","3086","3089","3095","3096","3099","3100","3101","3102","3103","3104","3105","3106","3107","3124","3125","3126","3127","3128","3129","3130","3131","3132","3133","3134","3186","3240","3241","3242","3243","3244","3245","3246","3247","3248","3249","3250","3251","3252","3253","3254","3255","3256"]}},{"type":"null"}]},"profile.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"profile.minFollowerCount":{"type":["number","null"]},"company.minFollowerCount":{"type":["number","null"]},"profile.title":{"type":["string","null"]},"profile.currentPosition.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"profile.currentPosition.hasJob":{"type":["boolean","null"]},"profile.currentPosition.minEmployeeCount":{"type":["number","null"]},"profile.currentPosition.maxEmployeeCount":{"type":["number","null"]},"company.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"company.companyAge":{"type":["number","null"]},"company.companySize":{"type":["number","null"]},"company.contactInfo.hasWebsite":{"type":["boolean","null"]},"company.contactInfo.hasPhoneNumber":{"type":["boolean","null"]},"company.companyType":{"type":["string","null"],"enum":["PROFIT","NON_PROFIT",null]}},"default":{}}},"required":["queries"],"title":"Queries with global filters"},{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","examples":["CRM (alternative OR switching OR \"moving away\")","\"sales team\" \"new CRM\""]},"filters":{"type":["object","null"],"properties":{"hasImage":{"type":["boolean","null"]},"hasVideo":{"type":["boolean","null"]},"hasHashtags":{"type":["boolean","null"]},"hasLink":{"type":["boolean","null"]},"hasDocument":{"type":["boolean","null"]},"posterType":{"type":["string","null"],"enum":["Person","Company",null]},"isJobPosting":{"type":["boolean","null"]},"isQuoting":{"type":["boolean","null"]},"isCelebration":{"type":["boolean","null"]},"permission.canReact":{"type":["boolean","null"]},"permission.canComment":{"type":["boolean","null"]},"permission.canMessage":{"type":["boolean","null"]},"permission.canShare":{"type":["boolean","null"]},"profile.industry":{"anyOf":[{"type":"string","enum":["1","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115","116","117","118","119","120","121","122","123","124","125","126","127","128","129","130","131","132","133","134","135","136","137","138","139","140","141","142","143","145","146","147","148","150","201","256","298","332","341","345","356","382","383","384","385","386","387","388","389","390","397","398","400","404","406","408","413","419","428","431","435","436","453","460","481","495","504","529","562","564","598","615","616","622","625","679","690","703","709","722","727","743","773","779","784","794","799","840","849","861","871","873","876","883","887","901","923","928","935","964","973","983","994","998","1005","1029","1042","1080","1090","1095","1128","1137","1153","1157","1166","1171","1178","1187","1206","1208","1212","1221","1222","1230","1231","1250","1257","1262","1267","1285","1292","1309","1319","1324","1339","1359","1370","1407","1409","1423","1424","1431","1445","1481","1495","1497","1504","1505","1512","1517","1520","1532","1573","1594","1600","1602","1611","1623","1625","1633","1641","1644","1649","1673","1678","1696","1713","1720","1725","1737","1738","1742","1743","1745","1750","1757","1759","1770","1779","1786","1798","1810","1855","1862","1905","1909","1911","1912","1916","1923","1925","1931","1938","1956","1958","1965","1981","1986","1999","2012","2018","2019","2020","2025","2027","2029","2040","2045","2048","2050","2054","2060","2063","2069","2074","2077","2081","2091","2112","2122","2125","2128","2130","2133","2135","2139","2142","2143","2159","2161","2163","2167","2179","2181","2194","2197","2212","2214","2217","2226","2240","2247","2253","2255","2258","2259","2272","2282","2318","2353","2358","2366","2369","2374","2375","2391","2401","2458","2468","2489","2500","2934","3065","3068","3070","3081","3085","3086","3089","3095","3096","3099","3100","3101","3102","3103","3104","3105","3106","3107","3124","3125","3126","3127","3128","3129","3130","3131","3132","3133","3134","3186","3240","3241","3242","3243","3244","3245","3246","3247","3248","3249","3250","3251","3252","3253","3254","3255","3256"]},{"type":"array","items":{"type":"string","enum":["1","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115","116","117","118","119","120","121","122","123","124","125","126","127","128","129","130","131","132","133","134","135","136","137","138","139","140","141","142","143","145","146","147","148","150","201","256","298","332","341","345","356","382","383","384","385","386","387","388","389","390","397","398","400","404","406","408","413","419","428","431","435","436","453","460","481","495","504","529","562","564","598","615","616","622","625","679","690","703","709","722","727","743","773","779","784","794","799","840","849","861","871","873","876","883","887","901","923","928","935","964","973","983","994","998","1005","1029","1042","1080","1090","1095","1128","1137","1153","1157","1166","1171","1178","1187","1206","1208","1212","1221","1222","1230","1231","1250","1257","1262","1267","1285","1292","1309","1319","1324","1339","1359","1370","1407","1409","1423","1424","1431","1445","1481","1495","1497","1504","1505","1512","1517","1520","1532","1573","1594","1600","1602","1611","1623","1625","1633","1641","1644","1649","1673","1678","1696","1713","1720","1725","1737","1738","1742","1743","1745","1750","1757","1759","1770","1779","1786","1798","1810","1855","1862","1905","1909","1911","1912","1916","1923","1925","1931","1938","1956","1958","1965","1981","1986","1999","2012","2018","2019","2020","2025","2027","2029","2040","2045","2048","2050","2054","2060","2063","2069","2074","2077","2081","2091","2112","2122","2125","2128","2130","2133","2135","2139","2142","2143","2159","2161","2163","2167","2179","2181","2194","2197","2212","2214","2217","2226","2240","2247","2253","2255","2258","2259","2272","2282","2318","2353","2358","2366","2369","2374","2375","2391","2401","2458","2468","2489","2500","2934","3065","3068","3070","3081","3085","3086","3089","3095","3096","3099","3100","3101","3102","3103","3104","3105","3106","3107","3124","3125","3126","3127","3128","3129","3130","3131","3132","3133","3134","3186","3240","3241","3242","3243","3244","3245","3246","3247","3248","3249","3250","3251","3252","3253","3254","3255","3256"]}},{"type":"null"}]},"profile.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"profile.minFollowerCount":{"type":["number","null"]},"company.minFollowerCount":{"type":["number","null"]},"profile.title":{"type":["string","null"]},"profile.currentPosition.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"profile.currentPosition.hasJob":{"type":["boolean","null"]},"profile.currentPosition.minEmployeeCount":{"type":["number","null"]},"profile.currentPosition.maxEmployeeCount":{"type":["number","null"]},"company.location":{"anyOf":[{"type":"string","enum":["US","CA","GB","IN","AU"]},{"type":"array","items":{"type":"string","enum":["US","CA","GB","IN","AU"]}},{"type":"null"}]},"company.companyAge":{"type":["number","null"]},"company.companySize":{"type":["number","null"]},"company.contactInfo.hasWebsite":{"type":["boolean","null"]},"company.contactInfo.hasPhoneNumber":{"type":["boolean","null"]},"company.companyType":{"type":["string","null"],"enum":["PROFIT","NON_PROFIT",null]}},"default":{}}},"required":["value"]},"minItems":1,"maxItems":15,"deprecated":true,"title":"Queries only"}]},"responseTypes":{"type":["object","null"],"properties":{"react":{"type":["boolean","null"],"default":true},"comment":{"type":["boolean","null"],"default":true},"connect":{"type":["boolean","null"],"default":true},"repost":{"type":["boolean","null"],"default":true},"quote":{"type":["boolean","null"],"default":true}},"default":null}},"required":["searchQueries"],"title":"LinkedIn"},{"type":"object","properties":{"searchQueries":{"type":"object","properties":{"queries":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","examples":["\"CRM alternative\" OR \"switching CRMs\"","CRM (recommend OR recommendation)"]},"filters":{"type":["object","null"],"properties":{"subreddits":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"excludeSubreddits":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"canReply":{"type":["boolean","null"]},"hasMedia":{"type":["boolean","null"]},"canCrosspost":{"type":["boolean","null"]},"containsSpoilers":{"type":["boolean","null"]},"containsLinks":{"type":["boolean","null"]},"subType":{"type":["string","null"],"enum":["public","restricted",null]},"contentType":{"type":["string","null"],"enum":["post","comment",null]},"lang":{"type":["string","null"],"enum":["French","Italian","Spanish","English","German","Chinese","Japanese","Russian","Arabic","Hebrew","Polish","Hindi","Urdu","Portuguese","Thai","Turkish","Ukrainian","Vietnamese","Greek","Malay","Korean","Bengali","Irish","Punjabi","Swedish","Welsh","Armenian","Danish","Dutch","Estonian","Finnish",null]},"sentiment":{"type":["string","null"],"enum":["positive","negative","neutral",null]},"users":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"minSubSize":{"type":["number","null"]},"domains":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"minUserKarma":{"type":["number","null"]},"minUserAccountAge":{"type":["number","null"]}},"default":{}}},"required":["value"]},"minItems":1,"maxItems":15},"global":{"type":"object","properties":{"subreddits":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"excludeSubreddits":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"canReply":{"type":["boolean","null"]},"hasMedia":{"type":["boolean","null"]},"canCrosspost":{"type":["boolean","null"]},"containsSpoilers":{"type":["boolean","null"]},"containsLinks":{"type":["boolean","null"]},"subType":{"type":["string","null"],"enum":["public","restricted",null]},"contentType":{"type":["string","null"],"enum":["post","comment",null]},"lang":{"type":["string","null"],"enum":["French","Italian","Spanish","English","German","Chinese","Japanese","Russian","Arabic","Hebrew","Polish","Hindi","Urdu","Portuguese","Thai","Turkish","Ukrainian","Vietnamese","Greek","Malay","Korean","Bengali","Irish","Punjabi","Swedish","Welsh","Armenian","Danish","Dutch","Estonian","Finnish",null]},"sentiment":{"type":["string","null"],"enum":["positive","negative","neutral",null]},"users":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"minSubSize":{"type":["number","null"]},"domains":{"type":["array","null"],"items":{"type":"string"},"minItems":1,"maxItems":15},"minUserKarma":{"type":["number","null"]},"minUserAccountAge":{"type":["number","null"]}},"default":{}}},"required":["queries"]},"responseTypes":{"type":["object","null"],"properties":{"upvote":{"type":["boolean","null"],"default":true},"downvote":{"type":["boolean","null"],"default":true},"comment":{"type":["boolean","null"],"default":true},"message":{"type":["boolean","null"],"default":true}},"default":null},"subSafeResponses":{"type":"boolean","default":true}},"required":["searchQueries"],"title":"Reddit"},{"type":"object","properties":{"searchQueries":{"type":"object","properties":{"queries":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","examples":["CRM recommendations","switching CRM"]},"filters":{"type":["object","null"],"properties":{"lang":{"type":["string","null"],"enum":["fr","it","es","en","de","zh","ja","ru","ar","he","pl","hi","ur","pt","th","tr","uk","vi","el","ms","ko","bn","ga","pa","sv","cy","hy","da","nl","et","fi",null]},"hasHashtags":{"type":["boolean","null"]},"hasLinks":{"type":["boolean","null"]},"location":{"type":["string","null"],"enum":["107991659233606","106224666074625","106003956105810","108659242498155","111762725508574","114586701886732","115963528414384","108081209214649","110970792260960","110148382341970","106300959405546","106338002735968","106220079409935","111822758834362","104028629632792","113998391943532","105745629459139","105775436121898","108424279189115","112305682116972","112887355389124","103111876395954","109570449061083","108056275889020","104019619634224","103990676304130","109260602433140","109297442421359","107705532592043","106066949424984","103787786326610","110941395597405","114497808567786","102184499823699","111983945494775","106262189412553","115167478498675","105959272778333","109870912368806","105634782802493","115976748413086","112662855415315","108489419175297","108108762549844","109493702409366","110185085668702","105559566144042","109412232411040","109375499081852","110893392264912","105675929465006","106057819434480","109307099087536","105479049486624","105496622817769","101881036520836","105540216147364","112548152092705","105988062765295","110714572282163","110184922344060","110884905606108","116190411724975","102146663160831","110843418940484","109692899057899","107674002595670","109486839070556","103728359665916","106078429431815","114629675219759","113564935326488","108299645860446","104029736299647","115753025103602","105653082800923","114469421897671","103145123058362","103123839728353","108285455858477","104034969634202",null]}},"default":{}}},"required":["value"]},"minItems":1,"maxItems":10},"global":{"type":"object","properties":{"lang":{"type":["string","null"],"enum":["fr","it","es","en","de","zh","ja","ru","ar","he","pl","hi","ur","pt","th","tr","uk","vi","el","ms","ko","bn","ga","pa","sv","cy","hy","da","nl","et","fi",null]},"hasHashtags":{"type":["boolean","null"]},"hasLinks":{"type":["boolean","null"]},"location":{"type":["string","null"],"enum":["107991659233606","106224666074625","106003956105810","108659242498155","111762725508574","114586701886732","115963528414384","108081209214649","110970792260960","110148382341970","106300959405546","106338002735968","106220079409935","111822758834362","104028629632792","113998391943532","105745629459139","105775436121898","108424279189115","112305682116972","112887355389124","103111876395954","109570449061083","108056275889020","104019619634224","103990676304130","109260602433140","109297442421359","107705532592043","106066949424984","103787786326610","110941395597405","114497808567786","102184499823699","111983945494775","106262189412553","115167478498675","105959272778333","109870912368806","105634782802493","115976748413086","112662855415315","108489419175297","108108762549844","109493702409366","110185085668702","105559566144042","109412232411040","109375499081852","110893392264912","105675929465006","106057819434480","109307099087536","105479049486624","105496622817769","101881036520836","105540216147364","112548152092705","105988062765295","110714572282163","110184922344060","110884905606108","116190411724975","102146663160831","110843418940484","109692899057899","107674002595670","109486839070556","103728359665916","106078429431815","114629675219759","113564935326488","108299645860446","104029736299647","115753025103602","105653082800923","114469421897671","103145123058362","103123839728353","108285455858477","104034969634202",null]}},"default":{}}},"required":["queries"]},"responseTypes":{"type":["object","null"],"properties":{"upvote":{"type":["boolean","null"],"default":true},"comment":{"type":["boolean","null"],"default":true},"message":{"type":["boolean","null"],"default":true}},"default":null}},"required":["searchQueries"],"title":"Facebook"},{"type":"object","properties":{"users":{"type":"object","properties":{"value":{"type":["string","null"],"default":null,"description":"The people to monitor, as one string with one LinkedIn profile URL or username per line (max 5000). Set this yourself to monitor a fixed list. When `smartSync`, `smartSearch` or `connectionsSync` is set, leave it out: PitchGhost fills and maintains the list from that source.","examples":["https://www.linkedin.com/in/dana-whitfield\nhttps://www.linkedin.com/in/marcus-oyelaran\npriya-raman"]},"smartSync":{"oneOf":[{"type":"object","properties":{"crm":{"type":"string","enum":["hubspot"]},"list":{"type":"object","properties":{"name":{"type":"string"},"id":{"type":"string"},"url":{"type":"string"}},"required":["name","id","url"]},"cache":{"type":["array","null"],"items":{"type":"object","properties":{"profile":{"type":"string"},"recordId":{"type":"string"}},"required":["profile","recordId"]},"description":"Maintained by PitchGhost. Do not set."},"enrich":{"type":"boolean"},"syncType":{"type":"string","enum":["notes","task","none"]},"syncOptions":{"type":"object","properties":{"urgency":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"dueDate":{"type":"number","exclusiveMinimum":0,"maximum":31}},"default":{"urgency":"MEDIUM","dueDate":3},"required":["urgency","dueDate"]}},"required":["crm","list","syncType"],"title":"HubSpot"},{"type":"object","properties":{"syncType":{"type":"string","enum":["sequence","task","none"],"default":"none"},"crm":{"type":"string","enum":["apollo"]},"cache":{"type":["array","null"],"items":{"type":"object","properties":{"profile":{"type":"string"},"recordId":{"type":"string"}},"required":["profile","recordId"]},"description":"Maintained by PitchGhost. Do not set."},"list":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"syncOptions":{"type":"object","properties":{"priority":{"type":"string","enum":["low","medium","high"]},"due_at":{"type":["number","null"]},"user_id":{"type":"string"},"type":{"type":"string","enum":["call","outreach_manual_email","linkedin_step_connect","linkedin_step_view_profile","linkedin_step_interact_post","action_item"]},"status":{"type":"string","enum":["scheduled","completed","archived"]},"sequence_id":{"type":"string"},"emailer_campaign_id":{"type":"string"},"send_email_from_email_account_id":{"type":"string"}}}},"required":["crm","list"],"title":"Apollo"},{"type":"object","properties":{"crm":{"type":"string","enum":["salesforce"]},"list":{"type":"object","properties":{"name":{"type":"string"},"id":{"type":"string"},"url":{"type":"string"}},"required":["name","id","url"]},"enrich":{"type":"boolean"},"cache":{"type":["array","null"],"items":{"type":"object","properties":{"profile":{"type":"string"},"recordId":{"type":"string"}},"required":["profile","recordId"]},"description":"Maintained by PitchGhost. Do not set."},"syncType":{"type":"string","enum":["note","task","none"],"default":"none"},"binding":{"type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"company":{"type":"string"},"linkedin_url":{"type":"string"}},"required":["first_name","last_name","company","linkedin_url"]},"syncOptions":{"type":"object","properties":{"activityDate":{"type":["number","null"]},"task_ownerId":{"type":"string"}},"required":["activityDate","task_ownerId"]}},"required":["crm","list","binding"],"title":"Salesforce"},{"type":"object","properties":{"crm":{"type":"string","enum":["intercom"]},"segment":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"enrich":{"type":"boolean"},"binding":{"type":"object","properties":{"linkedin_url":{"type":"string"}}},"cache":{"type":["array","null"],"items":{"type":"object","properties":{"profile":{"type":"string"},"recordId":{"type":"string"}},"required":["profile","recordId"]},"description":"Maintained by PitchGhost. Do not set."},"syncType":{"type":"string","enum":["none","ticket"],"default":"none"},"syncOptions":{"type":"object","properties":{"skip_notification":{"type":"boolean"},"ticket_type_id":{"type":"string"},"ticket_category":{"type":"string","enum":["Back-office","Tracker","Customer"]},"assignee_id":{"type":"string"}}}},"required":["crm","segment","binding"],"title":"Intercom"},{"type":"object","properties":{"crm":{"type":"string","enum":["folk"]},"group":{"type":"object","properties":{"name":{"type":"string"},"id":{"type":"string"}},"required":["name","id"]},"enrich":{"type":"boolean"},"binding":{"type":"object","properties":{"linkedin_url":{"type":"string"}}},"cache":{"type":["array","null"],"items":{"type":"object","properties":{"profile":{"type":"string"},"recordId":{"type":"string"}},"required":["profile","recordId"]},"description":"Maintained by PitchGhost. Do not set."},"syncType":{"type":"string","enum":["none","note","interaction"],"default":"none"},"syncOptions":{"type":"object","properties":{"note_visibility":{"type":"string","enum":["public","private"],"default":"public"},"interaction_type":{"type":"string","enum":["linkedin","call","meeting","message","coffee"],"default":"linkedin"}}}},"required":["crm","group","binding"],"title":"Folk"},{"type":"object","properties":{"crm":{"type":"string","enum":["gohighlevel"]},"tag":{"type":"string"},"binding":{"type":"object","properties":{"linkedin_url":{"type":"string"}}},"cache":{"type":["array","null"],"items":{"type":"object","properties":{"profile":{"type":"string"},"recordId":{"type":"string"}},"required":["profile","recordId"]},"description":"Maintained by PitchGhost. Do not set."},"enrich":{"type":"boolean"},"syncType":{"type":"string","enum":["notes","task","none"],"default":"none"},"syncOptions":{"type":"object","properties":{"assignedTo":{"type":"string"},"dueDate":{"type":"number","exclusiveMinimum":0,"maximum":31}}}},"required":["crm","tag","binding"],"title":"HighLevel"},{"type":"null"}],"default":null,"description":"Monitor the people in a CRM list, segment, group or tag instead of a fixed list. The CRM must already be connected in PitchGhost. `crm` picks the CRM and decides which other fields apply."},"smartSearch":{"type":["object","null"],"properties":{"criteria":{"type":"object","properties":{"locations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"LinkedIn's numeric id for this item.","examples":[103644278]},"name":{"type":"string","description":"The item's display name.","examples":["United States"]}},"required":["id","name"]}},"companies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"LinkedIn's numeric id for this item.","examples":[103644278]},"name":{"type":"string","description":"The item's display name.","examples":["United States"]}},"required":["id","name"]}},"pastCompanies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"LinkedIn's numeric id for this item.","examples":[103644278]},"name":{"type":"string","description":"The item's display name.","examples":["United States"]}},"required":["id","name"]}},"schools":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"LinkedIn's numeric id for this item.","examples":[103644278]},"name":{"type":"string","description":"The item's display name.","examples":["United States"]}},"required":["id","name"]}},"industries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"LinkedIn's numeric id for this item.","examples":[103644278]},"name":{"type":"string","description":"The item's display name.","examples":["United States"]}},"required":["id","name"]}},"services":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"LinkedIn's numeric id for this item.","examples":[103644278]},"name":{"type":"string","description":"The item's display name.","examples":["United States"]}},"required":["id","name"]}},"title":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string","minLength":1,"maxLength":512},"maxItems":30}],"description":"Job titles to match, up to 30.","examples":[["Head of Sales","VP Sales"]]}},"description":"Who to search for. At least one criterion is required."},"refinements":{"type":"object","properties":{"minFollowerCount":{"type":"number","minimum":0},"companyEmployeeMaxCount":{"type":"number","minimum":0},"companyEmployeeMinCount":{"type":"number","minimum":0},"premium":{"type":"boolean"},"verified":{"type":"boolean"}},"description":"Optional extra limits applied to the people the search returns."}},"default":null,"required":["criteria"],"description":"Monitor everyone matching a LinkedIn people search (job titles, companies, locations and so on) instead of a fixed list."},"connectionsSync":{"type":["object","null"],"properties":{"sourceProfile":{"type":"object","properties":{"integrationId":{"type":"string","description":"The `integrationId` of the connected LinkedIn account, from `GET /pitchghost/action-accounts`.","examples":["5d0c2a51-93b7-4f6e-b0a4-8e1f3c7d2a96"]},"vanityId":{"type":"string","description":"The account's LinkedIn vanity name: the last part of its profile URL, linkedin.com/in/<vanityId>.","examples":["dana-whitfield"]},"displayName":{"type":"string","description":"The account owner's name, shown in the app.","examples":["Dana Whitfield"]}},"required":["integrationId","vanityId","displayName"],"description":"The connected LinkedIn account whose connections are monitored."}},"default":null,"required":["sourceProfile"],"description":"Monitor the 1st-degree connections of one of your connected LinkedIn accounts instead of a fixed list."},"filters":{"type":"null","description":"Not used for this Ghost type. Leave out or send null."}},"description":"Who this Ghost monitors. Choose exactly one source: a fixed list in `value`, or one of `smartSync`, `smartSearch` or `connectionsSync`. Only one of those three can be set at a time.","examples":[{"value":"https://www.linkedin.com/in/dana-whitfield\nhttps://www.linkedin.com/in/marcus-oyelaran"},{"smartSearch":{"criteria":{"title":["Head of Sales","VP Sales"],"locations":[{"id":103644278,"name":"United States"}]},"refinements":{"companyEmployeeMinCount":11,"companyEmployeeMaxCount":200}}},{"connectionsSync":{"sourceProfile":{"integrationId":"5d0c2a51-93b7-4f6e-b0a4-8e1f3c7d2a96","vanityId":"dana-whitfield","displayName":"Dana Whitfield"}}}]},"responseTypes":{"type":["object","null"],"properties":{"react":{"type":["boolean","null"],"default":true},"comment":{"type":["boolean","null"],"default":true},"connect":{"type":["boolean","null"],"default":true},"repost":{"type":["boolean","null"],"default":true},"quote":{"type":["boolean","null"],"default":true}},"default":null,"description":"Which suggested response types to generate when `generateResponses` is on. Set a type to false to turn it off; null or omitted means all types.","examples":[{"comment":true,"react":true,"connect":false}]}},"required":["users"],"title":"LinkedIn People"},{"type":"object","properties":{"companies":{"type":"object","properties":{"value":{"type":["string","null"],"default":null,"description":"The company pages to monitor, as one string with one LinkedIn company page URL per line (max 5000). The page's slug, the last part of linkedin.com/company/<slug>, also works.","examples":["https://www.linkedin.com/company/acme-robotics\nnorthwind-traders"]},"filters":{"type":"null","description":"Not used for this Ghost type. Leave out or send null."}}},"responseTypes":{"type":["object","null"],"properties":{"react":{"type":["boolean","null"],"default":true},"comment":{"type":["boolean","null"],"default":true},"connect":{"type":["boolean","null"],"default":true},"repost":{"type":["boolean","null"],"default":true},"quote":{"type":["boolean","null"],"default":true}},"default":null}},"required":["companies"],"title":"LinkedIn Company"}],"description":"Service-specific settings for the Ghost"},"enabled":{"type":"boolean","description":"Set to false to pause scheduled scans, or true to resume them (schedules the next scan).","example":false}},"examples":[{"enabled":false},{"threshold":0.8,"frequency":{"value":"6","unit":"hours"},"maxFinds":50},{"serviceSettings":{"searchQueries":{"queries":[{"value":"\"CRM migration\" OR \"replacing our CRM\"","filters":{}}]}}}]}}}},"responses":{"200":{"description":"Successfully updated the Ghost","content":{"application/json":{"schema":{"type":"object","properties":{"ghost":{"$ref":"#/components/schemas/GhostDetail"},"rescheduled":{"type":"boolean","description":"Whether the next scan was rescheduled (a frequency change or a resume)","examples":[true]}},"required":["ghost","rescheduled"]}}}},"400":{"description":"Invalid request data or service-specific validation errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions or plan restrictions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Ghost not found or does not belong to company","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/pitchghost/ghosts/search":{"post":{"summary":"Search","description":"Search and filter ghosts with comprehensive filtering options. Supports filtering by service, platform, enabled status, notifications, assignments, text search, date ranges, and more.","tags":["Ghosts"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchGhostsRequest"}}}},"responses":{"200":{"description":"Successfully retrieved Ghosts with pagination metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchGhostsResponse"}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/pitchghost/contacts/update/:id":{"patch":{"summary":"Update","description":"Update a contact. Only allows updating first_name, last_name, notes, profile_image, and is_blocked.","tags":["Contacts"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"UUID identifier","example":"123e4567-e89b-12d3-a456-426614174000"},"required":true,"description":"UUID identifier","name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"first_name":{"type":["string","null"],"minLength":1,"maxLength":100},"last_name":{"type":["string","null"],"minLength":1,"maxLength":100},"notes":{"type":["string","null"],"minLength":1,"maxLength":2000},"profile_image":{"type":["string","null"],"format":"uri"},"is_blocked":{"type":"boolean"}},"examples":[{"first_name":"Dana","last_name":"Whitfield","notes":"Head of Sales at Acme. Evaluating CRMs this quarter.","is_blocked":false}]}}}},"responses":{"200":{"description":"Successfully updated contact","content":{"application/json":{"schema":{"type":"object","properties":{"contact":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the contact","example":"123e4567-e89b-12d3-a456-426614174000"},"company_id":{"type":"string","format":"uuid","description":"Company that owns this contact","example":"123e4567-e89b-12d3-a456-426614174000"},"display_name":{"type":"string","description":"Display name for the contact","example":"John Doe"},"first_name":{"type":["string","null"],"description":"First name of the contact","example":"John"},"last_name":{"type":["string","null"],"description":"Last name of the contact","example":"Doe"},"company_name":{"type":["string","null"],"description":"Company or organization name","example":"Acme Corp"},"is_blocked":{"type":"boolean","description":"Whether this contact is blocked","example":false},"is_company":{"type":"boolean","description":"Whether this represents a company profile","example":false},"is_platform_name":{"type":"boolean","description":"Whether this is a platform-generated name","example":false},"discovered_source":{"type":"string","enum":["manual","twitter","linkedIn","reddit","facebook"],"description":"Platform where contact was discovered","example":"twitter"},"profile_image":{"type":["string","null"],"description":"URL to profile image","example":"https://example.com/avatar.jpg"},"notes":{"type":["string","null"],"description":"Private notes about this contact","example":"Potential customer, interested in our API"},"created_at":{"type":"string","format":"date-time","description":"When the contact was first discovered","example":"2024-01-15T14:30:00Z"},"updated_at":{"type":"string","format":"date-time","description":"When the contact was last modified","example":"2024-01-15T14:30:00Z"}},"required":["id","company_id","display_name","first_name","last_name","company_name","is_blocked","is_company","is_platform_name","discovered_source","profile_image","notes","created_at","updated_at"]}},"required":["contact"]}}}},"400":{"description":"Invalid request data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions or contact not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/pitchghost/scan":{"post":{"summary":"Start a Scan","description":"Trigger a scan for a Ghost.","tags":["Scans"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"ghostId":{"type":"string","format":"uuid","examples":["123e4567-e89b-12d3-a456-426614174000"]}},"required":["ghostId"]}}}},"responses":{"200":{"description":"Scan triggered successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanGhostResponse"}}}},"400":{"description":"Invalid request (e.g., invalid UUID format)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions or no active subscription","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Ghost not found or does not belong to company","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/pitchghost/scan/:runId":{"get":{"summary":"Get Scan Status","description":"Get the current status and details of a scan run.","tags":["Scans"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","pattern":"^\\d+$","description":"The numeric ID of the scan run","example":"12345"},"required":true,"description":"The numeric ID of the scan run","name":"runId","in":"path"}],"responses":{"200":{"description":"Scan status retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanStatusResponse"}}}},"401":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Run not found or does not belong to company","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"summary":"Cancel or Delete Scan","description":"Cancel a running/queued/preprocessing scan or delete a completed scan record. In-progress scans are stopped and marked as cancelled. Completed scans will be permanently deleted.","tags":["Scans"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","pattern":"^\\d+$","description":"The numeric ID of the scan run","example":"12345"},"required":true,"description":"The numeric ID of the scan run","name":"runId","in":"path"}],"responses":{"200":{"description":"Scan cancelled or deleted successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteScanResponse"}}}},"401":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Run not found or does not belong to company","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/pitchghost/ghosts/:id":{"delete":{"summary":"Delete","description":"Permanently delete a Ghost and its scan history. Its Finds are kept unless `deleteFinds=true`. To stop a Ghost without deleting it, update it with `enabled: false`.","tags":["Ghosts"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"123e4567-e89b-12d3-a456-426614174000"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","enum":["true","false"],"default":"false","description":"Also delete the Ghost's Finds. By default they are kept and stay readable through the Finds endpoints.","example":"false"},"required":false,"description":"Also delete the Ghost's Finds. By default they are kept and stay readable through the Finds endpoints.","name":"deleteFinds","in":"query"}],"responses":{"200":{"description":"The Ghost was deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteGhostResponse"}}}},"400":{"description":"Invalid Ghost ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Ghost not found or does not belong to company","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/pitchghost/search/estimate":{"post":{"summary":"Estimate a search","description":"Estimates how many raw results one Ghost search query would return over a 7-day window, without running a search. Use it to validate query syntax (an invalid query returns 400 with the reason) and to calibrate how broad a query is before saving it on a Ghost.\n\n`query` takes the same shape as one entry of the Ghost's `serviceSettings.searchQueries.queries` for that service. Set `includeSamples: true` to also receive a few matching results formatted as readable text.\n\n**Important:** The returned number is an ESTIMATE of RAW search results, not of Finds.","tags":["Ghosts"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSearchEstimateRequest"}}}},"responses":{"200":{"description":"Estimate computed successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchEstimateResponse"}}}},"400":{"description":"Invalid request parameters or an invalid search query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchEstimateErrorResponse"}}}},"401":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions or no active subscription","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error during estimation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchEstimateErrorResponse"}}}},"503":{"description":"The platform service is temporarily offline","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchEstimateErrorResponse"}}}}}}},"/pitchghost/action-accounts":{"get":{"summary":"List action accounts","description":"List your company's connected LinkedIn, Twitter and Reddit accounts, including whether each one is still connected (`status`) and whether this API key can take actions with it (`usableByThisKey`). Members can allow specific API keys to use their personal accounts in the account's access settings.","tags":["Actions"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","enum":["twitter","linkedin","reddit"],"description":"Only accounts on this platform. Omit for every platform.","example":"linkedin"},"required":false,"description":"Only accounts on this platform. Omit for every platform.","name":"platform","in":"query"}],"responses":{"200":{"description":"The connected accounts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionAccountsResponse"}}}},"400":{"description":"Invalid platform","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/pitchghost/actions":{"get":{"summary":"List actions","description":"Browse your company's actions (comments, replies, reactions, connection requests, messages) by state: queued and waiting to run, taken, or failed. Queued actions report their delivery attempts and when they next run; failed actions carry the error.","tags":["Actions"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","enum":["queued","taken","failed"],"default":"queued","description":"Which bucket to read: 'queued' (waiting to run, including rate-limit deferrals), 'taken' (completed), or 'failed'.","example":"failed"},"required":false,"description":"Which bucket to read: 'queued' (waiting to run, including rate-limit deferrals), 'taken' (completed), or 'failed'.","name":"status","in":"query"},{"schema":{"type":"string","minLength":1,"description":"Substring search across the action content, error message, and the linked Find text.","examples":["pricing"]},"required":false,"description":"Substring search across the action content, error message, and the linked Find text.","name":"search","in":"query"},{"schema":{"type":"array","items":{"type":"string","enum":["Twitter","LinkedIn","Reddit","Facebook"]},"description":"Only actions on these platforms. Comma-separated.","examples":["LinkedIn,Reddit"]},"required":false,"description":"Only actions on these platforms. Comma-separated.","name":"platforms","in":"query"},{"schema":{"type":"array","items":{"type":"string","enum":["comment","connect","dm","downvote","follow","like","message","quote","react","reply","repost","retweet","upvote"]},"description":"Only these action verbs. Valid values: comment, connect, dm, downvote, follow, like, message, quote, react, reply, repost, retweet, upvote. Comma-separated.","examples":["comment,react"]},"required":false,"description":"Only these action verbs. Valid values: comment, connect, dm, downvote, follow, like, message, quote, react, reply, repost, retweet, upvote. Comma-separated.","name":"actionTypes","in":"query"},{"schema":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Only actions queued or taken by these team member user ids. Comma-separated.","examples":["7c9e6679-7425-40de-944b-e07fc1f90ae7"]},"required":false,"description":"Only actions queued or taken by these team member user ids. Comma-separated.","name":"takenBy","in":"query"},{"schema":{"type":"array","items":{"type":"string","enum":["automated","manual"]},"description":"Only actions sent through PitchGhost ('automated') or saved as manual records of actions taken elsewhere ('manual'). Comma-separated.","examples":["automated"]},"required":false,"description":"Only actions sent through PitchGhost ('automated') or saved as manual records of actions taken elsewhere ('manual'). Comma-separated.","name":"recorded","in":"query"},{"schema":{"type":"array","items":{"type":"string","minLength":1},"examples":["ACoAABx4k2MB7gq1n0ZfTt3yYw"],"description":"Only actions acted with these platform account ids (the `accountId` of an action account, not its `integrationId`). Comma-separated."},"required":false,"description":"Only actions acted with these platform account ids (the `accountId` of an action account, not its `integrationId`). Comma-separated.","name":"accounts","in":"query"},{"schema":{"type":"string","description":"Relative time window like '24h' or '7d' (queued tab: creation date; other tabs: action date).","examples":["7d","24h"]},"required":false,"description":"Relative time window like '24h' or '7d' (queued tab: creation date; other tabs: action date).","name":"period","in":"query"},{"schema":{"type":"string","description":"ISO datetime lower bound for the date range.","examples":["2026-10-01T00:00:00Z"]},"required":false,"description":"ISO datetime lower bound for the date range.","name":"start","in":"query"},{"schema":{"type":"string","description":"ISO datetime upper bound for the date range.","examples":["2026-10-08T00:00:00Z"]},"required":false,"description":"ISO datetime upper bound for the date range.","name":"end","in":"query"},{"schema":{"type":"integer","minimum":1,"default":1,"description":"Page number for pagination (1-based)","examples":[1]},"required":false,"description":"Page number for pagination (1-based)","name":"page","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":25,"description":"Number of actions per page (max 50)","examples":[25]},"required":false,"description":"Number of actions per page (max 50)","name":"limit","in":"query"}],"responses":{"200":{"description":"One page of actions, newest first","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionsResponse"}}}},"400":{"description":"Invalid filters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/pitchghost/finds/:id/actions":{"get":{"summary":"Get Find actions","description":"Read a Find's actions: the responses PitchGhost suggested for it (Ghosts with `generateResponses` on) and, optionally, the actions that are queued, already taken, or failed.","tags":["Actions"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"123e4567-e89b-12d3-a456-426614174000"},"required":true,"name":"id","in":"path"},{"schema":{"type":"array","items":{"type":"string","enum":["pending","queued","taken","failed"]},"description":"Which groups to return, comma-separated: 'pending' (suggested actions not yet taken), 'queued' (waiting to run), 'taken' and 'failed'. Defaults to pending only.","example":"pending,queued,taken,failed"},"required":false,"description":"Which groups to return, comma-separated: 'pending' (suggested actions not yet taken), 'queued' (waiting to run), 'taken' and 'failed'. Defaults to pending only.","name":"include","in":"query"}],"responses":{"200":{"description":"The Find's actions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindActionsResponse"}}}},"400":{"description":"Invalid Find ID or include value","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Find not found or does not belong to company","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"summary":"Take an action","description":"Take an action on a Find (comment, react, connect, repost, quote, reply, message) with one of your connected action accounts, or record one taken elsewhere. Content is posted as sent. Requires the Engage plan. **This acts on a real social account.**","tags":["Actions"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"123e4567-e89b-12d3-a456-426614174000"},"required":true,"name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TakeActionRequest"}}}},"responses":{"200":{"description":"The action was taken or recorded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TakeActionResponse"}}}},"202":{"description":"The action was queued and will run shortly","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TakeActionResponse"}}}},"400":{"description":"Invalid action for this Find","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TakeActionError"}}}},"401":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TakeActionError"}}}},"403":{"description":"Read-only key, or this key is not allowed to use the account","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TakeActionError"}}}},"404":{"description":"Find, account or suggestion not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TakeActionError"}}}},"422":{"description":"The action was refused (plan, platform or safety check)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TakeActionError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TakeActionError"}}}},"502":{"description":"The action service failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TakeActionError"}}}}}}},"/pitchghost/actions/:id":{"delete":{"summary":"Cancel a queued action","description":"Cancel an action that is still queued (`status: 'queued'` in `GET /pitchghost/actions`). The action goes back to being a suggestion on its Find, so it can be taken again later. An action that has started running or already finished cannot be cancelled.","tags":["Actions"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"123e4567-e89b-12d3-a456-426614174000"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"The action was cancelled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelActionResponse"}}}},"400":{"description":"Invalid action ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Read-only key, or this key is not allowed to use the account the action is queued on","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Action not found or does not belong to company","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"The action is not queued, or has already started running","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"The action service failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/pitchghost/finds/:id":{"delete":{"summary":"Delete","description":"Permanently delete a Find, along with its suggested and taken actions. This cannot be undone.","tags":["Finds"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"123e4567-e89b-12d3-a456-426614174000"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"The Find was deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteFindResponse"}}}},"400":{"description":"Invalid Find ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Find not found or does not belong to company","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"webhooks":{}}