{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Quickstart","description":"Guides and API reference for the DataSift (REISift) Core API and SiftMap API."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"quickstart","__idx":0},"children":["Quickstart"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["From zero to your first authenticated DataSift API call in about five minutes."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-get-your-open-api-key","__idx":1},"children":["1. Get your Open API key"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open API keys are available on plans above Professional. In the REISift app, go to your account's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["integration settings"]},", then generate a key. The key is a single string with a dot in the middle, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AbCd1234.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The key acts on behalf of the user it was issued for and inherits that user's permissions. Treat it like a password: keep it secret, never commit it to a repository, and rotate or revoke it from the same screen if it is ever exposed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-first-call---who-am-i","__idx":2},"children":["2. First call - who am I?"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl https://apiv2.reisift.io/api/internal/user/ \\\n  -H \"Authorization: Api-Key YOUR_OPEN_API_KEY\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A 200 response returns your user profile (uuid, name, email, role, feature flags, addons). If you get a 401 or 403, the key is wrong, revoked, or your plan does not include API access."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"3-second-call---your-records","__idx":3},"children":["3. Second call - your records"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl \"https://apiv2.reisift.io/api/internal/property/?limit=1\" \\\n  -H \"Authorization: Api-Key YOUR_OPEN_API_KEY\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{ \"count\": <total records>, \"results\": [ ...one property record... ] }"]},". The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["count"]}," tells you the total size of your account's property database in one cheap call."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"4-the-same-thing-in-python","__idx":4},"children":["4. The same thing in Python"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","header":{"controls":{"copy":{}}},"source":"import os\nimport requests\n\nBASE = \"https://apiv2.reisift.io\"\nHEADERS = {\n    \"Authorization\": f\"Api-Key {os.environ['DATASIFT_API_KEY']}\",\n    \"Accept\": \"application/json\",\n}\n\nme = requests.get(f\"{BASE}/api/internal/user/\", headers=HEADERS, timeout=30)\nme.raise_for_status()\nprint(me.json()[\"email\"])\n\nprops = requests.get(f\"{BASE}/api/internal/property/\", headers=HEADERS,\n                     params={\"limit\": 5}, timeout=30)\nprops.raise_for_status()\nbody = props.json()\nprint(body[\"count\"], \"properties in account\")\nfor p in body[\"results\"]:\n    a = p[\"address\"]\n    print(p[\"uuid\"], a[\"street\"], a[\"city\"], a[\"state\"])\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Store the key in an environment variable (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DATASIFT_API_KEY"]},"), never in source code."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"5-and-on-siftmap","__idx":5},"children":["5. And on SiftMap"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl \"https://map.reisift.io/filters/\" \\\n  -H \"Authorization: Api-Key YOUR_OPEN_API_KEY\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Lists your saved map filters. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/siftmap-api"},"children":["SiftMap"]}," for its request URL and examples."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"6-where-to-go-next","__idx":6},"children":["6. Where to go next"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Working with records: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/properties"},"children":["Properties"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Building a marketing funnel with tags, lists, and presets: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/tags-lists-folders"},"children":["Tags, lists, and folders"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/filter-presets"},"children":["Filter presets"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["End-to-end recipes: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/use-case-playbooks"},"children":["Use-case playbooks"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Staying within limits: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/rate-limits"},"children":["Rate limits"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Every endpoint: the combined ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/datasift"},"children":["DataSift API reference"]},", including the SiftMap group"]}]}]},"headings":[{"value":"Quickstart","id":"quickstart","depth":1},{"value":"1. Get your Open API key","id":"1-get-your-open-api-key","depth":2},{"value":"2. First call - who am I?","id":"2-first-call---who-am-i","depth":2},{"value":"3. Second call - your records","id":"3-second-call---your-records","depth":2},{"value":"4. The same thing in Python","id":"4-the-same-thing-in-python","depth":2},{"value":"5. And on SiftMap","id":"5-and-on-siftmap","depth":2},{"value":"6. Where to go next","id":"6-where-to-go-next","depth":2}],"frontmatter":{"seo":{"title":"Quickstart"}},"lastModified":"2026-11-05T20:56:38.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/quickstart","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}