Search contacts

You can search for contacts through various properties and conditions.

You can pass in a list of conditions to hyper-filter the results. Let's take a look at an example to understand how it works:

condition1 = [{'property': 'email', 'condition': 'Is', 'value': '[e-mail]'}]
condition2 = [{'property': 'email', 'condition': 'Is', 'value': '[e-mail]'}]
time = [{'property': "created_timestamp", 'condition': "Exactly", 'value': "0"}]
enriched = [{'property': "is_enriched", 'condition': 'Is', 'value': True}]
conditions = condition1 + condition2 + time + enriched

When you pass in conditions that have the same property name and condition value we convert them into 'OR' statements. Under our example above this would return contacts that have the email '[e-mail]' OR '[e-mail]'.

Finally, we apply our third condition to only look for contacts added today. You can read the condition as being "Get me all contacts that were created 0 days ago".

Below are the property names you can filter on and the conditions you can apply.

Property name	Description	Available conditions
sequence__id (int)	The ID of a sequence in Copyfactory.	"Is", "Is not"
email (str)	The email of the contact	"Is", "Is not", "Contains", "Does not contain"
premise_ids_used (str)	The ID of a sentence premise that was generated for the contact. This is NOT the Id of the premise but the internal ID. The internal ID can be retrieved using the premises endpoint and looks like "7da3d316-aadf-4379-b588-7459395c67c7"	"Is", "Is not"
created_timestamp (int)	The timestamp of when the contact was created. We let you filter based on number of days since created.	"More than", "Exactly", "Less than"
updated_timestamp (int)	The timestamp of when the contact was updated. We let you filter based on number of days since created. So a value of '0' would be today.	"More than", "Exactly", "Less than"
last_synced_timestamp (int)	The timestamp of when the contact was synced to one of your integrations. We let you filter based on number of days since created. So a value of '0' would be today.	"More than", "Exactly", "Less than"
is_enriched (bool)	A True/False of if the contact has been enriched.	"Is", "Is not"

Search contacts

POST https://app.copyfactory.io/api/v2/contact/search/

Searches for contacts

Headers

Name	Type	Description
Authorization*	String	Copyfactory API key

Request Body

Name	Type	Description
conditions	array	List of objects containing the conditions you want to apply to the search.
page_size	int	The size of the page you want returned. Default is 100.
page	int	The page number you want returned to you. Default is 1.

200: OK Success

{
	'contacts': [{
		'id': 6,
		'email': '[e-mail]',
		'custom_fields': {
			'post_author': '1',
			'post_content': '1',
		},
		'sentence_fields': {
			'snip1': 'We integrate with a lot of tools',
			'snip2': 'Including Pipedrive, CloseCRM, Hubspot and sales automation tools.'
		},
		'sequence_name': 'Seq',
		'linked_in_handle': 'handle.mm',
		'enriched_contact_data': {
			'city': 'Sioux Falls',
			'state': 'South Dakota',
			'groups': [],
			'country': 'US',
			'summary': 'Experienced Sales Specialist with a demonstrated history of growing long-term relationships. Skilled in Outbound & Inbound Sales, Management, Customer Experience, Digital Marketing, and Training, Social Media, and CRM usage, including personal video engagement and email automation/3rd party API integration.',
			'articles': [],
			'headline': None,
			'education': [{
				'school': 'South Dakota State University',
				'ends_at': {
					'day': 31,
					'year': 1999,
					'month': 12
				},
				'logo_url': 'https://media-exp2.licdn.com/dms/image/C510BAQEzCqmfFDgExg/company-logo_400_400/0/1519856534459?e=1663804800&v=beta&t=-K57aHPSkKTN7Lly0CHoFLLiWJEXZ6Geme73hQMRom4',
				'starts_at': {
					'day': 1,
					'year': 1995,
					'month': 1
				},
				'degree_name': 'B.S.',
				'description': None,
				'field_of_study': 'Geography',
				'school_linkedin_profile_url': None
			}],
			'full_name': 'Eric Anderson',
			'languages': [],
			'last_name': 'Anderson',
			'activities': [],
			'first_name': 'Eric',
			'occupation': 'Sales Manager at Uptics ',
			'connections': None,
			'experiences': [{
				'title': 'Sales Manager',
				'company': 'Uptics ',
				'ends_at': None,
				'location': 'Sioux Falls, SD ',
				'logo_url': 'https://media-exp2.licdn.com/dms/image/C4E0BAQF1pPNQ2vllXQ/company-logo_400_400/0/1641413912350?e=1663804800&v=beta&t=njTPLoe3ajrtoHIDYIyEzYxjeMb7ihjRIZSGdz_4RKo',
				'starts_at': {
					'day': 1,
					'year': 2022,
					'month': 6
				},
				'description': None,
				'company_linkedin_profile_url': 'https://www.linkedin.com/company/uptics/'
			}, {
				'title': 'Account Manager',
				'company': 'Fully Promoted Sioux Falls (formerly EmbroidMe)',
				'ends_at': {
					'day': 31,
					'year': 2022,
					'month': 1
				},
				'location': 'Sioux Falls, South Dakota, United States',
				'logo_url': 'https://media-exp2.licdn.com/dms/image/C4D0BAQFvvmku28swVA/company-logo_400_400/0/1519921269861?e=1663804800&v=beta&t=t9U9qyJTddtXMGQppGp1JlmfbH5dzTZtlRVv5n4-zAg',
				'starts_at': {
					'day': 1,
					'year': 2021,
					'month': 6
				},
				'description': 'Fully Promoted Sioux Falls is the leading promotional company in the marketing world. We help other businesses to grow by promoting them through embroidery, screen printing, direct garment printing, transfers and promotional items.',
				'company_linkedin_profile_url': 'https://www.linkedin.com/company/fully-promoted-sioux-falls-formerly-embroidme-/'
			}, {
				'title': 'Sales ',
				'company': 'Building Start',
				'ends_at': {
					'day': 28,
					'year': 2021,
					'month': 2
				},
				'location': 'Sioux Falls, South Dakota, United States',
				'logo_url': 'https://media-exp2.licdn.com/dms/image/C560BAQHlSNMOb3sdKg/company-logo_400_400/0/1519893965106?e=1663804800&v=beta&t=q3bgCIWRfH3wBVTxHkghEYIeupy8VRRJxPTvZQqn7eo',
				'starts_at': {
					'day': 1,
					'year': 2020,
					'month': 8
				},
				'description': 'Building Start is a SaaS provider that enables anyone who uses large checklists or does extensive field data documentation to get rid of antiquated methods such as using paper or Excel. I help organizations improve collaboration, greatly enhance reporting capabilities, document issues/deficiencies/issues with our field tools, and add to the bottom line. Our platform is proprietary and has many case studies showing direct impact made by transitioning to our software.',
				'company_linkedin_profile_url': 'https://www.linkedin.com/company/building-start/'
			}, {
				'title': 'Sales Engineer',
				'company': 'Lead Engine Sales & Marketing ',
				'ends_at': {
					'day': 31,
					'year': 2019,
					'month': 10
				},
				'location': 'Brandon, SD',
				'logo_url': 'https://media-exp2.licdn.com/dms/image/C4E0BAQFYxW7ErhskNA/company-logo_400_400/0/1578886753053?e=1663804800&v=beta&t=DIfZiRrx4yI3-0lvA0gDRCBOeNdo7VvZ-27jjeAG66M',
				'starts_at': {
					'day': 1,
					'year': 2019,
					'month': 3
				},
				'description': 'I help people in the technology and consulting sectors broker meetings with qualified leads by utilizing advertising campaigns and high-quality prospecting techniques. \nWe also produce VSLs, lead lists, sales funnels and provide metrics and analysis for our clients.',
				'company_linkedin_profile_url': 'https://www.linkedin.com/company/lead-engine/'
			}, {
				'title': 'Real Estate Broker Associate',
				'company': 'eXp Realty',
				'ends_at': {
					'day': 31,
					'year': 2020,
					'month': 1
				},
				'location': 'Sioux Falls, South Dakota Area',
				'logo_url': 'https://media-exp2.licdn.com/dms/image/C560BAQHAw_11TJy26Q/company-logo_400_400/0/1654095988056?e=1663804800&v=beta&t=DtpOh6_2Vv-XECtBBTxJqrWcNxF45Nm2SCuDKkQnS0M',
				'starts_at': {
					'day': 1,
					'year': 2019,
					'month': 1
				},
				'description': 'I assisted clients purchasing and selling residential real estate in the Sioux Falls, SD market.',
				'company_linkedin_profile_url': 'https://www.linkedin.com/company/exp-realty/'
			}, {
				'title': 'Renaissance Man',
				'company': 'Pipco Consulting',
				'ends_at': None,
				'location': 'Sioux Falls, SD ',
				'logo_url': None,
				'starts_at': {
					'day': 1,
					'year': 2021,
					'month': 12
				},
				'description': None,
				'company_linkedin_profile_url': None
			}, {
				'title': 'Real Estate Broker Associate',
				'company': 'Don Dunham III Real Estate',
				'ends_at': {
					'day': 31,
					'year': 2019,
					'month': 1
				},
				'location': 'Sioux Falls, South Dakota Area',
				'logo_url': None,
				'starts_at': {
					'day': 1,
					'year': 2018,
					'month': 8
				},
				'description': None,
				'company_linkedin_profile_url': None
			}, {
				'title': 'Senior Design Consultant',
				'company': 'Budget Blinds of Sioux Falls',
				'ends_at': {
					'day': 31,
					'year': 2018,
					'month': 5
				},
				'location': 'Sioux Falls, SD',
				'logo_url': None,
				'starts_at': {
					'day': 1,
					'year': 2010,
					'month': 4
				},
				'description': 'I was responsible for sales-based quota attainment of approximately $1M in revenue per year for a locally owned but nationally recognized window coverings franchise, Budget Blinds. \nA significant portion of my time day-to-day was in-home selling, along with responding to RFPs from general contractors/builders, as well as giving estimates for window coverings based on architectural renderings and plans provided by homeowners. \nI also had extensive involvement in our local Home Builders Association and was on the Parade of Homes Committee and the Remodeling Council. \nRelationship building was also very important in this position-I spent much time & effort building rapport with local builders to develop business.',
				'company_linkedin_profile_url': None
			}, {
				'title': 'Indirect Account Manager',
				'company': 'Alltel',
				'ends_at': {
					'day': 30,
					'year': 2010,
					'month': 4
				},
				'location': 'Sioux Falls, SD',
				'logo_url': 'https://media-exp2.licdn.com/dms/image/C560BAQGOBCSDqc5pjw/company-logo_400_400/0/1519856401038?e=1663804800&v=beta&t=pA8fROhYwxMPFo-vLoz22B-O_KyAXvB-awlMOckVXJU',
				'starts_at': {
					'day': 1,
					'year': 2000,
					'month': 7
				},
				'description': 'I held several positions during my tenure at Alltel, most recently as an Indirect Account Manager. I was responsible for the Indirect Distribution in Southeast SD and Northwest IA. This included multiple local agents, along with nation retail clients including Best Buy, Walmart and Radio Shack. \nExtensive in-store/classroom training was a substantive portion of my position. I also was responsible for recruitment of new agents, management of existing agents, and termination of underperforming agents. I also helped agent owners/management plan and execute outside events leading to incremental sales.',
				'company_linkedin_profile_url': 'https://www.linkedin.com/company/alltelwireless-/'
			}],
			'certifications': [],
			'volunteer_work': [{
				'cause': None,
				'title': 'Music team volunteer',
				'company': 'Celebrate Community Church',
				'ends_at': {
					'day': 31,
					'year': 2019,
					'month': 10
				},
				'logo_url': None,
				'starts_at': {
					'day': 1,
					'year': 2012,
					'month': 10
				},
				'description': 'I played electric & acoustic guitar/bass and sang lead vocals at Celebrate Church in Brandon, SD.\nThe position averaged approximately 4 to 8 hours a month depending on scheduling.',
				'company_linkedin_profile_url': None
			}],
			'recommendations': ["Brandon Kathman\n\n\n\nI rarely come across real talent who stand out like Eric. I had the pleasure of managing Eric at a Digital Marketing startup. Eric's ability to handle multiple projects and his energy was unlike any I’ve seen before. He was able to make a dramatic increase in the productivity level of our company. No matter what was thrown at him, Eric made sure every project was done to the highest level. As a team member or a leader, Eric earns my highest recommendation.", "Dan Rolle\n\n\n\nIt is my great pleasure to recommend Eric Anderson based on our many years working together in Account Management and Distribution in the technology and communication space.  I could write a book about what Eric would bring to your company, so I will get to the point. \n\n1.) Eric is excellent at mentoring and strategy.  He is never afraid to provide specific and direct feedback that will help his colleagues both personally and professionally. Eric has given me some of the most straight-forward and beneficial feedback in my life.  \n\n2.) Eric is always willing to share, and to help other with and advice.  Time and time again, though Eric was responsible for creating an excellent best-practice, he was also more than willing to share and help.  Specifically, Eric helped me and dozens of others grow our distribution channels, boost profit and improve end dealer (client) experience.  \n\n3.) Eric is one of the most respected account managers in the industry that we worked in.  In technology and communication, relationships matter and results are critical.  Eric helped his dealer network grow at a crucial time in the info-tech space.  There are unquestionably businesses in his region that are in business today only because Eric was able to give them business critical strategy. \n\n4.) Eric brings humor and fun to the workplace.  He knows how to be the consummate professional and represent a brand, yet also understands that work should be a place you enjoy.  He is exceptional in this regard.  Want your customers to love your brand based on relationship?  Don't pass up on Eric.  \n\n5.) Eric knows how to balance results and culture.  He is very aware that his role in an organization is to help drive success.  He also knows that you have to do that the right way. Eric can balance results and culture like few I have met.  \n\nAnyone with any further questions about our time working together is absolutely welcome to contact me directly. ", 'Doug Penniston\n\n\n\nEric and I worked with an indirect sales team or dealer network for Cellular One.  Eric was essential to our success in this region.  He worked directly with the dealer employees training them on Cellular One products and services.  At the same time he was a mentor and motivator to those same employees.  Eric excelled in both roles but he particularly shined in the training aspect of the position.  He made it his goal to make sure the employees in the stores he was assigned to knew our product well.  This lead to both increased sales decreased customer churn.\r\n\r\nI would highly recommend Eric for roles that included training and motivation of other employees.', 'Dustin Sedars\n\n\n\nEric is a very energetic person that brings passion to his job.  He brings a lot of enthusiasm to his team, and he is someone that has experience working with many different individuals.  Eric prides himself on knowledge of what he does, and he pushes himself to make sure he can be seen as a knowledge expert in his field.  He enjoys new challenges and is comfortable in an environment of change.  He is very open to new suggestions and ideas, and during his time on my team he built very strong relationships that continue to this day.  He is someone that is always wiling to volunteer and step up to take on assignments.'],
			'country_full_name': 'United States of America',
			'public_identifier': 'uptics',
			'people_also_viewed': [{
				'link': 'https://www.linkedin.com/in/thejasoncraig',
				'name': 'Jason Craig',
				'summary': 'Changing customers into Brand Advocates',
				'location': None
			}, {
				'link': 'https://www.linkedin.com/in/adam-hamilton-066b57233',
				'name': 'Adam Hamilton',
				'summary': 'Design Engineer at Raptor Civil Engineering',
				'location': None
			}, {
				'link': 'https://www.linkedin.com/in/wayne-craig-29744046',
				'name': 'Wayne Craig',
				'summary': '--Retired Operations Superintendent',
				'location': None
			}, {
				'link': 'https://www.linkedin.com/in/russell-wayne-craig-4a7295154',
				'name': 'Russell Wayne Craig',
				'summary': 'Owner at OM28 GROUP',
				'location': None
			}, {
				'link': 'https://www.linkedin.com/in/wayne-craig',
				'name': 'Wayne Craig',
				'summary': 'Retired',
				'location': None
			}, {
				'link': 'https://www.linkedin.com/in/wayneacraig2nd',
				'name': 'Wayne Craig',
				'summary': 'Walmart Merchandise Supervisor',
				'location': None
			}, {
				'link': 'https://www.linkedin.com/in/sean-larsen-732b73169',
				'name': 'Sean Larsen',
				'summary': 'Real Estate Advisor at eXp Realty',
				'location': None
			}, {
				'link': 'https://www.linkedin.com/in/wayne-craig-bb9ba815',
				'name': 'Wayne Craig',
				'summary': 'Regional Vice President at Pedross USA',
				'location': None
			}, {
				'link': 'https://www.linkedin.com/in/wayne-craig-2a686118b',
				'name': 'Wayne Craig',
				'summary': '--',
				'location': None
			}, {
				'link': 'https://www.linkedin.com/in/wayne-craig-9a64b617',
				'name': 'Wayne Craig',
				'summary': 'Director at Deloitte',
				'location': None
			}],
			'accomplishment_courses': [],
			'accomplishment_patents': [],
			'accomplishment_projects': [],
			'similarly_named_profiles': [],
			'accomplishment_test_scores': [],
			'background_cover_image_url': None,
			'accomplishment_publications': [],
			'accomplishment_honors_awards': [{
				'title': 'Show Us Your Best ',
				'issuer': 'Alltel',
				'issued_on': {
					'day': 1,
					'year': 2009,
					'month': 3
				},
				'description': 'I won this award via a nomination by my direct supervisor at the time, Dustin Sedars. \n'
			}, {
				'title': 'Superstar Challenge Awards Winner',
				'issuer': 'Cellular One/Alltel ',
				'issued_on': {
					'day': 1,
					'year': 2001,
					'month': 4
				},
				'description': 'Sales-based award winner. '
			}],
			'accomplishment_organisations': []
		},
		'enriched_company_data': {
			'hq': {
				'city': 'Minneapolis',
				'is_hq': True,
				'state': 'MN',
				'line_1': 'Remote',
				'country': 'US',
				'postal_code': None
			},
			'name': 'Uptics ',
			'tagline': 'Meet Uptics. The simple Sales Automation CRM for small businesses that sells 24/7 so you don’t have to.',
			'updates': [{
				'text': 'Ever have a sales meeting with a prospect and completely forget to follow up?\n \nThen like a year later you randomly remembered.\n\nImagine…\n\n🔥 Your lead nurturing completely automated.\n \n🔥 Checking in with your customers without lifting a finger.\n \n🔥 Staying out of the "Friendzone" with prospects by putting your "Maybe’s" on autopilot.\n \n🔥 Still having a chance with prospects who told you "Not Interested"...So You\'re Telling Me There\'s A Chance!\n \n🔥 Launching strategic referral partner campaigns to build new relationships.\n \n🔥 And subsidizing your deal flow using cold campaigns.\n \nAll of this leading to...\n\n📅 Seeing your calendar packed with qualified sales meetings with prospects.\n \n🤝 Adding new customers consistently.\n \n💰 Monthly revenues climbing predictably.\n \nHow would that feel?\n\nYou can do all of that by signing up for a free trial of Uptics Sales Automation: https://uptics.io.\n\nUptics is a lightweight, easy to use,  software that helps you automate all the manual, boring sales stuff so you can focus on things that matter...taking care of customers and closing sales.\n\n#sales \n#salesautomation \n#salesdevelopment \n#salesmanagement \n#salesenablement',
				'image': 'https://media-exp1.licdn.com/dms/image/C5605AQEXndIdEqs1Bg/videocover-high/0/1597961436044?e=2147483647&v=beta&t=8cZh0EiFVmjI6aGIahDH2ahMPYBUO_94HQx5ncIwx-o',
				'posted_on': None,
				'total_likes': 6,
				'article_link': None
			}],
			'website': 'http://www.uptics.io',
			'industry': 'Computer Software',
			'locations': [{
				'city': 'Minneapolis',
				'is_hq': True,
				'state': 'MN',
				'line_1': 'Remote',
				'country': 'US',
				'postal_code': None
			}],
			'search_id': '64882086',
			'description': 'Meet the modern sales management platform that combines the power of CRM, cold outreach, and sales automation into one tool. Uptics is the go to software for sales focused companies to manage all your work in one software, so you can maximize time while making the largest impact.',
			'company_size': [2, 10],
			'company_type': 'PRIVATELY_HELD',
			'founded_year': 2020,
			'specialities': [''],
			'follower_count': 3023,
			'similar_companies': [{
				'link': 'https://www.linkedin.com/company/uptycs',
				'name': 'Uptycs',
				'industry': 'Computer and Network Security',
				'location': 'Waltham, MA'
			}, {
				'link': 'https://in.linkedin.com/company/jashds',
				'name': 'Jash Data Sciences',
				'industry': 'Software Development',
				'location': 'Pune, Maharashtra'
			}, {
				'link': 'https://in.linkedin.com/company/sat-n-paper',
				'name': 'SAT n paper',
				'industry': 'Education Administration Programs',
				'location': 'NOIDA, Uttar Pradesh'
			}, {
				'link': 'https://www.linkedin.com/company/weareuplers',
				'name': 'Uplers',
				'industry': 'IT Services and IT Consulting',
				'location': 'San Diego, CA'
			}, {
				'link': 'https://www.linkedin.com/company/lead-engine',
				'name': 'Lead Engine',
				'industry': 'Marketing Services',
				'location': 'Minneapolis | St. Paul, Minnesota'
			}, {
				'link': 'https://in.linkedin.com/company/hashedin',
				'name': 'HashedIn',
				'industry': 'IT Services and IT Consulting',
				'location': 'Bangalore, Karnataka'
			}, {
				'link': 'https://in.linkedin.com/company/graphyapp',
				'name': 'Graphy',
				'industry': 'E-Learning Providers',
				'location': 'Bengaluru, Karnataka'
			}, {
				'link': 'https://au.linkedin.com/company/uptickhq',
				'name': 'Uptick',
				'industry': 'Software Development',
				'location': 'Fitzroy, Victoria'
			}, {
				'link': 'https://in.linkedin.com/company/tata-consultancy-services',
				'name': 'Tata Consultancy Services',
				'industry': 'IT Services and IT Consulting',
				'location': 'Mumbai, Maharashtra'
			}, {
				'link': 'https://www.linkedin.com/company/splashtop',
				'name': 'Splashtop Inc.',
				'industry': 'Software Development',
				'location': 'Cupertino, California'
			}],
			'universal_name_id': 'uptics',
			'linkedin_internal_id': '64882086',
			'company_size_on_linkedin': 6
		},
		'created_date': '2022-06-27T20:03:05Z'
	}],
	'pagination': {
		'total_contacts': 1,
		'page': 1,
		'total_pages': 1,
		'page_size': 200
	}
}