{"id":18877057,"url":"https://github.com/fullcontact/contacts-api-node","last_synced_at":"2025-04-14T18:31:38.315Z","repository":{"id":16736784,"uuid":"80554036","full_name":"fullcontact/contacts-api-node","owner":"fullcontact","description":"Node.js SDK for Contacts+ Contacts API","archived":false,"fork":false,"pushed_at":"2023-02-26T20:50:48.000Z","size":680,"stargazers_count":7,"open_issues_count":8,"forks_count":3,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-28T07:01:50.638Z","etag":null,"topics":["fullcontact","node-js","sdk"],"latest_commit_sha":null,"homepage":"https://www.contactsplus.com/developers/contacts-api","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fullcontact.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2017-01-31T19:29:45.000Z","updated_at":"2021-10-22T13:21:43.000Z","dependencies_parsed_at":"2023-07-19T09:30:58.840Z","dependency_job_id":null,"html_url":"https://github.com/fullcontact/contacts-api-node","commit_stats":{"total_commits":55,"total_committers":3,"mean_commits":"18.333333333333332","dds":0.1454545454545455,"last_synced_commit":"39cd1bcec0d18d62109f737de469cef09dd389f6"},"previous_names":["fullcontact/fullcontact-node"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fullcontact%2Fcontacts-api-node","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fullcontact%2Fcontacts-api-node/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fullcontact%2Fcontacts-api-node/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fullcontact%2Fcontacts-api-node/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fullcontact","download_url":"https://codeload.github.com/fullcontact/contacts-api-node/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248936694,"owners_count":21186087,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fullcontact","node-js","sdk"],"created_at":"2024-11-08T06:16:41.235Z","updated_at":"2025-04-14T18:31:38.022Z","avatar_url":"https://github.com/fullcontact.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/fullcontact/contacts-api-node.svg?branch=master)](https://travis-ci.org/fullcontact/contacts-api-node)\n[![npm version](https://badge.fury.io/js/contacts-api-node.svg)](https://badge.fury.io/js/contacts-api-node)\n[![Node version](https://img.shields.io/node/v/contacts-api-node.svg?style=flat)](http://nodejs.org/download/)\n\n*IMPORTANT: This SDK should be used server-side only. Using it in a browser would expose Client Secret*\n\n*Looking for FullContact Enrich APIs? there is a new SDK for that: [https://github.com/fullcontact/fullcontact-node-sdk](https://github.com/fullcontact/fullcontact-node-sdk)*\n\n### Installation\n\n`npm install contacts-api-node --save`\n\n### Documentation\n\nAPI Documentation can be found at [https://www.contactsplus.com/developers/contacts-api](https://www.contactsplus.com/developers/contacts-api)\n\nJSDocs can be found in [docs.md](docs.md)\n\n### Usage\n\n##### Configuration\n---\n\n```\nvar contactsplus = require('contacts-api-node')({\n\tclientId: '\u003cClient ID\u003e', //for v3 APIs. See: https://app.contactsplus.com/apps\n\tclientSecret: '\u003cClient Secret\u003e',\n\tredirectUri: '\u003cRedirect URI\u003e',\n\tscope: 'list,of,scopes',\n\tuserAgent: '\u003cAppName/Version\u003e'\n});\n```\n\n##### OAuth\n---\nAll OAuth methods can be found under the `oauth` property on the client.\n\n###### Supported Methods:\n- getAuthorizationUrl()\n- exchangeAuthCode(code)\n- exchangeRefreshToken(refresh_token)\n\n```\nvar url = contactsplus.oauth.getAuthorizationUrl();\n```\n\n##### Contacts APIs\n---\nAll Contacts APIs can be found under the `contacts` property on the client.\n\n```\ncontactsplus.contacts.account.get(accessToken)\n\t.then(res =\u003e {\n\t\t//2xx response\n\t})\n\t.catch(res =\u003e {\n\t\t//non-2xx response\n\t});\n```\n\n#### Tests\n---\n\nTo run tests:\n\n`npm test`\n\nTo get coverage report:\n\n`npm run coverage`\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffullcontact%2Fcontacts-api-node","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffullcontact%2Fcontacts-api-node","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffullcontact%2Fcontacts-api-node/lists"}